Leitfaden zur Verwaltung von dynamischem und statischem Inventar mit Ansible

Das Ansible-Inventar beantwortet eine praktische Frage: Welche Systeme soll diese Automatisierung betreffen? Wenn Ihr Inventar falsch ist, kann ein gutes Playbook trotzdem den falschen Host anvisieren, einen neuen Server überspringen oder die falschen Verbindungsvariablen verwenden.

Dieser Leitfaden behandelt statische Inventardateien, dynamische Inventarquellen und die ansible-inventory-Prüfungen, die Ihnen helfen zu bestätigen, dass Ansible dieselbe Infrastruktur sieht, die Sie erwarten.

Grundlegendes zum Ansible-Inventar

Im Kern ist ein Ansible-Inventar eine Liste von Hosts und Gruppen. Ansible verwendet diese Informationen, um zu bestimmen, mit welchen Maschinen es sich verbinden und auf welchen es Aufgaben ausführen soll. Der Standardspeicherort für die Inventardatei ist /etc/ansible/hosts, aber Sie können für jeden Ansible-Befehl oder jedes Playbook mit dem Flag -i eine andere Inventardatei angeben.

Es gibt zwei primäre Methoden, um Ihr Inventar zu verwalten:

Statisches Inventar: Hierbei definieren Sie Hosts und Gruppen manuell in einer Datei (INI- oder YAML-Format).
Dynamisches Inventar: Hierbei werden Skripte oder Plugins verwendet, um ein Inventar von Hosts dynamisch aus externen Quellen wie Cloud-Anbietern (AWS, Azure, GCP), Virtualisierungsplattformen (VMware) oder CMDBs zu generieren.

Statische Inventardateien

Statische Inventare sind für Umgebungen mit einem stabilen Satz von Servern unkompliziert. Sie werden typischerweise in einem INI-ähnlichen Format oder in YAML geschrieben.

INI-Format

Im INI-Format werden Hosts aufgelistet und können in Gruppen organisiert werden. Sie können auch Variablen für Hosts oder Gruppen definieren.

Beispiel /etc/ansible/hosts (INI-Format):

[webservers]
web1.example.com
web2.example.com ansible_user=deployer

[databases]
db1.example.com
db2.example.com

[all:vars]
ansible_ssh_private_key_file=~/.ssh/id_rsa
ansible_python_interpreter=/usr/bin/python3

In diesem Beispiel:

[webservers] und [databases] definieren Gruppen.
web1.example.com und web2.example.com sind Hosts innerhalb der Gruppe webservers.
ansible_user=deployer setzt einen bestimmten SSH-Benutzer für web2.example.com.
[all:vars] definiert Variablen, die für alle Hosts im Inventar gelten.

YAML-Format

Das YAML-Format bietet mehr Flexibilität für komplexe Inventarstrukturen und Variablendefinitionen.

Beispiel /etc/ansible/hosts (YAML-Format):

all:
  children:
    webservers:
      hosts:
        web1.example.com:
        web2.example.com:
          ansible_user: deployer
    databases:
      hosts:
        db1.example.com:
        db2.example.com:
  vars:
    ansible_ssh_private_key_file: ~/.ssh/id_rsa
    ansible_python_interpreter: /usr/bin/python3

Diese YAML-Struktur erreicht dieselbe Gruppierung und Variablenzuweisung wie das INI-Beispiel.

Dynamisches Inventar

Dynamische Inventare sind für Cloud-native Umgebungen unerlässlich, in denen Server häufig bereitgestellt und abgebaut werden. Ansible unterstützt dynamische Inventare durch Plugins und benutzerdefinierte Skripte.

Verwenden von dynamischen Inventar-Plugins

Ansible wird mit einer Vielzahl integrierter dynamischer Inventar-Plugins für gängige Cloud-Anbieter und Dienste ausgeliefert. Um eines zu verwenden, erstellen Sie in der Regel eine Inventar-Konfigurationsdatei (oft im YAML-Format), die das Plugin und seine Parameter angibt.

Beispiel: AWS EC2 Dynamische Inventar-Konfiguration (aws_ec2.yml)

plugin: amazon.aws.aws_ec2
regions:
  - us-east-1
  - us-west-2
keyed_groups:
  # Instanzen nach ihren EC2-Instance-Tags gruppieren
  - key: tags
    prefix: tag
filters:
  # Nur laufende Instanzen einschließen
  instance-state-name: running
compose:
  # ansible_host auf die private IP-Adresse setzen
  ansible_host: private_ip_address

Um dies mit Ansible zu verwenden, würden Sie einen Befehl wie den folgenden ausführen:

ansible-inventory -i aws_ec2.yml --graph

Dieser Befehl würde AWS nach laufenden Instanzen in den angegebenen Regionen abfragen und sie basierend auf ihren Tags und anderen Attributen in einem hierarchischen Graphen anzeigen.

Für viele Cloud-Inventar-Plugins müssen Sie die entsprechende Sammlung installiert haben. Für AWS EC2 bedeutet das normalerweise amazon.aws, plus funktionierende AWS-Anmeldeinformationen in Ihrer Umgebung, Ihrem Profil oder Ihrer Instanzrolle.

Benutzerdefinierte dynamische Inventar-Skripte

Wenn ein integriertes Plugin Ihren Anforderungen nicht entspricht, können Sie Ihr eigenes Skript (z. B. in Python) schreiben, das Inventardaten im JSON-Format ausgibt. Dieses Skript muss ausführbar sein und ein JSON-Objekt zurückgeben, das Ihr Inventar darstellt.

Beispiel Python-Skript (my_dynamic_inventory.py):

#!/usr/bin/env python

import json

# Simuliert das Abrufen von Inventardaten
hosts_data = {
    "_meta": {
        "hostvars": {
            "host1.example.com": {"ansible_user": "admin"},
            "host2.example.com": {"ansible_user": "user"}
        }
    },
    "webservers": {
        "hosts": ["host1.example.com", "host2.example.com"]
    },
    "databases": {
        "hosts": ["db1.example.com"]
    }
}

print(json.dumps(hosts_data))

Machen Sie das Skript ausführbar:

chmod +x my_dynamic_inventory.py

Und verwenden Sie es dann mit Ansible:

ansible-inventory -i my_dynamic_inventory.py --list

Verwalten des Inventars mit `ansible-inventory`

Der Befehl ansible-inventory ist ein leistungsstarkes Dienstprogramm zur Überprüfung und Verwaltung Ihres Inventars. Er kann verschiedene Inventarquellen parsen und die Hosts sowie deren zugehörige Variablen anzeigen.

Anzeigen aktiver Hosts

Um eine flache Liste aller Hosts in Ihrem Inventar zu sehen:

ansible-inventory -i /pfad/zu/ihrem/inventar --list

Dieser Befehl gibt eine JSON-Struktur aus, die Ihr gesamtes Inventar einschließlich Gruppen und Hostvariablen darstellt.

Gruppieren von Systemen

Wie in den Beispielen für statische Inventare gezeigt, ist die Gruppierung für die gezielte Ansprache bestimmter Maschinengruppen unerlässlich. Sie können Gruppen für verschiedene Rollen (Webserver, Datenbanken, Appserver), Umgebungen (Produktion, Staging) oder jede logische Kategorisierung erstellen, die für Ihre Infrastruktur sinnvoll ist.

Ansible erstellt automatisch Gruppen basierend auf Ihrer Inventardatei. Sie können auch spezielle Gruppen wie all (die jeden Host enthält) und ungrouped (Hosts, die keiner bestimmten Gruppe zugeordnet sind) definieren.

Verwenden integrierter Inventar-Befehlsflags

Der Befehl ansible-inventory bietet mehrere Flags für eine detaillierte Überprüfung:

--graph: Zeigt das Inventar in einem hierarchischen Baumformat an, das Gruppen und ihre Mitglieder zeigt.

ansible-inventory -i /etc/ansible/hosts --graph

Beispielausgabe:

@all
├──@databases
│  ├──db1.example.com
│  └──db2.example.com
└──@webservers
   ├──web1.example.com
   └──web2.example.com

--host <hostname>: Zeigt alle mit einem bestimmten Host verbundenen Variablen an.

ansible-inventory -i /etc/ansible/hosts --host web2.example.com