Guide de gestion de l'inventaire dynamique et statique avec Ansible

L'inventaire Ansible répond à une question pratique : quels systèmes cette automatisation doit-elle toucher ? Si votre inventaire est erroné, un bon playbook peut toujours cibler le mauvais hôte, ignorer un nouveau serveur ou utiliser les mauvaises variables de connexion.

Ce guide couvre les fichiers d'inventaire statiques, les sources d'inventaire dynamiques et les vérifications ansible-inventory qui vous aident à confirmer qu'Ansible voit la même infrastructure que celle attendue.

Comprendre l'inventaire Ansible

À la base, un inventaire Ansible est une liste d'hôtes et de groupes. Ansible utilise ces informations pour déterminer à quelles machines se connecter et sur lesquelles exécuter des tâches. L'emplacement par défaut du fichier d'inventaire est /etc/ansible/hosts, mais vous pouvez spécifier un fichier d'inventaire différent pour toute commande ou playbook Ansible à l'aide de l'indicateur -i.

Il existe deux principales façons de gérer votre inventaire :

Inventaire statique : Cela implique de définir manuellement les hôtes et les groupes dans un fichier (format INI ou YAML).
Inventaire dynamique : Cela utilise des scripts ou des plugins pour générer dynamiquement un inventaire d'hôtes à partir de sources externes comme les fournisseurs de cloud (AWS, Azure, GCP), les plateformes de virtualisation (VMware) ou les CMDB.

Fichiers d'inventaire statiques

Les inventaires statiques sont simples pour les environnements avec un ensemble stable de serveurs. Ils sont généralement écrits dans un format de type INI ou YAML.

Format INI

Dans le format INI, les hôtes sont listés et peuvent être organisés en groupes. Vous pouvez également définir des variables pour les hôtes ou les groupes.

Exemple /etc/ansible/hosts (format INI) :

[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

Dans cet exemple :

[webservers] et [databases] définissent des groupes.
web1.example.com et web2.example.com sont des hôtes du groupe webservers.
ansible_user=deployer définit un utilisateur SSH spécifique pour web2.example.com.
[all:vars] définit des variables qui s'appliquent à tous les hôtes de l'inventaire.

Format YAML

Le format YAML offre plus de flexibilité pour les structures d'inventaire complexes et les définitions de variables.

Exemple /etc/ansible/hosts (format YAML) :

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

Cette structure YAML réalise le même regroupement et la même affectation de variables que l'exemple INI.

Inventaire dynamique

Les inventaires dynamiques sont essentiels pour les environnements cloud-natifs où les serveurs sont provisionnés et déprovisionnés fréquemment. Ansible prend en charge les inventaires dynamiques via des plugins et des scripts personnalisés.

Utilisation des plugins d'inventaire dynamique

Ansible est livré avec une large gamme de plugins d'inventaire dynamique intégrés pour les fournisseurs de cloud et les services populaires. Pour en utiliser un, vous créez généralement un fichier de configuration d'inventaire (souvent en YAML) qui spécifie le plugin et ses paramètres.

Exemple : Configuration de l'inventaire dynamique AWS EC2 (aws_ec2.yml)

plugin: amazon.aws.aws_ec2
regions:
  - us-east-1
  - us-west-2
keyed_groups:
  # Grouper les instances par leurs balises EC2
  - key: tags
    prefix: tag
filters:
  # Inclure uniquement les instances en cours d'exécution
  instance-state-name: running
compose:
  # Définir ansible_host sur l'adresse IP privée
  ansible_host: private_ip_address

Pour l'utiliser avec Ansible, vous exécuteriez une commande comme :

ansible-inventory -i aws_ec2.yml --graph

Cette commande interrogerait AWS pour les instances en cours d'exécution dans les régions spécifiées et les afficherait dans un graphique hiérarchique basé sur leurs balises et autres attributs.

Vous devez avoir la collection appropriée installée pour de nombreux plugins d'inventaire cloud. Pour AWS EC2, cela signifie généralement amazon.aws, ainsi que des identifiants AWS fonctionnels dans votre environnement, profil ou rôle d'instance.

Scripts d'inventaire dynamique personnalisés

Si un plugin intégré ne répond pas à vos besoins, vous pouvez écrire votre propre script (en Python, par exemple) qui produit des données d'inventaire au format JSON. Ce script doit être exécutable et renvoyer un objet JSON représentant votre inventaire.

Exemple de script Python (my_dynamic_inventory.py) :

#!/usr/bin/env python

import json

# Simuler la récupération des données d'inventaire
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))

Rendez le script exécutable :

chmod +x my_dynamic_inventory.py

Et utilisez-le ensuite avec Ansible :

ansible-inventory -i my_dynamic_inventory.py --list

Gestion de l'inventaire avec `ansible-inventory`

La commande ansible-inventory est un utilitaire puissant pour inspecter et gérer votre inventaire. Elle peut analyser différentes sources d'inventaire et afficher les hôtes et leurs variables associées.

Affichage des hôtes actifs

Pour voir une liste plate de tous les hôtes de votre inventaire :

ansible-inventory -i /chemin/vers/votre/inventaire --list

Cette commande produira une structure JSON représentant l'intégralité de votre inventaire, y compris les groupes et les variables d'hôte.

Regroupement des systèmes

Comme démontré dans les exemples d'inventaire statique, le regroupement est essentiel pour cibler des ensembles spécifiques de machines. Vous pouvez créer des groupes pour différents rôles (serveurs web, bases de données, serveurs d'applications), environnements (production, staging) ou toute catégorisation logique qui a du sens pour votre infrastructure.

Ansible crée automatiquement des groupes en fonction de votre fichier d'inventaire. Vous pouvez également définir des groupes spéciaux comme all (qui inclut chaque hôte) et ungrouped (hôtes non assignés à un groupe spécifique).

Utilisation des indicateurs de commande d'inventaire intégrés

La commande ansible-inventory offre plusieurs indicateurs pour une inspection détaillée :

--graph : Affiche l'inventaire dans un format d'arborescence hiérarchique, montrant les groupes et leurs membres.

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

Exemple de sortie :

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

--host <nom_hôte> : Affiche toutes les variables associées à un hôte spécifique.

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