Aangepaste assertions met de fail-module
Stop een play met een duidelijke melding.
Aangepaste assertions met de fail-module is een gratis DevOps-bootcamp-les op CoddyKit. Dit is les 4 van 4. Je kunt 3 lessen uit dit leerpad gratis volledig lezen — daarna ontgrendelt CoddyKit PRO alle lessen, plus praktische oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject DevOps-bootcamp. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus DevOps-bootcamp bevat in totaal 4 lessen.
Stop met een duidelijke melding
Soms wil je een play expres stoppen met een nuttige reden. De module fail doet precies dat. 🛑
De module fail
ansible.builtin.fail stopt de huidige host met een aangepast bericht dat je zelf schrijft, in plaats van met een onduidelijke fout.
- name: Refuse unsupported OS
ansible.builtin.fail:
msg: "This playbook supports Ubuntu only"Laat fail door when bewaken
Een losse fail stopt altijd, dus combineer die met when. De play mislukt alleen wanneer aan je bewakingsvoorwaarde is voldaan.
- ansible.builtin.fail:
msg: "app_version is required"
when: app_version is not definedSnel en vroeg falen
Zet controles bovenaan een play. Verkeerde invoer vroeg onderscheppen is beter dan halverwege een implementatie mislukken.
De module assert
ansible.builtin.assert is duidelijker voor validatie: geef voorwaarden op in that en de taak mislukt als een ervan onwaar is.
- ansible.builtin.assert:
that:
- app_port is defined
- app_port | int > 1024Aangepaste berichten voor assert
Voeg fail_msg en success_msg toe aan assert voor duidelijke uitvoer bij beide uitkomsten. Elke uitvoering geeft zo heldere feedback.
- ansible.builtin.assert:
that: disk_free > 500
fail_msg: "Need at least 500MB free"
success_msg: "Disk space OK"assert controleert meerdere voorwaarden tegelijk
assert krijgt in that een lijst. Elke voorwaarde moet waar zijn; de eerste onware voorwaarde laat de taak mislukken met jouw bericht.
fail tegenover assert
Gebruik fail voor één bewuste stop met logica in when; gebruik assert om beknopt een reeks voorwaarden te valideren.
Waarden invoegen
Je msg kan variabelen bevatten voor context. Toon de verkeerde waarde, zodat de beheerder precies weet wat moet worden hersteld.
- ansible.builtin.fail:
msg: "Port {{ app_port }} is out of range"Asserties als documentatie
Goede asserties zijn ook levende documentatie: ze beschrijven de verwachtingen van een playbook en dwingen die op één plek af. 📝
De modus quiet voor assert
Stel quiet bij assert in op true om de uitvoer per voorwaarde over te slaan. Handig als je alleen om fouten geeft en niet om geslaagde controles.
- ansible.builtin.assert:
that: app_port is defined
quiet: trueSnelle controle
Kies het juiste hulpmiddel.
Samenvatting
De module fail stopt een play met een duidelijke melding, terwijl assert voorwaarden overzichtelijk valideert. Beveilig je playbooks proactief. ✅
Leer DevOps-bootcamp met een AI-tutor — gratis
Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.
- Cursussen
- 142
- Lessen
- 568
Veelgestelde vragen
Is de les “Aangepaste assertions met de fail-module” gratis?
Ja — je kunt hier op het web alle 3 lessen van het leerpad DevOps-bootcamp, waaronder “Aangepaste assertions met de fail-module”, gratis volledig lezen. Daarna ontgrendelt CoddyKit PRO alle lessen, plus interactieve oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. De cursus DevOps-bootcamp bevat in totaal 4 lessen.
Wat leer ik in “Aangepaste assertions met de fail-module”?
Stop een play met een duidelijke melding. Je oefent met DevOps-bootcamp door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.
Heb ik ervaring nodig om met DevOps-bootcamp te beginnen?
Ervaring vooraf is niet nodig. DevOps-bootcamp op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 4 van 4.
Hoe lang duurt de les “Aangepaste assertions met de fail-module”?
De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.
Kan ik code schrijven en uitvoeren in deze les over DevOps-bootcamp?
Ja. Elke les over DevOps-bootcamp bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.
Alle lessen in deze cursus
- Taken groeperen met block
- Try / catch met rescue en always
- Fouten beheren: failed_when en ignore_errors
- Aangepaste assertions met de fail-module