JSON retourneren en changed respecteren

Meld changed altijd eerlijk. Hiermee vertel je Ansible of je het systeem hebt gewijzigd. Dat bepaalt of de uitvoerregel ok of changed bevat.

Lees eerst de huidige status om changed correct te gebruiken. Als die al overeenkomt met het doel, stel je changed=False in en doe je niets.

Voeg aan exit_json zoveel sleutels toe als je wilt; ze verschijnen in het taakresultaat. Gebruikers kunnen die gegevens later registreren en opnieuw gebruiken.

Roep bij problemen module.fail_json aan met een duidelijke melding. Ansible markeert de taak als mislukt en toont jouw tekst.

Gebruik geen print of onbewerkte stdout. Ansible verwacht alleen dat ene uiteindelijke JSON-object. Een losse print beschadigt het resultaat en laat de taak mislukken.

Elke module eindigt precies met één exit_json of fail_json. Beide werpen SystemExit op, dus niets erna wordt uitgevoerd.

Neem een vriendelijke msg op in je resultaten waarin je beschrijft wat je hebt gedaan. Goede meldingen maken verwarrende uitvoeringen leesbaar.

Laat je uitvoer aanvoelen als die van kernmodules: meld changed, geef betekenisvolle velden terug en misluk duidelijk met een reden. Consistentie wekt vertrouwen.

Afhandelaars, voorwaarden en geregistreerde variabelen lezen allemaal je JSON. Als je changed correct instelt, gedraagt je module zich als een goede Ansible-burger.

Beëindig bij succes met exit_json of bij een fout met fail_json, meld changed eerlijk en druk nooit onbewerkte uitvoer af. Dat is het protocol voor module-resultaten. 📦