Anatomia della directory di un ruolo

Un role è semplicemente una directory con un insieme fisso di sottocartelle. Ansible riconosce ogni cartella dal nome e ne carica automaticamente i contenuti.

Il file tasks/main.yml contiene l'elenco principale delle attività del role. È la prima cosa che Ansible esegue quando il role viene applicato.

La cartella handlers definisce azioni come il riavvio di un servizio. Le attività notificano questi handler, così i riavvii avvengono solo quando si verifica una modifica.

Inserisca i file template .j2 in templates/. Il modulo template li trova lì in base al nome, senza bisogno del percorso completo.

La cartella files contiene file semplici da copiare così come sono. Il modulo copy li individua automaticamente, proprio come avviene per i template.

Il file defaults/main.yml contiene variabili con la precedenza più bassa, così gli utenti possono sovrascriverle facilmente dall'esterno del role.

Il file vars/main.yml contiene variabili con una precedenza maggiore. Lo utilizzi per i valori da cui il role dipende e che dovrebbero cambiare raramente.

Il file meta/main.yml elenca l'autore del role, la licenza, le piattaforme supportate e le eventuali dipendenze da altri ruoli.

All'interno di tasks, handlers, vars e defaults, Ansible carica automaticamente il file denominato main.yml. Questa convenzione di denominazione tiene insieme la struttura.

Un role non deve contenere ogni cartella. Se non ha template, può semplicemente omettere la directory templates. Ansible ignora le cartelle opzionali mancanti.

I ruoli maturi includono un README e una cartella tests, così gli altri possono comprendere e verificare la Sua automazione prima di utilizzarla.

Un role è un albero di cartelle in cui tasks, handler, template, file, defaults, vars e meta hanno ciascuno una posizione fissa, il tutto organizzato attorno a main.yml. 📁