Ir al contenido
Instalar

¿Se ejecutará mi playbook?

Comprueba un proyecto de Ansible existente contra esta versión en unos segundos, sin tocar ningún host.

Para saber si un playbook se ejecuta, lanza volant check . en la raíz del repositorio y después ejecuta el playbook en un host. Volant lee toda la gramática de ansible-core 2.19, así que tu playbook se interpreta aquí igual que con Ansible. Antes de conectarse a nada, una segunda comprobación, la comprobación previa, busca lo que esta versión aún no admite y detiene la ejecución con un mensaje que lo nombra. Las carencias conocidas de más abajo son las excepciones: ahí una ejecución puede ignorar un ajuste o dar un resultado incorrecto sin ningún error.

  1. Comprueba todos los playbooks a la vez, sin contactar con ningún host:

    Ventana de terminal
    volant check .

    Cada playbook recibe un veredicto: ready, refused con el motivo, el archivo y la línea, o unknown cuando solo una ejecución puede saberlo. No es volant playbook --check, que ejecuta el playbook en modo de comprobación contra los hosts. Consulta volant check.

  2. Léelo sin ejecutarlo. Los listados y --syntax-check nunca se detienen ante un módulo o una palabra clave no admitidos, así que funcionan incluso con un playbook que esta versión todavía no puede ejecutar:

    Ventana de terminal
    volant playbook -i inventory.ini site.yml --syntax-check
    volant playbook -i inventory.ini site.yml --list-tasks

    Si la lista de tareas coincide con lo que imprime ansible-playbook --list-tasks, Volant ha compilado tus roles, imports y etiquetas del mismo modo.

  3. Pide una ejecución real contra un host que puedas permitirte tocar. --check --diff deja el host como está, salvo por el agente en caché, así que es una primera ejecución segura:

    Ventana de terminal
    volant playbook -i inventory.ini site.yml --limit test1 --check --diff
    volant playbook -i inventory.ini site.yml --limit test1

    Casi todo lo que esta versión no puede ejecutar detiene la ejecución antes de conectarse. El mensaje nombra el módulo, la palabra clave o el valor, y la ejecución termina con el código 4. Qué rechaza hoy enumera los mensajes.

  4. Corrige o espera. Lo que todavía no se admite está en Palabras clave, Módulos y las carencias conocidas de más abajo, y casi todo tiene una alternativa.

Pregunta Respuesta
¿Funciona community.general? Sí, una vez instalada. Volant no instala una colección durante una ejecución, así que ejecuta antes volant runtime install --collections community.general. Un plugin que necesite un paquete de Python que el runtime administrado no incluye, como el filtro json_query con jmespath, falla. Para esos casos usa tu propio Python con VOLANT_PYTHON. Consulta El runtime administrado.
¿Funciona copy? Sí. El controlador lee el archivo, o toma content:, y lo envía al host. También funciona un directorio como src. Consulta Módulos.
¿Funciona async? Sí: async, poll y poll: 0 con async_status. Un módulo que ansible-core no puede ejecutar bajo async falla en cada host con This action (<name>) does not support async. Consulta Ejecución de plays.
¿Funciona --diff? Sí, con --check o solo. Un host necesita Python para apt, user, group, file, lineinfile y systemd cuando una ejecución pide una comprobación o un diff. Consulta Modo check, diff y listados.
¿Funcionan become, vault y ansible.cfg? become mediante sudo o su, vault y ansible.cfg funcionan. doas y otros métodos no. Consulta Conexiones y become.
¿Funcionan mis propios plugins? En parte. Los plugins de acción, de conexión, de inventario, de callback, de caché y de vars junto al playbook o en un rol se ejecutan mediante ansible-core. Consulta las carencias conocidas.
Área Se ejecuta hoy Todavía no
Plays pre_tasks, roles, tasks, post_tasks, handlers, serial, strategy (linear, free, host_pinned, debug), order, throttle, timeout, debugger, any_errors_fatal, max_fail_percentage, ignore_errors, ignore_unreachable
Tareas when, loop, todas las formas with_<lookup>, register, until, retries, changed_when, failed_when, ignore_errors, ignore_unreachable, any_errors_fatal, no_log, environment, timeout, tags, async, poll, module_defaults
Bloques block, rescue, always
Reutilización roles y dependencias, import_tasks, import_role, import_playbook, include_tasks, include_role, include_vars
Delegación delegate_to, delegate_facts, local_action, run_once
Módulos los módulos de ansible-core para hosts Linux, incluidos copy, template, dnf, service, uri y reboot, y los módulos de las colecciones instaladas con sus plugins de acción, y los plugins de acción de un action_plugins/ junto al playbook o en un rol un plugin de acción de una colección que necesite Windows
Inventarios archivos INI, YAML y TOML, directorios, scripts, plugins constructed, generator y de colecciones, varios -i, group_vars, host_vars, la caché de facts jsonfile ninguno
Conexiones ssh con claves, un ssh-agent o una contraseña (-k o ansible_password, requiere OpenSSH 8.4 o posterior), local, y network_cli, netconf y httpapi para dispositivos de red otros plugins de conexión, Windows
Escalado de privilegios become mediante sudo o su, con o sin contraseña doas y otros métodos
Plantillas Jinja2 con los filtros, tests y lookups de Ansible, !unsafe, filtros y lookups de colecciones algunos argumentos de filtros, enumerados en Plantillas
Modos de ejecución ejecuciones normales, --check y --diff, vault, --start-at-task, --step, los cuatro comandos de listado ninguno
Todavía no se admite Por qué Qué puedes hacer hoy
Una colección que no está instalada Volant no instala ninguna durante una ejecución. Pregunta al ansible-core del controlador qué hay instalado, antes de la primera conexión. Ejecuta volant runtime install --collections NAME, el comando que nombra el error. Consulta El runtime administrado y Módulos de colecciones.
Ningún Python con ansible-core en el controlador Volant instala el suyo la primera vez que lo necesita, con curl o wget y tar. Nada, o volant runtime install por adelantado. Sin red, usa volant runtime pack e install --from.
apt, user, group o file con --check o --diff en un host sin Python Estos módulos responden mediante Python en el host cuando la ejecución pide una comprobación o un diff. Instala Python en el host, o ejecuta el play sin --check ni --diff.
!!binary, un ancla duplicada, o una fecha o un conjunto como valor tipado Volant no tiene tipo para bytes, fechas ni conjuntos. Una fecha se carga como su texto ISO, y un !!set, !!omap o !!pairs como el mapa o la lista con que se escribe. !!binary detiene la carga, y un segundo &anchor con el mismo nombre se acepta. Escribe el valor como cadena, lista o mapa simples, y da a cada ancla su propio nombre.
Aritmética con un entero de más de 128 bits Los operadores +, -, *, /, //, % y ** y los filtros abs y round rechazan un operando tan ancho. Consulta Plantillas. Haz la aritmética en un módulo o en command con python3 -c, y conserva el valor ancho como texto.

La comprobación previa detiene la ejecución antes de la primera conexión, antes de cualquier banner y antes de cualquier recap. Sin ella, una palabra clave que se colara se ignoraría en silencio, y la ejecución daría por buena una orden que se saltó. La comprobación previa describe cómo funciona.

Qué Forma del mensaje Código de salida
Una strategy distinta de linear, free, host_pinned y debug, del play o de ANSIBLE_STRATEGY, salvo que su plugin herede de una de ellas sin añadir nada el aviso de obsolescencia de ansible-core para los plugins de estrategia fuera de ansible.builtin, y después strategy 'x' is not supported yet 4
until, retries o delay en include_tasks o include_role keyword 'until' is not supported yet on 'include_tasks' 4
Un pause con prompt y con seconds o minutes, cuando la entrada estándar es un terminal pause cannot wait for a prompt and a duration together on a terminal ... 4
Un argumento de módulo que tiene ansible-core y que esta versión no aplica argument 'x' is not supported yet on 'module', con with 'v' cuando solo se rechaza ese valor 4
end_role fuera de un rol Cannot execute 'end_role' from outside of a role 4
Un módulo integrado que esta versión no incluye module 'x' is not available in this release 4
Un módulo o una colección que no se resuelve, escrito como clave de la tarea (nombrado en action: o local_action:, hace fallar la tarea cuando se ejecuta, con Cannot resolve 'x' to an action or module.) couldn't resolve module/action 'x' ..., con el comando de instalación si falta una colección 4
Un módulo de colección que necesita un plugin de acción para Windows module 'x' needs an action plugin from its collection, which this release does not run 4
Un become_method distinto de sudo y su become_method 'x' is not supported yet 2
Un rol en roles: o import_role que nadie encuentra the role 'x' was not found in ... 1

El rechazo de pause solo se aplica a un paso que se ejecuta siempre. Un when, un loop o un rescue a su alrededor dejan la comprobación para el momento en que se llega al pause. Una ejecución que detiene la comprobación termina con el código 4, el que usa Ansible para un playbook que no puede cargar. Códigos de salida enumera todos los códigos.

Estas diferencias con ansible-playbook aparecen sin ningún mensaje antes de la ejecución, o con un mensaje que nombra otra cosa. Cada fila dice qué ocurre.

Qué Qué ocurre
Una tarea con no_log: true que falla Es a propósito. Volant imprime [ERROR]: Task failed: Action failed: <error censored due to no log> y nada más sobre la causa. ansible-core 2.19.12 imprime la causa: [ERROR]: Task failed: Action failed: <the msg of fail or assert>, el error del módulo y los bloques <<< caused by >>>. Ese texto puede contener un secreto, como el msg de un fail que nombra una contraseña. La política de seguridad considera una vulnerabilidad que un secreto llegue a un log o a un terminal donde no_log lo oculta en ansible-core, así que Volant lo oculta. La línea fatal:, el resultado registrado y el recap son iguales en ambos. Para leer la causa, ejecuta la tarea sin no_log.
SIGTERM Es a propósito. Volant se detiene limpiamente: cancela las tareas en curso, elimina el directorio que guarda la contraseña de conexión, imprime el recap y termina con el código 99, igual que con Ctrl-C. ansible-playbook no captura SIGTERM. Muere de inmediato con el código 143 y no imprime recap. Medido con kill -TERM durante un command: sleep: 99 con Volant, 143 con ansible-core 2.19.12.
_ansible_ansiballz_pydevd_config Es a propósito. Se ignora. ansible-core reserva este ajuste para su propio uso: conecta un depurador al wrapper de módulos. Volant ejecuta los módulos de Python con su propio ejecutor, y sus módulos nativos sin Python.

Plantillas enumera los filtros y argumentos que fallan. La página de paridad marca un filtro como partial cuando falla uno de sus argumentos.

Si un playbook se comporta de forma distinta con Volant y con ansible-playbook sin que se indique que no está admitido, es un error. Abre un informe de compatibilidad con un playbook mínimo.

Cuando necesites saber algo sobre una palabra clave, un módulo, un filtro o una opción, abre su página de referencia:

  • Palabras clave enumera todas las palabras clave de plays, bloques, tareas y bucles y qué hace Volant con cada una.
  • Módulos enumera los módulos que se ejecutan en el agente, en el controlador y mediante Python, con los argumentos que admite cada uno.
  • Línea de comandos enumera todas las opciones de volant playbook y volant runtime.
  • Paridad es la matriz completa: cada palabra clave, opción y plugin de ansible-core 2.19.12, y cada módulo, filtro, test y lookup de las colecciones del paquete ansible 12.3.0, con un estado runs, partial, not yet o later.