Inventar¶

Ansible verwaltet zu kontrollierende bzw. zu steuernde Systeme in einem Inventar. Ein statisches Inventar ist eine einfache Textdatei, welche mit einem Texteditor erstellt und bearbeitet werden kann. ^[5] Hosts können im Inventar zu Gruppen zusammengefasst werden, wie das folgende Beispiel veranschaulicht:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

mail.example.com

[webservers]
foo.example.com
bar.example.com

[dbservers]
one.example.com
two.example.com
three.example.com

[dc1]
merkur.example.com
venus.example.com

[dc2]
neptun.example.com
uranus.example.com

[dc:children]
dc1
dc2

Bei obigen Inventar handelt es sich um ein simples Beispiel. In der offiziellen Dokumentation 🇬🇧 finden sich weitere Anwendungsbeispiele, wie z.B. die Verwendung von Host- und Gruppen-Variablen im Inventar.

Playbooks¶

Playbooks sind das Herzstück von Ansible. Sie werden verwendet, um entfernte Rechner zu konfigurieren und um Deployments durchzuführen. Playbooks werden in YAML-Syntax unter Verwendung eines Texteditors geschrieben. ^[5] Zur Veranschaulichung soll folgendes Beispiel aus der offiziellen Dokumentation 🇬🇧 dienen:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

---
- name: setup apache
  hosts: webservers
  vars:
    http_port: 80
    max_clients: 200
  remote_user: root

  tasks:
  - name: ensure apache is at the latest version
    ansible.builtin.apt:
      name: apache2
      state: latest
  - name: write the apache config file
    ansible.builtin.template:
      src: /srv/httpd.j2
      dest: /etc/httpd.conf
    notify:
      - restart apache
  - name: ensure apache is running (and enable it at boot)
    ansible.builtin.service:
      name: apache2
      state: started
      enabled: true

  handlers:
    - name: restart apache
      ansible.builtin.service:
        name: httpd
        state: restarted

Im Playbook wird zuerst die Gruppe von Hosts definiert, auf denen die folgenden Tasks ausgeführt werden sollen. In diesem Fall ist dies die Gruppe webservers aus dem Inventar. Anschließend werden zwei Variablen definiert und der Benutzer (root) spezifiziert, welcher für die SSH-Verbindung zu den Zielsystemen verwendet wird.

Darauf folgt eine Sektion mit Tasks. Hier wird definiert was auf den Zielsystemen getan werden soll. Dabei werden die Aufgaben in der Reihenfolge abgearbeitet, wie sie im Playbook spezifiziert sind. Die Ausführung erfolgt parallel auf den als Zielsystemen definierten Hosts.

Das obige Playbook führt dabei folgende Tasks auf den Hosts der Gruppe webservers aus:

1. Stellt sicher, dass das Paket apache2 in der aktuellsten Version installiert ist

2. Erstellt die Apache-Konfigurationsdatei aus einer Vorlage und benachrichtigt einen handler namens restart apache

3. Stellt sicher, dass der Apache-Dienst aktiviert und gestartet ist

4. Unter handlers werden Tasks definiert, welche nur ausgeführt werden, wenn sie von einem anderen Task im Playbook ausgelöst werden (siehe Handlers 🇬🇧).

Dokumentation anzeigen¶

Die Dokumentation zum Ansible-Modul ping im Terminal ^[3] anzeigen:

ansible-doc ping 

Ad-hoc-Kommando ausführen¶

Folgendes Kommando führt das Modul ping auf dem Host foo.example.com aus:

ansible foo.example.com -m ping 

Folgendes Kommando führt das Modul ping auf der Gruppe webservers aus:

ansible webservers -m ping 

Ansible-Playbooks ausführen¶

ansible-playbook example.yml 

Obiges Kommando führt das Ansible-Playbook namens example.yml aus.