Admitir el modo de comprobación en su módulo
Haga que el código personalizado sea seguro en simulaciones
Admitir el modo de comprobación en su módulo es una lección gratuita de DevOps Bootcamp en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de DevOps Bootcamp, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de DevOps Bootcamp incluye 4 lecciones en total.
Qué es el modo de comprobación
Con el modo de comprobación, los usuarios ejecutan un playbook con --check para previsualizar los cambios. En realidad no se modifica nada en el host.
ansible-playbook site.yml --checkSu módulo debe activarlo explícitamente
El modo de comprobación no es automático. Debe declarar que lo admite para que Ansible sepa que su módulo se compromete a no realizar ningún cambio en este modo.
Declárelo en AnsibleModule
Establezca supports_check_mode=True al construir el módulo. Esta opción indica a Ansible que su código respeta las solicitudes de ejecución en seco.
module = AnsibleModule(
argument_spec=spec,
supports_check_mode=True)Lea module.check_mode
Durante la ejecución, compruebe module.check_mode. Su valor es True cuando el usuario ha pasado --check, y debe usarlo para elegir la lógica que corresponda.
if module.check_mode:
module.exit_json(changed=True)Calcule, no aplique
En el modo de comprobación, siga calculando si es necesario realizar un cambio. Simplemente deténgase antes de escribir nada en el sistema.
Informe del cambio que se realizaría
Salga pronto con el valor correcto de changed para que la previsualización de la ejecución en seco sea honesta, aunque no haya ocurrido nada.
if module.check_mode:
module.exit_json(changed=needs_change)Las lecturas siempre son seguras
Recopilar el estado actual es correcto en el modo de comprobación, ya que leer no modifica nada. Solo debe omitirse el paso de escritura.
Olvidarlo es peligroso
Si no admite el modo de comprobación, su módulo podría seguir modificando el host durante una ejecución en seco. Eso traiciona las expectativas del usuario.
Refleje la lógica de la ejecución real
La detección de cambios en el modo de comprobación debe coincidir exactamente con la de una ejecución normal. Una previsualización incorrecta es peor que no tener ninguna.
Pruebe ambas rutas
Ejecute su módulo con --check y sin él. Confirme que la ejecución en seco informa del mismo resultado de changed, pero deja el sistema intacto.
El modo de comprobación genera confianza
Un módulo que respeta el modo de comprobación permite a los equipos previsualizar los cambios de forma segura antes de aplicarlos. Ese nivel de acabado distingue los módulos de prueba de los módulos preparados para producción.
Comprobación rápida
Recuerde las dos cosas que el modo de comprobación requiere de su módulo.
Resumen
Pase supports_check_mode=True, use module.check_mode para elegir la lógica, calcule el cambio pero omita la escritura e informe changed con honestidad. Ahora su módulo es seguro para ejecuciones en seco. 🔍
Preguntas frecuentes
¿La lección «Admitir el modo de comprobación en su módulo» es gratis?
Sí — el texto completo de «Admitir el modo de comprobación en su módulo» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de DevOps Bootcamp, actualiza a CoddyKit PRO. El curso de DevOps Bootcamp incluye 4 lecciones en total.
¿Qué aprenderé en «Admitir el modo de comprobación en su módulo»?
Haga que el código personalizado sea seguro en simulaciones Practicas DevOps Bootcamp con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar DevOps Bootcamp?
No se requiere experiencia previa. DevOps Bootcamp en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Admitir el modo de comprobación en su módulo»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de DevOps Bootcamp?
Sí. Cada lección de DevOps Bootcamp incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Cuándo crear un módulo personalizado
- AnsibleModule y especificación de argumentos
- Devolver JSON y respetar changed
- Admitir el modo de comprobación en su módulo