Por Qué Fallan los Playbooks de Ansible
Ansible es la herramienta estándar de la industria para automatización de infraestructura. Es sin agente (usa SSH), usa YAML y es poderosa, pero los errores pueden ser crípticos.
Errores Comunes y Soluciones
1. Fallos de Conexión SSH
Error: UNREACHABLE! => Failed to connect to the host via ssh
- Pruebe manualmente:
ssh -i ~/.ssh/clave usuario@ip_destino - Verifique inventario:
ansible_host,ansible_user,ansible_ssh_private_key_file - Revise el firewall (puerto 22)
2. Fallos de Escalación de Privilegios (become)
Error: Missing sudo password
Configure sudo sin contraseña o use --ask-become-pass.
3. Errores de Variable Indefinida
Use - debug: var=mi_variable para inspeccionar valores y {{ mi_var | default('valor') }} para proporcionar valores por defecto.
4. Problemas de Idempotencia
Reemplace command/shell por módulos nativos como file, copy, template.
5. Módulo o Colección No Encontrada
ansible-galaxy collection install community.general
Resumen Rápido
| Error | Qué Verificar Primero |
|---|---|
| Conexión SSH | Pruebe ssh manualmente |
| Sudo password | Configure sudo sin contraseña |
| Variable indefinida | Agregue debug: var=mi_var |
| Falla en re-ejecución | Use módulos nativos, no command |
| Módulo no encontrado | Instale la Collection vía ansible-galaxy |