Ir al contenido
Instalar

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:

  1. el archivo que nombra ANSIBLE_CONFIG
  2. ./ansible.cfg
  3. ~/.ansible.cfg
  4. /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.

Las fuentes de inventario, como lista separada por comas. Consulta Inventarios.

Option
-i
Environment
ANSIBLE_INVENTORY

Segundos que se espera una conexión. Se convierte en ConnectTimeout en la línea de comandos de ssh.

Default
10
Option
-T
Environment
ANSIBLE_TIMEOUT

El usuario con el que iniciar sesión. Sin él, ssh elige uno.

Option
-u
Environment
ANSIBLE_REMOTE_USER

La clave privada con la que se autentica ssh.

Option
--private-key
Environment
ANSIBLE_PRIVATE_KEY_FILE

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.

Default
true
Environment
ANSIBLE_HOST_KEY_CHECKING

El directorio de cada host que contiene la caché del agente.

Default
~/.ansible/tmp
Environment
ANSIBLE_REMOTE_TMP

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.

Default
5
Option
-f
Environment
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.

Default
linear
Environment
ANSIBLE_STRATEGY

El directorio de cada host que contiene los archivos de estado de las tareas asíncronas. ansible_async_dir lo sustituye.

Default
~/.ansible_async
Environment
ANSIBLE_ASYNC_DIR

Abre el depurador después de cada tarea fallida o inalcanzable.

Default
false
Environment
ANSIBLE_ENABLE_TASK_DEBUGGER

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.

Default
false
Environment
ANSIBLE_SHOW_TASK_PATH_ON_FAILURE

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.

Default
false
Environment
ANSIBLE_FORCE_COLOR

No colorea nunca la salida. force_color le gana.

Default
false
Environment
ANSIBLE_NOCOLOR

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).

Default
never
Environment
ANSIBLE_DISPLAY_TRACEBACK

Imprime los avisos [DEPRECATION WARNING] y la línea que explica cómo silenciarlos. Con False no imprime ninguno de los dos.

Default
true
Environment
ANSIBLE_DEPRECATION_WARNINGS

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].

Default
false
Environment
ANSIBLE_ALLOW_BROKEN_CONDITIONALS

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].

Default
unset
Environment
ANSIBLE_LOG_PATH

El número de -v hasta el que una línea va a log_path aunque la ejecución no la muestre.

Default
0
Environment
ANSIBLE_LOG_VERBOSITY

Avisa cuando el inventario no contiene ningún host y solo queda el localhost implícito. all no incluye ese host.

Default
true
Environment
ANSIBLE_LOCALHOST_WARNING

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.

Default
unset

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.

Default
unset
Environment
ANSIBLE_PRIVATE_ROLE_VARS

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.

Default
replace
Environment
ANSIBLE_HASH_BEHAVIOUR

Ejecuta los handlers notificados incluso en los hosts que fallaron.

Default
false
Option
--force-handlers
Environment
ANSIBLE_FORCE_HANDLERS

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.

Default
warn
Environment
ANSIBLE_DUPLICATE_YAML_DICT_KEY

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.

Default
smart
Environment
ANSIBLE_FACTS_MODULES

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.

Default
auto
Environment
ANSIBLE_PYTHON_INTERPRETER

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.

Default
true
Environment
ANSIBLE_MODULE_STRICT_UTF8_RESPONSE

Imprime después del recap las estadísticas que recogió set_stats.

Default
false
Environment
ANSIBLE_SHOW_CUSTOM_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.

Default
default
Environment
ANSIBLE_STDOUT_CALLBACK

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.

Default
json
Environment
ANSIBLE_CALLBACK_RESULT_FORMAT

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.

Environment
ANSIBLE_CALLBACK_FORMAT_PRETTY

Espacios por nivel del documento del callback json. Cero o menos lo escribe en una sola línea.

Default
4
Environment
ANSIBLE_JSON_INDENT

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.

Environment
ANSIBLE_CALLBACKS_ENABLED

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.

Environment
ANSIBLE_CALLBACK_PLUGINS

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.

Default
false
Environment
ANSIBLE_LOAD_CALLBACK_PLUGINS

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.

Option
--vault-password-file
Environment
ANSIBLE_VAULT_PASSWORD_FILE

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.

Option
--vault-id
Environment
ANSIBLE_VAULT_IDENTITY_LIST

El id de vault que usa volant vault encrypt cuando no se da --encrypt-vault-id. Consulta Vault.

Option
--encrypt-vault-id
Environment
ANSIBLE_VAULT_ENCRYPT_IDENTITY

El editor que ejecutan volant vault create y edit. Gana la última variable definida, luego el archivo, luego vi. Consulta Vault.

Environment
ANSIBLE_EDITOR, EDITOR

Dónde guardan volant vault create y edit la copia privada sobre la que trabaja el editor.

Default
~/.ansible/tmp
Environment
ANSIBLE_LOCAL_TEMP

El programa por el que volant vault view pasa la salida en un terminal. Gana la última variable definida, luego el archivo.

Default
less
Environment
ANSIBLE_PAGER, PAGER

Dónde se buscan los roles, después de <playbook_dir>/roles y antes del propio <playbook_dir>. Consulta Roles.

Default
~/.ansible/roles:/usr/share/ansible/roles:/etc/ansible/roles
Environment
ANSIBLE_ROLES_PATH

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.

Default
~/.ansible/collections:/usr/share/ansible/collections
Environment
ANSIBLE_COLLECTIONS_PATH

implicit, explicit o smart. Consulta La caché de facts.

Default
implicit
Environment
ANSIBLE_GATHERING

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.

Default
memory
Environment
ANSIBLE_CACHE_PLUGIN

El directorio de la caché jsonfile.

Environment
ANSIBLE_CACHE_PLUGIN_CONNECTION

Segundos que una entrada en caché sigue vigente. 0 no caduca nunca.

Default
86400
Environment
ANSIBLE_CACHE_PLUGIN_TIMEOUT

Se antepone al nombre de cada archivo de caché.

Environment
ANSIBLE_CACHE_PLUGIN_PREFIX

Los plugins de inventario que se prueban, en orden. Consulta la cadena de plugins.

Default
host_list, script, auto, yaml, ini, toml
Environment
ANSIBLE_INVENTORY_ENABLED

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.

Default
.pyc, .pyo, .swp, .bak, ~, .rpm, .md, .txt, .rst, .orig, .cfg, .retry
Environment
ANSIBLE_INVENTORY_IGNORE

Expresiones regulares de nombres de archivo que se omiten al leer un directorio. [defaults] inventory_ignore_patterns también se lee.

Environment
ANSIBLE_INVENTORY_IGNORE_REGEX

Hace fallar la ejecución cuando no se pudo leer ninguna fuente.

Default
false
Environment
ANSIBLE_INVENTORY_UNPARSED_FAILED

Hace fallar la ejecución en la primera fuente que ningún plugin pudo leer.

Default
false
Environment
ANSIBLE_INVENTORY_ANY_UNPARSED_IS_FAILED

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.

Default
false
Environment
ANSIBLE_INVENTORY_EXPORT

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.

Default
true
Environment
ANSIBLE_INVENTORY_PLUGIN_SCRIPT_STDERR

Escala privilegios por defecto. Las palabras clave del playbook y las variables de host tienen prioridad, consulta Escalado de privilegios.

Default
false
Option
-b
Environment
ANSIBLE_BECOME

El usuario al que se escala.

Default
root
Option
--become-user
Environment
ANSIBLE_BECOME_USER

El método de escalado: sudo o su. Otros métodos detienen la ejecución antes de empezar.

Default
sudo
Option
--become-method
Environment
ANSIBLE_BECOME_METHOD

El programa que se ejecuta en lugar de sudo o su.

Environment
ANSIBLE_BECOME_EXE

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.

Environment
ANSIBLE_BECOME_FLAGS

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.

Default
true
Environment
ANSIBLE_SSH_USETTY

Etiquetas seleccionadas por defecto. --tags se suma a esta lista en lugar de sustituirla.

Option
--tags
Environment
ANSIBLE_RUN_TAGS

Etiquetas omitidas por defecto. --skip-tags se suma a esta lista.

Option
--skip-tags
Environment
ANSIBLE_SKIP_TAGS

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.

Default
false
Environment
VOLANT_BATCHING

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.

Default
true
Environment
VOLANT_NATIVE_MODULES

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.

Default
auto
Environment
VOLANT_RUNTIME

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.

Default
true
Environment
VOLANT_SSH_CONTROL_MASTER

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.

Default
5

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.

Default
0.9

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].

Default
false

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.

Default
allow
Environment
VOLANT_HOST_NAMED_PATHS

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.

Default
unset
Environment
VOLANT_HOST_NAMED_DEST_DIRS