Configuración
Los ajustes de ansible.cfg y las variables de entorno que lee Volant, sección por sección, con sus valores por defecto.
Volant lee el mismo ansible.cfg que ansible-playbook y se queda con el primer archivo que encuentra:
- el archivo que nombra
ANSIBLE_CONFIG ./ansible.cfg~/.ansible.cfg/etc/ansible/ansible.cfg
Volant omite ./ansible.cfg cuando otros usuarios pueden escribir en el directorio de trabajo (bit de modo o+w), como hace ansible-playbook. Otro usuario local podría haber puesto allí el archivo. El sticky bit y el propietario del directorio no cambian nada. Volant imprime [WARNING]: Ansible is being run in a world writable directory (...), ignoring it as an ansible.cfg source. en la salida de error y continúa con el archivo siguiente. Un archivo que nombra ANSIBLE_CONFIG se lee sea cual sea el modo del directorio de trabajo.
En cada ajuste, la variable de entorno gana al archivo y la opción de la línea de comandos gana a ambos. Las claves que Volant no usa se ignoran, como Ansible ignora las que no usa.
Un archivo que existe pero no se puede leer se omite, y la ejecución continúa con los valores por defecto. Volant imprime antes un aviso, cosa que Ansible no hace: un archivo que escribiste y que el proceso no puede abrir merece una línea, y un aviso no cambia el código de salida.
[defaults]
Sección titulada «[defaults]»Las fuentes de inventario, como lista separada por comas. Consulta Inventarios.
Segundos que se espera una conexión. Se convierte en ConnectTimeout en la línea de comandos de ssh.
El usuario con el que iniciar sesión. Sin él, ssh elige uno.
La clave privada con la que se autentica ssh.
Activado, una clave de host desconocida hace que el host sea inalcanzable. Desactivado, Volant añade StrictHostKeyChecking=no y UserKnownHostsFile=/dev/null, así que una clave desconocida se acepta y no se registra.
El directorio de cada host que contiene la caché del agente.
En cuántos hosts trabaja un play a la vez. Cero o un valor que no sea un número se rechaza antes de empezar la ejecución. Los playbooks leen el valor actual como ansible_forks.
La estrategia de un play que no nombra ninguna: linear, free, host_pinned o debug, también bajo ansible.builtin.. Cualquier otro nombre muestra el aviso de obsolescencia de ansible-core para los plugins de estrategia fuera de ansible.builtin. Un plugin que hereda de una de estas y no añade nada se ejecuta como esa estrategia, y cualquier otro nombre se rechaza.
El directorio de cada host que contiene los archivos de estado de las tareas asíncronas. ansible_async_dir lo sustituye.
Abre el depurador después de cada tarea fallida o inalcanzable.
Imprime task path: <file>:<line> antes de la línea fatal: de una tarea fallida. Desde -vv la línea ya sigue al banner de cada tarea, así que aquí no cambia nada. La línea failed: del elemento de un bucle y un host inalcanzable no reciben línea de ruta. Como en Ansible, y, yes, on, true, t y 1 lo activan en cualquier caso, y cualquier otra palabra, también una variable vacía, lo deja desactivado.
Colorea la salida aunque no sea un terminal, como necesitan los logs de CI. Gana a nocolor, ANSIBLE_NOCOLOR y NO_COLOR; solo --no-color le gana. En un diff, solo se colorean las líneas que el difflib de Ansible hizo a partir de before y after.
No colorea nunca la salida. force_color le gana.
Qué eventos muestran un traceback, como lista separada por comas. Con error o always, un plugin de acción de Python que falla y reúne errores, como gather_facts con sus módulos de facts, muestra su traceback y los de sus módulos, y lo registra como exception. Cualquier otro fallo conserva (traceback unavailable).
Imprime los avisos [DEPRECATION WARNING] y la línea que explica cómo silenciarlos. Con False no imprime ninguno de los dos.
Una condición cuyo resultado no es un booleano falla por defecto. Con True cuenta el valor de verdad de su resultado y se imprime un [DEPRECATION WARNING].
Un archivo al que se añade cada línea que muestra la ejecución, un registro por mensaje como lo escribe Ansible: 2026-10-30 18:34:18,430 p=<pid> u=<user> n=ansible INFO| TASK [...] ***, WARNING para un [WARNING] y ERROR para un [ERROR].
El número de -v hasta el que una línea va a log_path aunque la ejecución no la muestre.
Avisa cuando el inventario no contiene ningún host y solo queda el localhost implícito. all no incluye ese host.
Un archivo YAML cuyo module_rejectlist nombra los módulos que no se pueden usar, relativo al archivo de configuración. Una tarea que nombra uno detiene el playbook antes de empezar, en esa tarea, con couldn't resolve module/action, como un módulo mal escrito. Solo se rechaza el nombre tal como lo escribe la lista: copy en la lista deja usable ansible.builtin.copy. ansible-core 2.19.12 no lee ninguna variable de entorno para esta opción.
Hace que un rol de roles: o de un import_role que no indica public guarde para sí sus defaults y vars. Con false, un include_role que no indica public también los presta. Sin ajuste, solo un include_role los guarda.
merge coloca un mapping sobre otro del mismo nombre clave por clave, entre dos fuentes de variables cualesquiera y entre dos fuentes de inventario. replace conserva entero el valor de la fuente más alta. La opción está obsoleta en Ansible, que aún la respeta y no muestra ningún aviso.
Ejecuta los handlers notificados incluso en los hosts que fallaron.
Qué recibe una clave YAML escrita dos veces en un mismo mapeo: warn conserva el último valor y muestra dónde está la segunda clave, error rechaza el archivo, ignore conserva el último valor sin decir nada.
Los módulos de facts que ejecuta la recogida de facts de una play, smart (setup) si no se indica otra cosa. También se lee una lista literal en las plays, sus tareas o el inventario (ansible_facts_modules); un módulo que solo nombra una plantilla no se puede ejecutar.
El Python con el que se ejecuta un módulo en un host que no define ansible_python_interpreter; la variable del host prevalece sobre este ajuste. auto y auto_silent buscan el intérprete en el host, y auto_silent omite el aviso que nombra el que encontró. auto_legacy y auto_legacy_silent funcionan como auto y auto_silent y añaden la deprecación de ansible-core. Cualquier otro valor es la ruta del intérprete.
Si from_json rechaza una cadena que contiene un sustituto suelto, como \udc80. Desactivado, el valor lo conserva y se muestra con ? en su lugar, con una advertencia.
Imprime después del recap las estadísticas que recogió set_stats.
El callback que imprime la ejecución. default imprime los banners, una línea por resultado y el recap. minimal imprime cada resultado como lo hace el comando ad hoc, host | CHANGED | rc=0 >> y la salida para un comando, y si no host | SUCCESS => y el resultado en JSON, sin banner, sin recap y sin línea por elemento de bucle. oneline imprime los mismos resultados en una línea cada uno; ansible-core 2.19.12 lo marca como obsoleto y Volant imprime su aviso una vez en la salida de error estándar. tree no imprime nada en la salida estándar. Los nombres con ansible.builtin. también funcionan. yaml detiene la ejecución con código de salida 1 y el error que community.general imprime desde 12.0.0, que eliminó ese plugin: callback_result_format = yaml lo sustituye. json y ansible.posix.json no imprimen nada durante la ejecución y después la ejecución entera como un único documento JSON: cada play y cada tarea con sus tiempos, id y ruta, el resultado de cada host tal como lo devolvió la tarea con su action, el recap por host y los datos de set_stats cuando show_custom_stats está activado. Los caracteres fuera de ASCII se escriben como \uXXXX. Cualquier otro nombre, como community.general.unixy, se carga mediante el ansible-core del controlador; uno que no encuentra detiene la ejecución antes del primer play con [ERROR]: Could not load '<name>' callback plugin. y código de salida 1.
Cómo escriben un resultado default y minimal: json, o yaml, donde el resultado sigue a => en las líneas siguientes, sangrado cuatro espacios, y un texto con saltos de línea es un bloque literal. Cualquier otro valor detiene la ejecución antes del primer play con código de salida 5. oneline escribe siempre JSON.
El pretty_results de default y minimal. Sin definir, un resultado JSON solo se sangra para un debug, un assert y desde -vvv, y un resultado YAML es legible. Activado, cada resultado se sangra cuatro espacios. Desactivado, ninguno, ni siquiera un debug. El YAML legible escribe stdout_lines y stderr_lines como <omitted> junto a su texto, anida con cuatro espacios y quita los espacios y tabuladores finales de un bloque de texto para que siga siendo un bloque; el YAML no legible deja cada valor tal cual y anida con dos. Una palabra que no es booleana cuenta como desactivado.
Espacios por nivel del documento del callback json. Cero o menos lo escribe en una sola línea.
Más callbacks que se ejecutan junto al de stdout, como lista separada por comas. Volant ejecuta junit, que escribe un informe JUnit XML por playbook en JUNIT_OUTPUT_DIR (~/.ansible.log por defecto) y lee las demás variables JUNIT_*, tree, que escribe el último resultado de cada host en un archivo de [callback_tree] directory (ANSIBLE_CALLBACK_TREE_DIR, ~/.ansible/tree por defecto), y, cuando ansible.posix está instalado en el controlador, ansible.posix.timer y ansible.posix.profile_tasks con sus opciones ([callback_profile_tasks], PROFILE_TASKS_*). Cualquier otro nombre se carga mediante el ansible-core del controlador; uno que no encuentra imprime [WARNING]: Skipping callback plugin '<name>', unable to load y la ejecución sigue. volant.compat.record, que graba las ejecuciones de ansible-playbook, se omite sin aviso.
Más directorios donde buscar plugins de callback, separados por :. Un plugin encontrado allí, o en callback_plugins/ junto al playbook, se ejecuta mediante el ansible-core del controlador en un proceso de Python propio. Una ejecución sin tal plugin no inicia Python para esto.
Si el comando ad hoc carga los callbacks anteriores. Desactivado, imprime con minimal, o con oneline si se pasa -o, diga lo que diga stdout_callback. Consulta el comando ad hoc.
Un archivo que contiene la contraseña de vault, o un ejecutable que la imprime. La variable de entorno sustituye el valor del archivo, y la línea de comandos se suma al que haya ganado. Consulta Vault.
Identidades de vault separadas por comas, cada una escrita como label@source, donde la fuente es un archivo, un ejecutable o prompt. La variable de entorno sustituye la lista del archivo, y la línea de comandos se suma a la que haya ganado.
El id de vault que usa volant vault encrypt cuando no se da --encrypt-vault-id. Consulta Vault.
El editor que ejecutan volant vault create y edit. Gana la última variable definida, luego el archivo, luego vi. Consulta Vault.
Dónde guardan volant vault create y edit la copia privada sobre la que trabaja el editor.
El programa por el que volant vault view pasa la salida en un terminal. Gana la última variable definida, luego el archivo.
Dónde se buscan los roles, después de <playbook_dir>/roles y antes del propio <playbook_dir>. Consulta Roles.
También se lee como collections_paths, y de ANSIBLE_COLLECTIONS_PATHS, que gana a ANSIBLE_COLLECTIONS_PATH. Dónde se busca un nombre de rol de tres partes como acme.demo.hello. El ansible-core del controlador encuentra los módulos de una colección en las rutas con las que está configurado: consulta Módulos de colecciones.
implicit, explicit o smart. Consulta La caché de facts.
memory guarda los facts durante la ejecución, jsonfile los guarda entre ejecuciones y cualquier otro nombre es un plugin de Python. Consulta La caché de facts.
El directorio de la caché jsonfile.
Segundos que una entrada en caché sigue vigente. 0 no caduca nunca.
Se antepone al nombre de cada archivo de caché.
[inventory]
Sección titulada «[inventory]»Los plugins de inventario que se prueban, en orden. Consulta la cadena de plugins.
Extensiones de archivo que se omiten al leer un directorio. Un valor sustituye la lista por defecto. [defaults] inventory_ignore_extensions también se lee.
Expresiones regulares de nombres de archivo que se omiten al leer un directorio. [defaults] inventory_ignore_patterns también se lee.
Hace fallar la ejecución cuando no se pudo leer ninguna fuente.
Hace fallar la ejecución en la primera fuente que ningún plugin pudo leer.
Hace que volant inventory mantenga cada variable donde se define, como hace --export. --export lo activa para una ejecución; nada lo desactiva desde la línea de comandos, como en ansible-inventory. Consulta el comando inventory.
[inventory_plugin_script]
Sección titulada «[inventory_plugin_script]»Muestra como línea [ERROR]: lo que un script de inventario que terminó bien escribió en la salida de error. Con false, solo se muestra la salida de error de un script que falla.
[privilege_escalation]
Sección titulada «[privilege_escalation]»Escala privilegios por defecto. Las palabras clave del playbook y las variables de host tienen prioridad, consulta Escalado de privilegios.
El usuario al que se escala.
El método de escalado: sudo o su. Otros métodos detienen la ejecución antes de empezar.
El programa que se ejecuta en lugar de sudo o su.
Las opciones que se pasan a ese programa, en lugar de -H para sudo y de ninguna para su. Un valor en blanco no da ninguna opción.
[ssh_connection]
Sección titulada «[ssh_connection]»Da un terminal a raw, a script y a los comandos que envía sin entrada un plugin de módulo como reboot, como hace ssh -tt. Ponlo en False cuando una regla de sudoers tiene requiretty o un comando imprime caracteres de control en un terminal. La variable de host ansible_ssh_use_tty gana a la variable de entorno, y la variable de entorno al archivo. Una palabra que no sea y, yes, on, true, t ni 1 se lee como desactivado.
Etiquetas seleccionadas por defecto. --tags se suma a esta lista en lugar de sustituirla.
Etiquetas omitidas por defecto. --skip-tags se suma a esta lista.
[volant]
Sección titulada «[volant]»Ansible ignora esta sección, así que un mismo ansible.cfg puede llevarla y seguir sirviendo a ambos motores. ansible-config validate es la excepción, consulta Procesamiento por lotes entre hosts.
Desactivado por defecto. Con batching = true, un host pasa a sus tareas siguientes sin esperar a los demás hosts, salvo delante de una tarea cuyo texto lee otro host (hostvars, ansible_play_hosts, delegate_to, una plantilla o una variable que lo hace). No se espera por una dependencia que el playbook no expresa, como un servicio que otro host todavía está instalando o un archivo en un host nombrado de forma literal. Actívalo solo en plays cuyos hosts no dependan unos de otros de ese modo. Consulta Procesamiento por lotes entre hosts.
Deja que el agente responda a una tarea con su versión nativa del módulo, cuando los argumentos de la tarea se quedan dentro de lo que esa versión implementa. Con false, todas las tareas van al módulo de Python de ansible-core, y también setup, que es la forma de comparar los dos caminos en una ejecución real. El valor se lee como ansible-core lee un booleano, y una palabra que no conoce detiene la ejecución con código de salida 5. Consulta Módulos nativos.
De dónde sale el Python del controlador. auto usa VOLANT_PYTHON, después el runtime administrado si está instalado, después el entorno virtual activo y python3, e instala el runtime administrado cuando ninguno funciona. managed usa solo VOLANT_PYTHON o el runtime administrado, y lo instala cuando falta. system nunca usa ni instala el runtime administrado. Cualquier otra palabra detiene la ejecución con código de salida 5. Consulta El runtime administrado.
Comparte una única conexión OpenSSH entre todas las ejecuciones de ssh de un host del inventario. Con false, cada enlace y cada sonda abre su propia conexión. Consulta Una conexión por host.
Cuántas reproducciones limpias seguidas espera volant shadow status de un playbook antes de declararlo ready. Un número entero de al menos 1; cualquier otro valor detiene la ejecución con el código de salida 5. Ver Cambiar sin riesgo.
La parte de las tareas de un playbook que esas reproducciones deben haber comparado, de 0 a 1, antes de que volant shadow status lo declare ready. Cualquier otro valor detiene la ejecución con el código de salida 5.
Rechaza con la salida 4 una ejecución que difiere de volant.lock, como --locked. Desactivado, una diferencia es un aviso y la ejecución sigue. Ansible ignora el ajuste junto con el resto de [volant].
Define qué hacen template, copy, script, unarchive y assemble con un src del controlador que nombró un host administrado, y dónde puede escribir un fetch un dest que nombró un host: allow, contained o refuse. El valor por defecto es allow, que se comporta como ansible-core, y cualquier otra palabra detiene la ejecución con código de salida 5. Consulta Un archivo de origen que nombró un host administrado para saber qué hace cada palabra.
Una lista, separada por dos puntos, de directorios absolutos del controlador bajo los que fetch puede escribir un dest que nombró un host administrado. Una entrada relativa, que use ~ o .., o que sea / detiene la ejecución con código de salida 5. Consulta Un dest que nombró un host administrado para ver las reglas.