Guida alla Gestione dell'Inventario Dinamico e Statico con Ansible

L'inventario di Ansible risponde a una domanda pratica: quali sistemi dovrebbe toccare questa automazione? Se il tuo inventario è sbagliato, un buon playbook può comunque colpire l'host sbagliato, saltare un nuovo server o utilizzare variabili di connessione errate.

Questa guida copre i file di inventario statici, le fonti di inventario dinamiche e i controlli ansible-inventory che ti aiutano a confermare che Ansible veda la stessa infrastruttura che ti aspetti.

Comprendere l'Inventario di Ansible

Alla base, un inventario Ansible è un elenco di host e gruppi. Ansible utilizza queste informazioni per determinare a quali macchine connettersi e su quali eseguire attività. La posizione predefinita del file di inventario è /etc/ansible/hosts, ma puoi specificare un file di inventario diverso per qualsiasi comando o playbook Ansible utilizzando il flag -i.

Esistono due modi principali per gestire il tuo inventario:

Inventario Statico: Comporta la definizione manuale di host e gruppi in un file (formato INI o YAML).
Inventario Dinamico: Utilizza script o plugin per generare dinamicamente un inventario di host da fonti esterne come provider cloud (AWS, Azure, GCP), piattaforme di virtualizzazione (VMware) o CMDB.

File di Inventario Statici

Gli inventari statici sono semplici per ambienti con un insieme stabile di server. Sono tipicamente scritti in un formato simile a INI o YAML.

Formato INI

Nel formato INI, gli host sono elencati e possono essere organizzati in gruppi. Puoi anche definire variabili per host o gruppi.

Esempio /etc/ansible/hosts (formato 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

In questo esempio:

[webservers] e [databases] definiscono i gruppi.
web1.example.com e web2.example.com sono host all'interno del gruppo webservers.
ansible_user=deployer imposta un utente SSH specifico per web2.example.com.
[all:vars] definisce le variabili che si applicano a tutti gli host nell'inventario.

Formato YAML

Il formato YAML offre maggiore flessibilità per strutture di inventario complesse e definizioni di variabili.

Esempio /etc/ansible/hosts (formato 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

Questa struttura YAML realizza lo stesso raggruppamento e assegnazione di variabili dell'esempio INI.

Inventario Dinamico

Gli inventari dinamici sono essenziali per ambienti cloud-native in cui i server vengono frequentemente provisionati e de-provisionati. Ansible supporta inventari dinamici attraverso plugin e script personalizzati.

Utilizzo dei Plugin di Inventario Dinamico

Ansible include un'ampia gamma di plugin di inventario dinamico integrati per provider cloud e servizi popolari. Per utilizzarne uno, di solito crei un file di configurazione dell'inventario (spesso in YAML) che specifica il plugin e i suoi parametri.

Esempio: Configurazione Inventario Dinamico AWS EC2 (aws_ec2.yml)

plugin: amazon.aws.aws_ec2
regions:
  - us-east-1
  - us-west-2
keyed_groups:
  # Raggruppa le istanze per i loro tag EC2
  - key: tags
    prefix: tag
filters:
  # Includi solo le istanze in esecuzione
  instance-state-name: running
compose:
  # Imposta ansible_host sull'indirizzo IP privato
  ansible_host: private_ip_address

Per utilizzarlo con Ansible, eseguirai un comando come:

ansible-inventory -i aws_ec2.yml --graph

Questo comando interrogherà AWS per le istanze in esecuzione nelle regioni specificate e le visualizzerà in un grafico gerarchico basato sui loro tag e altri attributi.

Per molti plugin di inventario cloud è necessaria la raccolta appropriata. Per AWS EC2, di solito significa amazon.aws, oltre a credenziali AWS funzionanti nel tuo ambiente, profilo o ruolo dell'istanza.

Script di Inventario Dinamico Personalizzati

Se un plugin integrato non soddisfa le tue esigenze, puoi scrivere il tuo script (ad esempio in Python) che restituisce i dati dell'inventario in formato JSON. Questo script deve essere eseguibile e restituire un oggetto JSON che rappresenta il tuo inventario.

Esempio di script Python (my_dynamic_inventory.py):

#!/usr/bin/env python

import json

# Simula il recupero dei dati dell'inventario
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))

Rendi lo script eseguibile:

chmod +x my_dynamic_inventory.py

E poi usalo con Ansible:

ansible-inventory -i my_dynamic_inventory.py --list

Gestione dell'Inventario con `ansible-inventory`

Il comando ansible-inventory è un potente strumento per ispezionare e gestire il tuo inventario. Può analizzare diverse fonti di inventario e visualizzare gli host e le loro variabili associate.

Visualizzare gli Host Attivi

Per vedere un elenco piatto di tutti gli host nel tuo inventario:

ansible-inventory -i /path/to/your/inventory --list

Questo comando restituirà una struttura JSON che rappresenta l'intero inventario, inclusi gruppi e variabili degli host.

Raggruppare i Sistemi

Come dimostrato negli esempi di inventario statico, il raggruppamento è essenziale per indirizzare set specifici di macchine. Puoi creare gruppi per diversi ruoli (webserver, database, appserver), ambienti (produzione, staging) o qualsiasi categorizzazione logica che abbia senso per la tua infrastruttura.

Ansible crea automaticamente gruppi basati sul tuo file di inventario. Puoi anche definire gruppi speciali come all (che include ogni host) e ungrouped (host non assegnati a nessun gruppo specifico).

Utilizzare i Flag Integrati del Comando di Inventario

Il comando ansible-inventory offre diversi flag per un'ispezione dettagliata:

--graph: Visualizza l'inventario in un formato ad albero gerarchico, mostrando i gruppi e i loro membri.

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

Esempio di Output:

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

--host <hostname>: Mostra tutte le variabili associate a un host specifico.

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