Assertions personnalisées avec le module fail
Arrêtez un play avec un message explicite.
Assertions personnalisées avec le module fail est une leçon DevOps Bootcamp gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage DevOps Bootcamp, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours DevOps Bootcamp comprend 4 leçons au total.
Arrêtez-vous avec un message clair
Parfois, vous souhaitez arrêter volontairement une exécution en donnant une raison utile. Le module fail fait exactement cela. 🛑
Le module fail
ansible.builtin.fail arrête l’hôte actuel avec un message personnalisé que vous rédigez, plutôt qu’avec une erreur obscure.
- name: Refuse unsupported OS
ansible.builtin.fail:
msg: "This playbook supports Ubuntu only"Contrôlez fail avec when
Un fail seul arrête toujours l’exécution : associez-le donc à when. L’exécution échoue uniquement si votre condition de garde est satisfaite.
- ansible.builtin.fail:
msg: "app_version is required"
when: app_version is not definedÉchouez vite et tôt
Placez les vérifications de garde au début d’une exécution. Détecter une entrée incorrecte tôt vaut mieux qu’échouer au milieu d’un déploiement.
Le module assert
ansible.builtin.assert est plus propre pour la validation : donnez-lui des conditions dans that, et il échoue si l’une d’elles est fausse.
- ansible.builtin.assert:
that:
- app_port is defined
- app_port | int > 1024Messages assert personnalisés
Ajoutez fail_msg et success_msg à assert pour obtenir une sortie conviviale dans les deux cas. Vous disposez ainsi d’un retour clair à chaque exécution.
- ansible.builtin.assert:
that: disk_free > 500
fail_msg: "Need at least 500MB free"
success_msg: "Disk space OK"assert vérifie plusieurs éléments à la fois
assert reçoit une liste dans that. Chaque condition doit être vraie ; la première condition fausse fait échouer la tâche avec votre message.
fail contre assert
Utilisez fail pour un arrêt volontaire unique, avec la logique dans when ; utilisez assert pour valider brièvement un ensemble de conditions.
Interpoler des valeurs
Votre msg peut inclure des variables pour fournir du contexte. Affichez la valeur incorrecte afin que l’opérateur sache exactement quoi corriger.
- ansible.builtin.fail:
msg: "Port {{ app_port }} is out of range"Les assertions comme documentation
De bonnes assertions servent aussi de documentation vivante : elles énoncent les attentes d’un playbook et les font respecter au même endroit. 📝
Le mode quiet pour assert
Définissez quiet à true sur assert pour ignorer la sortie de chaque condition. C’est pratique lorsque seuls les échecs vous intéressent, et non les vérifications réussies.
- ansible.builtin.assert:
that: app_port is defined
quiet: trueVérification rapide
Choisissons le bon outil.
Récapitulatif
Le module fail arrête une exécution avec un message clair, tandis qu’assert valide proprement les conditions. Protégez vos playbooks de manière proactive. ✅
Questions Fréquemment Posées
La leçon « Assertions personnalisées avec le module fail » est-elle gratuite ?
Oui — le texte complet de « Assertions personnalisées avec le module fail » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours DevOps Bootcamp, passe à CoddyKit PRO. Le cours DevOps Bootcamp comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Assertions personnalisées avec le module fail » ?
Arrêtez un play avec un message explicite. Tu pratiques DevOps Bootcamp avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer DevOps Bootcamp ?
Aucune expérience préalable n'est requise. DevOps Bootcamp sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Assertions personnalisées avec le module fail » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon DevOps Bootcamp ?
Oui. Chaque leçon DevOps Bootcamp inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Regrouper les tâches avec block
- Try / catch avec rescue et always
- Contrôler les échecs : failed_when et ignore_errors
- Assertions personnalisées avec le module fail