README.md

Linux server role

Role that install a generic setup for a Debian linux:

• Docker
• Monitoring with prometheus (node exporter + cAdvisor)
• Kernel parameters
• Basic tools and packages
• Import of ssh keys and gpg keys from github

Example playbook

This is an example playbook

- hosts: all
  vars:
    hostname: "template"
    domain: "strm.sh"
    network:
      ip: "192.168.0.9"
      cidr: "/24"
      gateway: "192.168.0.1"
      dns:
      - "8.8.8.8"
      - "1.1.1.1"
      extra_ips:
      - "192.168.0.2"
      - "192.168.0.3"
      - "192.168.0.4"
      extra_raw: |-
        iface tun0 inet static
          address 10.0.0.8/24
    static_hosts: "{{ lookup('file', 'hosts') }}"
    loki:
      url: 'http://loki.strm.sh:3100/loki/api/v1/push'
    github_user: opsxcq
  tasks:
  - debug:
      msg: "Your other tasks here"
  roles:
    - ../..

Optional variables:

• network.cidr: default value is /24.
• static_hosts: if not present, won't change /etc/hosts.
• loki: When defined will configure the system and container logs to be shipped to loki.

Requirements file

- src: git+https://github.com/opsxcq/ansible-role-linux-server.git
  name: "opsxcq.linux_server"

Tmux configuration

Tmux is added to this setup, but with a difference that it uses Ctrl+A, so you can keep a tmux session (using Ctrl+B) locally connected to a tmux remotely.

Monitoring

Alongside the monitoring tools like prometheus, there are some tools which help you to monitor the resource usage locally.

• htop
• iostat -x 1 - shows real time io data
• slurm -i ens192 - shows real time network stats for the interface ens192