Come Usare Ansible: Guida per Iniziare

IAC / Configuration management
1

Introduzione ad Ansible: Lo Strumento di Automazione IT Essenziale

Ansible è uno strumento di automazione IT open-source sviluppato da Red Hat che consente di gestire configurazioni, distribuire applicazioni e orchestrare task complessi su infrastrutture distribuite. A differenza di altri tool di configuration management come Puppet o Chef, Ansible si distingue per la sua semplicità d’uso e per l’approccio agentless, che non richiede l’installazione di software aggiuntivo sui nodi target.

Cos’è Ansible: Definizione e Vantaggi

Definizione e Scopo di Ansible

Ansible è un framework di automazione che utilizza un linguaggio dichiarativo per descrivere le configurazioni di sistema. È uno degli strumenti di configuration management più popolari al mondo grazie alla sua semplicità e versatilità.

Lo strumento è progettato per risolvere problemi comuni nell’amministrazione di sistemi:

  • Configurazione automatizzata di server e workstation

  • Deploy automatico di applicazioni

  • Orchestrazione di workflow complessi

  • Gestione centralizzata di aggiornamenti di sicurezza

  • Provisioning automatico di infrastrutture cloud

Architettura e Componenti Principali

L’architettura di Ansible è basata su diversi componenti chiave:

Control Node: La macchina su cui è installato Ansible e da cui vengono eseguiti i comandi. Può essere qualsiasi sistema Unix/Linux con Python installato.

Managed Nodes: I server target che vengono gestiti da Ansible. Non richiedono agenti specifici, ma solo una connessione SSH e Python.

Inventory: Un file che definisce i gruppi di host e le loro proprietà. Può essere statico (file INI o YAML) o dinamico (script che interrogano API esterne).

Playbooks: File YAML che contengono una serie di “plays”, ognuno dei quali definisce task da eseguire su specifici gruppi di host.

Modules: Unità di lavoro discrete che Ansible esegue sui managed nodes. Esistono centinaia di moduli per gestire file, pacchetti, servizi, utenti, database e molto altro.

Roles: Raggruppamenti riutilizzabili di variabili, tasks, files, templates e handlers che facilitano l’organizzazione del codice.

Caratteristiche Distintive di Ansible

Approccio Agentless: Semplicità e Sicurezza

Una delle caratteristiche più apprezzate di Ansible è l’approccio agentless. La comunicazione con i nodi target avviene tramite SSH (per sistemi Unix/Linux) o WinRM (per Windows), senza necessità di installare daemon o agenti specifici. Questo semplifica notevolmente il deployment e riduce il carico sui sistemi target.

Idempotenza: Sicurezza nelle Operazioni

Ansible garantisce l’idempotenza delle operazioni: eseguire lo stesso playbook più volte produce sempre lo stesso risultato. Se il sistema è già nello stato desiderato, Ansible non apporta modifiche, riducendo il rischio di effetti collaterali indesiderati.

Linguaggio Dichiarativo YAML

I playbook utilizzano YAML, un formato human-readable che descrive lo stato desiderato del sistema piuttosto che i passaggi procedurali per raggiungerlo. Questo approccio dichiarativo rende il codice più comprensibile e manutenibile.

Come Installare Ansible: Guida Step-by-Step

Requisiti di Sistema per Ansible

Per il control node:

  • Sistema operativo Unix/Linux (Red Hat, CentOS, Ubuntu, Debian, macOS)

  • Python 2.7 o Python 3.5+ (raccomandato Python 3.8+)

  • SSH client

Per i managed nodes:

  • Connettività SSH

  • Python 2.6+ o Python 3.5+

  • Account con privilegi sudo (per operazioni privilegiate)

Installazione di Ansible su Diversi Sistemi Operativi

Ubuntu/Debian:

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository --yes --update ppa:ansible/ansible
sudo apt install ansible

CentOS/RHEL:

sudo yum install epel-release
sudo yum install ansible

Fedora:

sudo dnf install ansible

Installazione via pip (metodo universale):

pip3 install ansible

Configurazione SSH

Per un funzionamento ottimale, è consigliabile configurare l’accesso SSH senza password utilizzando chiavi SSH:

# Generazione chiave SSH (se non esistente)
ssh-keygen -t rsa -b 4096 -C "[email protected]"

# Copia della chiave pubblica sui managed nodes
ssh-copy-id user@hostname

Tutorial Ansible: Primi Passi Pratici

In questa sezione creeremo un ambiente di test pratico per imparare i concetti base di Ansible. Configureremo un inventory con un server target, testeremo la connettività e creeremo il nostro primo playbook per installare e configurare un web server nginx. Questo tutorial ti permetterà di comprendere il workflow completo di Ansible dalla configurazione iniziale all’esecuzione di task automatizzati.

Creazione dell’Inventory

L’inventory definisce i server che Ansible gestirà. Creare un file chiamato inventory.yml utilizzando il formato YAML:

all:
  hosts:
    server1.example.com:
      ansible_host: 192.168.1.100
      ansible_user: ubuntu
      ansible_ssh_private_key_file: ~/.ssh/id_rsa
      http_port: 80
      environment: production
      server_role: webserver

Test di Connettività

Verificare la connettività con il nodo target:

ansible all -i inventory.yml -m ping

Primo Comando Ad-Hoc

I comandi ad-hoc permettono di eseguire task singoli senza creare playbook:

# Controllare l'uptime del server
ansible all -i inventory.yml -m command -a "uptime"

# Installare un pacchetto sul server
ansible all -i inventory.yml -m apt -a "name=nginx state=present" --become

Primo Playbook

Creare un file webserver-setup.yml:

---
- name: Setup Web Server
  hosts: all
  become: yes
  vars:
    http_port: 80
    
  tasks:
    - name: Install nginx
      apt:
        name: nginx
        state: present
        update_cache: yes
        
    - name: Start nginx service
      service:
        name: nginx
        state: started
        enabled: yes
        
    - name: Copy index.html
      copy:
        content: |
          <html>
          <head><title>Welcome</title></head>
          <body><h1>Server managed by Ansible</h1></body>
          </html>
        dest: /var/www/html/index.html
        owner: www-data
        group: www-data
        mode: '0644'
        
    - name: Ensure nginx is running
      service:
        name: nginx
        state: started

Eseguire il playbook:

ansible-playbook -i inventory.yml webserver-setup.yml

Concetti Avanzati Ansible per Principianti

Variabili e Template

Ansible supporta diversi tipi di variabili e l’uso di template Jinja2:

# In group_vars/all.yml
nginx_worker_processes: 4
nginx_worker_connections: 1024
server_name: "{{ ansible_fqdn }}"

Condizioni e Loop

- name: Install packages
  apt:
    name: "{{ item }}"
    state: present
  loop:
    - nginx
    - mysql-server
    - php-fpm
  when: ansible_os_family == "Debian"

Organizzazione con Roles

Struttura directory per un role:

roles/
  webserver/
    tasks/
      main.yml
    handlers/
      main.yml
    templates/
      nginx.conf.j2
    vars/
      main.yml
    defaults/
      main.yml

Best Practices Ansible: Come Organizzare i Progetti

Struttura del Progetto

Organizzare i file seguendo una struttura standard:

ansible-project/
├── inventory/
│   ├── production.yml
│   └── staging.yml
├── group_vars/
│   └── all.yml
├── host_vars/
├── roles/
├── playbooks/
└── requirements.yml

Gestione dei Segreti con Ansible Vault

La gestione sicura delle credenziali e informazioni sensibili è fondamentale in ogni ambiente di produzione. Ansible Vault fornisce una soluzione elegante per criptare dati sensibili come password, chiavi API e certificati.

Cos’è Ansible Vault

Ansible Vault è un sistema di cifratura integrato che permette di mantenere i dati sensibili in formato criptato all’interno dei repository di codice. Utilizza l’algoritmo AES256 per garantire un alto livello di sicurezza.

Creazione di File Criptati

Per creare un nuovo file criptato:

# Creare un nuovo file vault
ansible-vault create secrets.yml

Il comando aprirà l’editor predefinito per inserire il contenuto:

---
database_password: "mySecretPassword123"
api_key: "sk-1234567890abcdef"
ssl_private_key: |
  -----BEGIN PRIVATE KEY-----
  MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQC...
  -----END PRIVATE KEY-----

Modifica di File Esistenti

Per modificare un file già criptato:

# Modificare un file criptato esistente
ansible-vault edit secrets.yml

# Visualizzare il contenuto senza modificarlo
ansible-vault view secrets.yml

Criptare File Esistenti

Se hai già file con dati sensibili non criptati:

# Criptare un file esistente
ansible-vault encrypt existing_secrets.yml

# Decriptare un file (attenzione: il file rimarrà in chiaro)
ansible-vault decrypt secrets.yml

Utilizzo delle Variabili Criptate

Le variabili definite nei file vault possono essere utilizzate normalmente nei playbook:

---
- name: Deploy application with secrets
  hosts: all
  vars_files:
    - secrets.yml
  tasks:
    - name: Configure database connection
      template:
        src: database.conf.j2
        dest: /etc/app/database.conf
      vars:
        db_password: "{{ database_password }}"
        
    - name: Set API key environment variable
      lineinfile:
        path: /etc/environment
        line: "API_KEY={{ api_key }}"
        state: present

Esecuzione di Playbook con Vault

Quando esegui playbook che utilizzano file vault, devi fornire la password:

# Prompt interattivo per la password
ansible-playbook -i inventory.yml playbook.yml --ask-vault-pass

# Leggere la password da un file
ansible-playbook -i inventory.yml playbook.yml --vault-password-file ~/.vault_pass

# Utilizzare uno script per ottenere la password
ansible-playbook -i inventory.yml playbook.yml --vault-password-file get_vault_pass.sh

Debugging con Vault

Durante lo sviluppo, può essere utile verificare il contenuto dei file vault:

# Debug: mostrare variabili risolte (attenzione ai log!)
ansible-playbook playbook.yml --ask-vault-pass -vv

# Verificare solo la sintassi senza eseguire
ansible-playbook playbook.yml --ask-vault-pass --syntax-check

Debugging e Troubleshooting Ansible

Modalità Verbose per Debug

Utilizzare flag di verbose per debugging:

ansible-playbook -i inventory.yml playbook.yml -v   # verbose
ansible-playbook -i inventory.yml playbook.yml -vv  # più verbose
ansible-playbook -i inventory.yml playbook.yml -vvv # debug

Check Mode e Diff

Testare i cambiamenti senza applicarli:

ansible-playbook -i inventory.yml playbook.yml --check --diff

Step Mode

Eseguire task passo per passo:

ansible-playbook -i inventory.yml playbook.yml --step

Risorse Ansible per Approfondire

Documentazione Ufficiale Ansible

La documentazione ufficiale di Ansible è estremamente completa e include guide dettagliate, riferimenti dei moduli e esempi pratici. È disponibile su docs.ansible.com e rappresenta la risorsa principale per imparare Ansible.

Ansible Galaxy: Community e Roles

Ansible Galaxy è il repository ufficiale per condividere roles e collections. Permette di riutilizzare codice sviluppato dalla community e di contribuire con i propri sviluppi, accelerando lo sviluppo di automazioni complesse.

Strumenti Complementari per Ansible

  • AWX/Ansible Tower: Interfaccia web enterprise per Ansible con gestione centralizzata

  • Molecule: Framework per testare roles Ansible in ambienti isolati

  • Ansible Lint: Tool per analisi statica dei playbook e best practices

Conclusione: Perché Scegliere Ansible

Ansible rappresenta una soluzione elegante e potente per l’automazione IT moderna. La sua curva di apprendimento graduale permette di iniziare con task semplici e progredire verso orchestrazioni complesse. L’approccio agentless, l’idempotenza e la sintassi YAML lo rendono accessibile anche a chi non ha esperienza specifica con strumenti di configuration management.

Per iniziare efficacemente con Ansible, è consigliabile partire da use case semplici come la configurazione di singoli servizi, per poi espandere gradualmente verso scenari più complessi che coinvolgono multiple applicazioni e ambienti. La pratica costante e l’esplorazione della vasta documentazione disponibile sono le chiavi per padroneggiare questo strumento versatile e diventare un esperto di automazione IT.