Ir al contenido
Instalar

Códigos de salida

Qué significa cada código de salida y dónde coincide Volant con ansible-playbook.

Volant sale con los códigos que usa ansible-playbook, así que los scripts y los trabajos de CI escritos para Ansible siguen funcionando.

Todos los hosts terminaron sin ningún fallo.

Un error general: un playbook o un rol que no se encuentra, un nombre de notify o una acción de meta desconocidos, o un patrón de hosts que no deja ningún host.

Falló al menos un host, o la ejecución pidió un método de escalado que esta versión todavía no admite.

Al menos un host fue inalcanzable, hayan fallado otros o no, como lo informa ansible-playbook, o el playbook se detuvo antes de la ejecución: no se interpreta, o usa algo que esta versión todavía no admite.

Un ajuste tiene un valor que no puede tomar, como forks = many, una palabra desconocida para gathering, runtime o host_named_paths, o una palabra clave order que el play no conoce. El mensaje nombra la clave y el valor.

Ctrl-C o SIGTERM detuvieron la ejecución. Los lotes en curso se cancelan, se imprime el recap y Volant sale con 99, como hace ansible-playbook.

--step no encontró ningún terminal en la entrada estándar. Volant se detiene antes de tocar ningún host.

Después de una ejecución, el código sale del recap: se suma 2 cuando algún host falló y 4 cuando algún host fue inalcanzable. Un play con serial se detiene en el primer lote que perdió todos los hosts vivos, con 2 si fallaron y con 4 si todos pasaron a ser inalcanzables.

Un playbook detenido por la comprobación previa sale con 4 antes de cualquier conexión, que es lo que usa Ansible para un playbook que no puede cargar. Los casos cuyo código se midió en Ansible conservan ese código: 1 para un rol que falta, una acción de meta desconocida o un nombre de notify desconocido. Un nombre de notify desconocido en un archivo que trae un include dinámico solo se descubre durante la ejecución, y la termina allí también con 1.

En unos pocos casos ansible-core falla con código de salida 250, por ejemplo con un playbook que se importa a sí mismo o con serial: abc. Volant rechaza esos casos en su lugar, con un mensaje claro y uno de los códigos anteriores. Cada caso figura en Diferencias con Ansible de la página que lo trata.

volant adhoc (ansible) sale con 0 cuando todos los hosts tuvieron éxito o se omitieron, 2 cuando un host falló, 4 cuando un host era inalcanzable, 1 cuando -l no deja ningún host, y 5 para un ajuste no válido. volant vault (ansible-vault) y volant inventory (ansible-inventory) salen con 0 si todo va bien, 1 ante un error como create sobre un archivo que existe, y 5 ante una opción o acción incorrecta. Un error de uso de cualquiera de ellos sale con 2. Nombres de comandos de ansible tiene la tabla.