JSON zurückgeben und changed berücksichtigen
Halten Sie sich an das Protokoll für Modulergebnisse.
JSON zurückgeben und changed berücksichtigen ist eine kostenlose Ansible Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Ansible Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Ansible Academy-Kurs umfasst insgesamt 4 Lektionen.
Module kommunizieren über JSON
Wenn Ihr Modul fertig ist, muss es Ansible ein JSON-Ergebnis übergeben. So erfährt der Controller, was auf dem Host passiert ist.
Mit exit_json beenden
Rufen Sie bei Erfolg module.exit_json auf. Dadurch wird das Ergebnis als JSON ausgegeben und das Modul mit dem richtigen Exit-Code sauber beendet.
module.exit_json(changed=True, name='web')Der Schlüssel changed ist entscheidend
Melden Sie changed immer wahrheitsgemäß. Damit teilen Sie Ansible mit, ob Sie das System geändert haben; davon hängt ab, ob die Ausgabe die Zeile ok oder changed enthält.
module.exit_json(changed=False)Zustand vor Änderungen prüfen
Um changed korrekt zu melden, lesen Sie zuerst den aktuellen Zustand aus. Entspricht er bereits dem Ziel, setzen Sie changed=False und tun nichts.
if current == desired:
module.exit_json(changed=False)Zusätzliche Daten zurückgeben
Fügen Sie exit_json beliebige Schlüssel hinzu; sie erscheinen im Aufgabenergebnis. Benutzer können diese Daten später mit register erfassen und wiederverwenden.
module.exit_json(changed=True, user_id=42)Mit fail_json fehlschlagen
Wenn etwas schiefgeht, rufen Sie module.fail_json mit einer klaren Meldung auf. Ansible markiert die Aufgabe als fehlgeschlagen und zeigt Ihren Text an.
module.fail_json(msg='API request timed out')Niemals einfach ausgeben
Verwenden Sie weder print noch rohe stdout-Ausgabe. Ansible erwartet ausschließlich dieses abschließende JSON-Objekt; eine zusätzliche print-Ausgabe beschädigt das Ergebnis und lässt die Aufgabe fehlschlagen.
Genau ein Exit-Aufruf
Jedes Modul endet genau mit einem exit_json oder fail_json. Beide lösen SystemExit aus, daher wird danach nichts mehr ausgeführt.
Eine hilfreiche Nachricht wirkt
Fügen Sie Ihren Ergebnissen eine freundliche msg hinzu, die beschreibt, was Sie getan haben. Gute Nachrichten machen verwirrende Läufe verständlich.
module.exit_json(changed=True, msg='Created user web')Verhalten integrierter Module nachbilden
Gestalten Sie Ihre Ausgabe wie die der Kernmodule: Melden Sie changed, geben Sie aussagekräftige Felder zurück und schlagen Sie mit einer Begründung deutlich fehl. Konsistenz schafft Vertrauen.
Das Ergebnis steuert alles
Handler, Bedingungen und registrierte Variablen lesen alle Ihr JSON. Nur wenn changed korrekt gesetzt ist, verhält sich Ihr Modul wie ein guter Ansible-Bürger.
Kurzer Check
Überlegen Sie, was Ihr Modul melden sollte, wenn nichts geändert wurde.
Zusammenfassung
Beenden Sie das Modul bei Erfolg mit exit_json oder bei einem Fehler mit fail_json, melden Sie changed ehrlich und geben Sie niemals rohe Ausgaben aus. Das ist das Protokoll für Modulergebnisse. 📦
Häufig gestellte Fragen
Ist die Lektion „JSON zurückgeben und changed berücksichtigen“ kostenlos?
Ja — der vollständige Text von „JSON zurückgeben und changed berücksichtigen“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Ansible Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Ansible Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „JSON zurückgeben und changed berücksichtigen“?
Halten Sie sich an das Protokoll für Modulergebnisse. Du übst Ansible Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um Ansible Academy zu starten?
Keine Vorkenntnisse erforderlich. Ansible Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.
Wie lange dauert die Lektion „JSON zurückgeben und changed berücksichtigen“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser Ansible Academy-Lektion Code schreiben und ausführen?
Ja. Jede Ansible Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- Wann Sie ein eigenes Modul erstellen sollten
- AnsibleModule und Argument Spec
- JSON zurückgeben und changed berücksichtigen
- Check Mode in Ihrem Modul unterstützen