Wat een module eigenlijk is

Elke actie die Ansible uitvoert, verloopt via een module: een klein programma dat weet hoe je een pakket installeert, een bestand kopieert of een service herstart.

Elke module behandelt één soort taak. De module copy kopieert bestanden en de module user beheert accounts. Door ze te combineren voer je grotere taken uit.

Ansible stuurt de module naar het doelknooppunt, voert deze daar uit en verzamelt vervolgens het resultaat. Het besturingsknooppunt raakt het beheerde systeem nooit rechtstreeks aan.

Je vertelt een module wat de gewenste toestand is, zoals present of started. De module bepaalt zelf welke stappen nodig zijn om die toestand te bereiken.

Je geeft een module sleutel-waardeparen met argumenten die beschrijven wat je wilt. Elke module documenteert precies welke sleutels ze accepteert.

Voer een goede module twee keer uit en de tweede keer verandert er niets. De module controleert eerst de huidige toestand, waardoor ze idempotent en veilig opnieuw uit te voeren is.

Elke module retourneert JSON waarmee Ansible meldt of er iets is veranderd, de uitvoering is geslaagd of is mislukt. Zo verschijnen ok, changed of failed in de uitvoer.

Ansible wordt geleverd met honderden ingebouwde modules in de naamruimte ansible.builtin. Daarmee kun je direct bestanden, pakketten, services en meer beheren.

Je kunt elke module vanaf de opdrachtregel aanroepen met -m, zonder playbook. Dat is ideaal voor snelle, eenmalige taken.

Je kunt onbewerkte opdrachten via shell uitvoeren, maar modules bieden idempotentie en duidelijke resultaten. Gebruik liever een echte module dan shell wanneer er een geschikte module bestaat.

De moderne stijl gebruikt de volledig gekwalificeerde naam, zoals ansible.builtin.copy. Zo is precies duidelijk uit welke verzameling de module komt.

Een module is een klein programma dat één taak uitvoert op de externe host, argumenten accepteert, de gewenste toestand beschrijft en een resultaat retourneert waarop je kunt vertrouwen. 🧩