Prendre en charge le mode de vérification dans votre module
Rendez votre code personnalisé sûr en simulation.
Prendre en charge le mode de vérification dans votre module est une leçon Ansible Academy 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 Ansible Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Ansible Academy comprend 4 leçons au total.
Qu'est-ce que le mode de vérification
Avec le mode de vérification, les utilisateurs exécutent un playbook avec --check pour prévisualiser les modifications. Rien n'est réellement modifié sur l'hôte.
ansible-playbook site.yml --checkVotre module doit l'activer
Le mode de vérification n'est pas automatique. Vous devez déclarer sa prise en charge afin qu'Ansible sache que votre module s'engage à n'effectuer aucune modification dans ce mode.
Le déclarer dans AnsibleModule
Définissez supports_check_mode=True lors de la construction du module. Cet indicateur indique à Ansible que votre code respecte les demandes d'exécution à blanc.
module = AnsibleModule(
argument_spec=spec,
supports_check_mode=True)Lire module.check_mode
Au moment de l'exécution, examinez module.check_mode. Sa valeur est True lorsque l'utilisateur a fourni --check, et vous devez adapter votre logique en conséquence.
if module.check_mode:
module.exit_json(changed=True)Calculer sans appliquer
En mode de vérification, vous devez tout de même calculer si une modification est nécessaire. Vous vous arrêtez simplement avant toute écriture dans le système.
Signaler la modification prévue
Terminez rapidement avec la bonne valeur de changed afin que l'aperçu de l'exécution à blanc soit honnête, même si rien ne s'est produit.
if module.check_mode:
module.exit_json(changed=needs_change)Les lectures sont toujours sans danger
Recueillir l'état actuel ne pose aucun problème en mode de vérification, puisque la lecture ne modifie rien. Seule l'étape d'écriture doit être ignorée.
L'oublier est dangereux
Si vous ne prenez pas en charge le mode de vérification, votre module peut encore modifier l'hôte pendant une exécution à blanc. Cela trahit les attentes de l'utilisateur.
Reproduire la logique d'une exécution réelle
La détection des modifications en mode de vérification doit correspondre exactement à celle d'une exécution normale. Un aperçu erroné est pire que l'absence totale d'aperçu.
Vérifier les deux chemins
Exécutez votre module avec et sans --check. Vérifiez que l'exécution à blanc signale la même valeur de changed tout en laissant le système intact.
Le mode de vérification inspire confiance
Un module qui respecte le mode de vérification permet aux équipes de prévisualiser les modifications en toute sécurité avant de les appliquer. Ce soin distingue les modules jouets des modules prêts pour la production.
Vérification rapide
Rappelez-vous les deux exigences auxquelles votre module doit répondre pour prendre en charge le mode de vérification.
Récapitulatif
Transmettez supports_check_mode=True, adaptez la logique selon module.check_mode, calculez la modification mais ignorez l'écriture, et indiquez honnêtement changed. Votre module peut maintenant être exécuté à blanc en toute sécurité. 🔍
Questions Fréquemment Posées
La leçon « Prendre en charge le mode de vérification dans votre module » est-elle gratuite ?
Oui — le texte complet de « Prendre en charge le mode de vérification dans votre module » 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 Ansible Academy, passe à CoddyKit PRO. Le cours Ansible Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Prendre en charge le mode de vérification dans votre module » ?
Rendez votre code personnalisé sûr en simulation. Tu pratiques Ansible Academy 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 Ansible Academy ?
Aucune expérience préalable n'est requise. Ansible Academy 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 « Prendre en charge le mode de vérification dans votre module » ?
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 Ansible Academy ?
Oui. Chaque leçon Ansible Academy 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
- Quand créer un module personnalisé
- AnsibleModule et spécification des arguments
- Renvoyer du JSON et respecter changed
- Prendre en charge le mode de vérification dans votre module