Quando creare un modulo personalizzato

Ansible include migliaia di moduli, ma a volte nessuno soddisfa la propria esigenza. È proprio in questi casi che un modulo personalizzato trova la sua ragion d'essere.

Controlli sempre prima Galaxy e la documentazione. Spesso una collection della community include già quell'API poco comune, consentendole di non scrivere alcun codice.

Se il playbook è pieno di chiamate a command e shell che analizzano l'output, è un segnale. Un modulo può nascondere questa complessità dietro argomenti chiari.

I task shell grezzi segnalano changed a ogni esecuzione. Un vero modulo controlla prima lo stato attuale, offrendo l'idempotenza che la shell non può garantire.

Potrebbe utilizzare uno strumento interno o un'API REST per cui non esiste ancora un modulo. Un modulo personalizzato trasforma l'integrazione in un task ordinato e riutilizzabile.

Ricordi che un modulo viene eseguito sul nodo gestito, non sulla macchina di controllo. Pertanto, Python e tutte le librerie necessarie devono essere presenti sull'host remoto.

Non ogni esigenza richiede un modulo. La trasformazione dei dati nei template è un compito da plugin filtro, mentre i moduli eseguono operazioni reali sull'host.

Inserisca un singolo file in una cartella library accanto al playbook e Ansible lo troverà automaticamente. Per iniziare non serve alcun pacchetto.

La maggior parte dei moduli è scritta in Python perché Ansible fornisce una libreria di supporto. Anche altri linguaggi funzionano, ma senza questo supporto.

Come i moduli integrati, il proprio modulo dovrebbe svolgere bene un solo compito. Eviti di comprimere cinque operazioni non correlate in un unico file eccessivamente complesso.

Ogni modulo segue un contratto: riceve argomenti JSON, esegue il lavoro e restituisce risultati JSON. Una volta acquisito questo schema, può costruire qualsiasi cosa.

Costruisca un modulo personalizzato solo dopo aver effettuato una ricerca, quando serve un'operazione idempotente e riutilizzabile che shell e moduli integrati non possono offrire. Lo mantenga focalizzato. 🛠️