Zum Inhalt

Ansible verstehen

Ansible konfiguriert Server über SSH. Du beschreibst einmal den gewünschten Zustand, etwa „nginx ist installiert und liefert diese Seite aus“, und Ansible bringt beliebig viele Server in diesen Zustand. Auf den Servern braucht es keinen Agenten: SSH-Zugang und Python reichen.

Steuerrechner und verwaltete Server

          tuxdex-srv (Steuerrechner)
          ansible, Playbooks, Inventar
                 │  SSH
        ┌────────┴────────┐
        ▼                 ▼
      web01             web02
   192.0.2.21        192.0.2.22
Begriff Bedeutung
Control Node (Steuerrechner) Der Rechner, auf dem Ansible installiert ist und von dem aus du es startest
Managed Node (verwalteter Server) Ein Server, den Ansible konfiguriert; er braucht SSH und Python 3
Inventar Die Liste der Server, in Gruppen sortiert
Modul Ein Arbeitsschritt, etwa apt, copy, service oder user
Task Ein Aufruf eines Moduls mit seinen Parametern
Playbook Eine YAML-Datei mit Tasks für Gruppen von Servern
Rolle Ein wiederverwendbares Paket aus Tasks, Dateien, Vorlagen und Variablen
Handler Ein Task, der nur läuft, wenn ein anderer Task etwas geändert hat, etwa nginx neu laden

Was du installieren musst

Ansible wird nur auf dem Steuerrechner installiert. Die verwalteten Server brauchen nur einen SSH-Server, Python 3 und deinen SSH-Schlüssel, siehe ssh-copy-id.

Debian Ubuntu RHEL Arch
Ansible sudo apt install ansible sudo apt install ansible sudo dnf install ansible-core (volles ansible aus EPEL) sudo pacman -S ansible
ansible-lint sudo apt install ansible-lint sudo apt install ansible-lint pipx install ansible-lint sudo pacman -S ansible-lint

ansible ist ansible-core plus eine große Sammlung von Collections wie community.general. Mit ansible-core allein installierst du die nötigen Collections mit ansible-galaxy. Auf jeder Distribution holt pipx install --include-deps ansible die neueste Version.

Das Inventar

~/ansible/inventory.ini:

[web]
web01 ansible_host=192.0.2.21
web02 ansible_host=192.0.2.22

[db]

[production:children]
web

Über Gruppen wie web sprichst du mehrere Server auf einmal an. Variablen für eine Gruppe kommen nach group_vars/web.yml, für einen einzelnen Server nach host_vars/web01.yml.

Ein Playbook

~/ansible/site.yml installiert nginx auf allen Webservern und legt eine Statusseite ab:

- name: Set up web servers
  hosts: web
  become: true
  tasks:
    - name: Install nginx
      ansible.builtin.apt:
        name: nginx
        state: present
        update_cache: true
        cache_valid_time: 3600
      tags: packages

    - name: Deploy status page
      ansible.builtin.copy:
        content: "<h1>{{ inventory_hostname }}: all systems operational</h1>\n"
        dest: /var/www/html/index.html
        mode: "0644"
      notify: Reload nginx

  handlers:
    - name: Reload nginx
      ansible.builtin.service:
        name: nginx
        state: reloaded

become: true führt die Tasks mit sudo aus. Gestartet wird das Ganze mit ansible-playbook.

Idempotenz

Module beschreiben einen Zustand, keine Handlung. state: present heißt „nginx muss installiert sein“, nicht „installiere nginx“. Ist es das schon, passiert nichts, und der Task meldet ok statt changed. Deshalb kannst du ein Playbook beliebig oft ausführen: Der zweite Lauf ändert nichts mehr.

Ein Projektverzeichnis

~/ansible/
├── ansible.cfg            # settings for this project
├── inventory.ini          # servers and groups
├── site.yml               # main playbook
├── group_vars/
│   ├── web.yml            # variables for the group web
│   └── secrets.yml        # passwords, encrypted with ansible-vault
└── roles/
    └── nginx/             # a role, created with ansible-galaxy role init

~/ansible/ansible.cfg:

[defaults]
inventory = inventory.ini
remote_user = nox
interpreter_python = auto_silent

Mit dieser Datei brauchst du kein -i inventory.ini mehr bei jedem Befehl, solange du Ansible in diesem Verzeichnis startest. Siehe ansible-config.

Das Projekt in Git ablegen

Ein Ansible-Projekt gehört in ein Git-Repository, siehe das Kapitel Git. Dann ist jede Änderung an deinen Servern dokumentiert, nachvollziehbar und lässt sich zurücknehmen.

Module statt Shell-Befehle

ansible.builtin.shell: apt install nginx funktioniert, meldet aber bei jedem Lauf changed und lässt sich nicht mit --check prüfen. Ein Modul wie ansible.builtin.apt kennt den aktuellen Zustand und handelt nur, wenn es nötig ist.