Настройки конфигурации Ansible

Ansible поддерживает несколько источников настройки своего поведения, включая ini-файл с именем ansible.cfg, переменные среды, параметры командной строки, ключевые слова плейбуков и переменные. Подробную информацию об относительном приоритете каждого источника см. в разделе Управление поведением Ansible: правила приоритета.

Утилита ansible-config позволяет просматривать все доступные настройки конфигурации, их значения по умолчанию, способы их задания и источники их текущих значений. Дополнительную информацию см. в разделе ansible-config.

Файл конфигурации

Изменения можно внести в файл конфигурации, который будет искаться в следующем порядке:

ANSIBLE_CONFIG (переменная среды, если задана)
ansible.cfg (в текущем каталоге)
~/.ansible.cfg (в домашнем каталоге)
/etc/ansible/ansible.cfg

Ansible обработает приведённый выше список и использует первый найденный файл; все остальные будут проигнорированы.

Примечание

Файл конфигурации представляет собой один из вариантов формата INI. В качестве маркеров комментариев допускаются как знак решётки (#), так и точка с запятой (;), если комментарий начинается с новой строки. Однако если комментарий находится в одной строке с обычными значениями, в качестве маркера комментария допускается только точка с запятой. Например:

# some basic default values...
inventory = /etc/ansible/hosts  ; This points to the file that lists your hosts

Создание примера файла `ansible.cfg`

Можно создать полностью закомментированный пример файла ansible.cfg, например:

$ ansible-config init --disabled > ansible.cfg

Можно также создать более полный файл, включающий существующие плагины:

$ ansible-config init --disabled -t all > ansible.cfg

Эти файлы можно использовать как отправную точку для создания собственного файла ansible.cfg.

Как избежать рисков безопасности при использовании `ansible.cfg` в текущем каталоге

Если бы Ansible загружал ansible.cfg из текущего рабочего каталога, доступного для записи всем пользователям, это создавало бы серьёзный риск безопасности. Другой пользователь мог бы поместить туда собственный файл конфигурации, предназначенный для выполнения Ansible вредоносного кода как локально, так и удалённо, возможно, с повышенными привилегиями. По этой причине Ansible не загружает автоматически файл конфигурации из текущего рабочего каталога, если этот каталог доступен для записи всем пользователям.

Если вам необходимо использовать Ansible с файлом конфигурации в текущем рабочем каталоге, лучший способ избежать этой проблемы — ограничить доступ к каталогам Ansible для определённых пользователей и/или групп. Если каталоги Ansible находятся в файловой системе, которая должна эмулировать разрешения Unix, например в Vagrant или Windows Subsystem for Linux (WSL), поначалу может быть неясно, как это исправить, поскольку chmod, chown и chgrp могут там не работать. В большинстве таких случаев правильное решение — изменить параметры монтирования файловой системы так, чтобы файлы и каталоги были доступны для чтения и записи пользователям и группам, запускающим Ansible, но закрыты для остальных. Дополнительную информацию о правильных настройках см. здесь:

для Vagrant в документации Vagrant описаны разрешения для синхронизируемых папок.
для WSL параметры монтирования описаны в документации WSL и в этой публикации в блоге Microsoft.

Если вам необходимо хранить конфигурацию Ansible в текущем рабочем каталоге, доступном для записи всем пользователям, можно явно указать файл конфигурации с помощью переменной среды ANSIBLE_CONFIG. Прежде чем это сделать, примите соответствующие меры для снижения описанных выше рисков безопасности.

Относительные пути в конфигурации

Для многих параметров конфигурации можно указать относительный путь. В большинстве таких случаев путь будет отсчитываться от файла ansible.cfg, используемого при текущем запуске. Если нужен путь относительно текущего рабочего каталога (CWD), можно использовать макрос {{CWD}}. Мы не рекомендуем такой подход, поскольку использование CWD в качестве корневого каталога для относительных путей может представлять угрозу безопасности. Например: cd /tmp; secureinfo=./newrootpassword ansible-playbook ~/safestuff/change_root_pwd.yml.

Общие параметры

Здесь приведена копия параметров, доступных в нашем выпуске. В вашей локальной установке могут быть дополнительные параметры из-за установленных плагинов. Для просмотра этих параметров можно использовать упомянутую выше утилиту командной строки (ansible-config).

ACTION_WARNINGS

Описание:

По умолчанию Ansible выдает предупреждение, полученное от действия задачи (модуля или плагина действий). Эти предупреждения можно отключить, установив для этого параметра значение False.

Тип:

boolean

Значение по умолчанию:

True

Добавлено в версии:

2.5

INI:

Раздел:: [defaults]
Ключ:: action_warnings

Переменная окружения:

Переменная:: ANSIBLE_ACTION_WARNINGS

AGNOSTIC_BECOME_PROMPT

Описание:

Отображать нейтральное приглашение become вместо приглашения, содержащего указанный в командной строке метод повышения привилегий.

Тип:

boolean

Значение по умолчанию:

True

Добавлено в версии:

2.5

INI:

Раздел:: [privilege_escalation]
Ключ:: agnostic_become_prompt

Переменная окружения:

Переменная:: ANSIBLE_AGNOSTIC_BECOME_PROMPT

ALLOW_BROKEN_CONDITIONALS

Описание:

Если этот параметр включен, разрешается использовать условные выражения, результатом которых не является логическое значение. В таких случаях будет выдано предупреждение об устаревании. По умолчанию условные выражения, результатом которых не является логическое значение, приводят к ошибке. Такие результаты часто указывают на непреднамеренное использование шаблонов в местах, где они не поддерживаются, из-за чего условие всегда оказывается истинным. Если этот параметр включен, условные выражения, представляющие собой литерал None или пустую строку, для обратной совместимости будут считаться истинными.

Тип:

boolean

Значение по умолчанию:

False

Добавлено в версии:

2.19

INI:

Раздел:: [defaults]
Ключ:: allow_broken_conditionals

Переменная окружения:

Переменная:: ANSIBLE_ALLOW_BROKEN_CONDITIONALS

ALLOW_EMBEDDED_TEMPLATES

Описание:

Если этот параметр включен, разрешается использовать встроенные шаблоны в некоторых случаях для обратной совместимости. В таких случаях будет выдано предупреждение об устаревании. Во-первых, условные выражения (например, failed_when, until, assert.that), целиком заключенные в разделители шаблонов. Во-вторых, строковые константы в условных выражениях (например, when: some_var == '{{ some_other_var }}'). Наконец, позиционные аргументы для lookup (например, lookup('pipe', 'echo {{ some_var }}')). Эта возможность устарела, поскольку в таких случаях встроенные шаблоны не нужны. Если параметр отключен, использование встроенных шаблонов приведет к ошибке. В будущем эта возможность будет отключена по умолчанию.

Тип:

boolean

Значение по умолчанию:

True

Добавлено в версии:

2.19

INI:

Раздел:: [defaults]
Ключ:: allow_embedded_templates

Переменная окружения:

Переменная:: ANSIBLE_ALLOW_EMBEDDED_TEMPLATES

ANSIBLE_CONNECTION_PATH

Описание:

Укажите, где искать скрипт ansible-connection. Это расположение будет проверено до поиска в $PATH. Если значение равно null, Ansible начнет поиск в том же каталоге, что и скрипт ansible.

Тип:

path

Значение по умолчанию:

None

Добавлено в версии:

2.8

INI:

Раздел:: [persistent_connection]
Ключ:: ansible_connection_path

Переменная окружения:

Переменная:: ANSIBLE_CONNECTION_PATH

Примечание:

Этот параметр конфигурации устарел и запланирован к удалению.

Запланированное удаление:

2.22

Причина устаревания:

Этот параметр не оказывает никакого эффекта.

ANSIBLE_COW_ACCEPTLIST

Описание:

Список шаблонов cowsay, которые считаются «безопасными». Укажите пустой список, если хотите включить все установленные шаблоны.

Тип:

list

Значение по умолчанию:

['bud-frogs', 'bunny', 'cheese', 'daemon', 'default', 'dragon', 'elephant-in-snake', 'elephant', 'eyes', 'hellokitty', 'kitty', 'luke-koala', 'meow', 'milk', 'moofasa', 'moose', 'ren', 'sheep', 'small', 'stegosaurus', 'stimpy', 'supermilker', 'three-eyes', 'turkey', 'turtle', 'tux', 'udder', 'vader-koala', 'vader', 'www']

INI:

Раздел:: [defaults]
Ключ:: cowsay_enabled_stencils
Добавлено в версии:: 2.11

Переменная окружения:

Переменная:: ANSIBLE_COW_ACCEPTLIST
Добавлено в версии:: 2.11

ANSIBLE_COW_PATH

Описание:

Укажите собственный путь к cowsay или используйте выбранную вами реализацию cowsay.

Тип:

string

Значение по умолчанию:

None

INI:

Раздел:: [defaults]
Ключ:: cowpath

Переменная окружения:

Переменная:: ANSIBLE_COW_PATH

ANSIBLE_COW_SELECTION

Описание:

Позволяет выбрать конкретный шаблон cowsay для баннеров или указать «random», чтобы циклически перебирать их.

Значение по умолчанию:

default

INI:

Раздел:: [defaults]
Ключ:: cow_selection

Переменная окружения:

Переменная:: ANSIBLE_COW_SELECTION

ANSIBLE_FORCE_COLOR

Описание:

Этот параметр принудительно включает цветной режим, даже если программа запущена без TTY или параметр «nocolor» имеет значение True.

Тип:

boolean

Значение по умолчанию:

False

INI:

Раздел:: [defaults]
Ключ:: force_color

Переменная окружения:

Переменная:: ANSIBLE_FORCE_COLOR

ANSIBLE_HOME

Описание:

Корневой путь по умолчанию для файлов конфигурации Ansible на управляющем узле.

Тип:

path

Значение по умолчанию:

~/.ansible

Добавлено в версии:

2.14

INI:

Раздел:: [defaults]
Ключ:: home

Переменная окружения:

Переменная:: ANSIBLE_HOME

ANSIBLE_NOCOLOR

Описание:

Этот параметр позволяет отключить цветовое оформление вывода, которое используется для более наглядного отображения сведений об ошибках и состоянии.

Тип:

boolean

По умолчанию:

False

Ini:

Секция:: [defaults]
Ключ:: nocolor

Переменные окружения:

Переменная:

ANSIBLE_NOCOLOR
Переменная:

NO_COLOR

Добавлено в версии:

2.11

ANSIBLE_NOCOWS

Описание:

Если у вас установлен cowsay, но вы хотите отключить «коров» (почему????), используйте этот параметр.

Тип:

boolean

По умолчанию:

False

Ini:

Секция:: [defaults]
Ключ:: nocows

Переменные окружения:

Переменная:: ANSIBLE_NOCOWS

ANSIBLE_PIPELINING

Описание:

Это глобальный параметр; каждый плагин подключения может переопределить его с помощью более конкретных параметров или не поддерживать конвейерную обработку вовсе. Конвейерная обработка, если она поддерживается плагином подключения, сокращает количество сетевых операций, необходимых для выполнения модуля на удалённом сервере, позволяя выполнять множество модулей Ansible без фактической передачи файлов. При включении она может значительно повысить производительность. Однако это несовместимо с повышением привилегий (become). Например, при использовании операций «sudo:» сначала необходимо отключить «requiretty» в /etc/sudoers на всех управляемых узлах, поэтому по умолчанию эта функция отключена. Этот параметр будет отключён, если включён ANSIBLE_KEEP_REMOTE_FILES.

Тип:

boolean

По умолчанию:

False

Ini:

Секция:

[connection]

Ключ:

pipelining
Секция:

[defaults]

Ключ:

pipelining

Переменные окружения:

Переменная:: ANSIBLE_PIPELINING

ANY_ERRORS_FATAL

Описание:

Задаёт значение по умолчанию для ключевого слова any_errors_fatal: если оно равно True, сбои задач будут считаться критическими ошибками.

Тип:

boolean

По умолчанию:

False

Добавлено в версии:

2.4

Ini:

Секция:: [defaults]
Ключ:: any_errors_fatal

Переменные окружения:

Переменная:: ANSIBLE_ANY_ERRORS_FATAL

BECOME_ALLOW_SAME_USER

Описание:

Если False``(default), Ansible will skip using become if the remote user is the same as the become user, as this is normally a redundant operation. In other words root sudo to root. If ``True, этот параметр принудительно заставляет Ansible использовать плагин become, поскольку бывают случаи, когда это необходимо.

Тип:

boolean

По умолчанию:

False

Ini:

Секция:: [privilege_escalation]
Ключ:: become_allow_same_user

Переменные окружения:

Переменная:: ANSIBLE_BECOME_ALLOW_SAME_USER

BECOME_PASSWORD_FILE

Описание:

Файл с паролем, используемый плагином become. --become-password-file. Если файл является исполняемым, он будет запущен, а его стандартный вывод будет использован в качестве пароля.

Тип:

path

По умолчанию:

None

Добавлено в версии:

2.12

Ini:

Секция:: [defaults]
Ключ:: become_password_file

Переменные окружения:

Переменная:: ANSIBLE_BECOME_PASSWORD_FILE

BECOME_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины Become.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/become:/usr/share/ansible/plugins/become" }}

Добавлено в версии:

2.8

Ini:

Секция:: [defaults]
Ключ:: become_plugins

Переменные окружения:

Переменная:: ANSIBLE_BECOME_PLUGINS

CACHE_PLUGIN

Описание:

Выбирает плагин кэширования фактов. По умолчанию кэширование не используется, и факты не сохраняются между запусками.

По умолчанию:

memory

Ini:

Секция:: [defaults]
Ключ:: fact_caching

Переменные окружения:

Переменная:: ANSIBLE_CACHE_PLUGIN

CACHE_PLUGIN_CONNECTION

Описание:

Задаёт сведения о подключении или пути для плагина кэширования фактов.

По умолчанию:

None

Ini:

Секция:: [defaults]
Ключ:: fact_caching_connection

Переменные окружения:

Переменная:: ANSIBLE_CACHE_PLUGIN_CONNECTION

CACHE_PLUGIN_PREFIX

Описание:

Префикс для файлов/таблиц плагина кэширования фактов.

По умолчанию:

ansible_facts

Ini:

Секция:: [defaults]
Ключ:: fact_caching_prefix

Переменные окружения:

Переменная:: ANSIBLE_CACHE_PLUGIN_PREFIX

CACHE_PLUGIN_TIMEOUT

Описание:

Время, по истечении которого данные плагина кэширования фактов устаревают.

Тип:

integer

По умолчанию:

86400

Ini:

Секция:: [defaults]
Ключ:: fact_caching_timeout

Переменные окружения:

Переменная:: ANSIBLE_CACHE_PLUGIN_TIMEOUT

CALLBACKS_ENABLED

Описание:

Список включённых обработчиков обратного вызова. Не все обработчики обратного вызова необходимо включать, однако многие из поставляемых с Ansible следует включить, поскольку по умолчанию они не должны быть активны.

Тип:

list

Значение по умолчанию:

[]

Ini:

Раздел:: [defaults]
Ключ:: callbacks_enabled
Добавлено в версии:: 2.11

Окружение:

Переменная:: ANSIBLE_CALLBACKS_ENABLED
Добавлено в версии:: 2.11

COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH

Описание:

Когда загружается коллекция, которая не поддерживает текущую версию Ansible (с ключом метаданных коллекции requires_ansible).

Значение по умолчанию:

warning

Варианты:

error:

выдать «фатальную» ошибку и остановить выполнение сценария
warning:

выдать предупреждение, но продолжить выполнение
ignore:

просто продолжить выполнение без сообщений

Ini:

Раздел:: [defaults]
Ключ:: collections_on_ansible_version_mismatch

Окружение:

Переменная:: ANSIBLE_COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH

COLLECTIONS_PATHS

Описание:

Пути, разделённые двоеточиями, в которых Ansible ищет содержимое коллекций. Коллекции должны находиться во вложенных подкаталогах, а не непосредственно в этих каталогах. Например, если COLLECTIONS_PATHS включает '{{ ANSIBLE_HOME ~ "/collections" }}', а вы хотите добавить my.collection в этот каталог, его необходимо сохранить как '{{ ANSIBLE_HOME ~ "/collections/ansible_collections/my/collection" }}'.

Тип:

pathspec

Значение по умолчанию:

{{ ANSIBLE_HOME ~ "/collections:/usr/share/ansible/collections" }}

Ini:

Раздел:: [defaults]
Ключ:: collections_path
Добавлено в версии:: 2.10

Окружение:

Переменная:: ANSIBLE_COLLECTIONS_PATH
Добавлено в версии:: 2.10

COLLECTIONS_SCAN_SYS_PATH

Описание:

Логическое значение, включающее или отключающее поиск установленных коллекций в sys.path.

Тип:

boolean

Значение по умолчанию:

True

Ini:

Раздел:: [defaults]
Ключ:: collections_scan_sys_path

Окружение:

Переменная:: ANSIBLE_COLLECTIONS_SCAN_SYS_PATH

COLOR_CHANGED

Описание:

Задаёт цвет для статуса задачи «Changed».

Значение по умолчанию:

yellow

Ini:

Раздел:: [colors]
Ключ:: changed

Окружение:

Переменная:: ANSIBLE_COLOR_CHANGED

COLOR_CONSOLE_PROMPT

Описание:

Задаёт цвет по умолчанию для ansible-console.

Значение по умолчанию:

white

Добавлено в версии:

2.7

Ini:

Раздел:: [colors]
Ключ:: console_prompt

Окружение:

Переменная:: ANSIBLE_COLOR_CONSOLE_PROMPT

COLOR_DEBUG

Описание:

Задаёт цвет для вывода отладочных сообщений.

Значение по умолчанию:

dark gray

Ini:

Раздел:: [colors]
Ключ:: debug

Окружение:

Переменная:: ANSIBLE_COLOR_DEBUG

COLOR_DEPRECATE

Описание:

Задаёт цвет для вывода сообщений об устаревании.

Значение по умолчанию:

purple

Ini:

Раздел:: [colors]
Ключ:: deprecate

Окружение:

Переменная:: ANSIBLE_COLOR_DEPRECATE

COLOR_DIFF_ADD

Описание:

Задаёт цвет для отображения добавленных строк в различиях.

Значение по умолчанию:

green

Ini:

Раздел:: [colors]
Ключ:: diff_add

Окружение:

Переменная:: ANSIBLE_COLOR_DIFF_ADD

COLOR_DIFF_LINES

Описание:

Задаёт цвет для отображения различий.

Значение по умолчанию:

cyan

Ini:

Раздел:: [colors]
Ключ:: diff_lines

Окружение:

Переменная:: ANSIBLE_COLOR_DIFF_LINES

COLOR_DIFF_REMOVE

Описание:

Задаёт цвет для отображения удалённых строк в различиях.

Значение по умолчанию:

red

Ini:

Раздел:: [colors]
Ключ:: diff_remove

Окружение:

Переменная:: ANSIBLE_COLOR_DIFF_REMOVE

COLOR_DOC_CONSTANT

Описание:

Задаёт цвет для вывода констант в выводе ansible-doc.

Значение по умолчанию:

dark gray

Добавлено в версии:

2.18

Ini:

Раздел:: [colors]
Ключ:: doc_constant

Окружение:

Переменная:: ANSIBLE_COLOR_DOC_CONSTANT

COLOR_DOC_DEPRECATED

Описание:

Определяет цвет для отображения устаревшего значения в выводе ansible-doc.

По умолчанию:

magenta

Добавлено в версии:

2.18

Ini:

Раздел:: [colors]
Ключ:: doc_deprecated

Переменная среды:

Переменная:: ANSIBLE_COLOR_DOC_DEPRECATED

COLOR_DOC_LINK

Описание:

Определяет цвет для отображения ссылки в выводе ansible-doc.

По умолчанию:

cyan

Добавлено в версии:

2.18

Ini:

Раздел:: [colors]
Ключ:: doc_link

Переменная среды:

Переменная:: ANSIBLE_COLOR_DOC_LINK

COLOR_DOC_MODULE

Описание:

Определяет цвет для отображения имени модуля в выводе ansible-doc.

По умолчанию:

yellow

Добавлено в версии:

2.18

Ini:

Раздел:: [colors]
Ключ:: doc_module

Переменная среды:

Переменная:: ANSIBLE_COLOR_DOC_MODULE

COLOR_DOC_PLUGIN

Описание:

Определяет цвет для отображения имени плагина в выводе ansible-doc.

По умолчанию:

yellow

Добавлено в версии:

2.18

Ini:

Раздел:: [colors]
Ключ:: doc_plugin

Переменная среды:

Переменная:: ANSIBLE_COLOR_DOC_PLUGIN

COLOR_DOC_REFERENCE

Описание:

Определяет цвет для отображения перекрёстной ссылки в выводе ansible-doc.

По умолчанию:

magenta

Добавлено в версии:

2.18

Ini:

Раздел:: [colors]
Ключ:: doc_reference

Переменная среды:

Переменная:: ANSIBLE_COLOR_DOC_REFERENCE

COLOR_ERROR

Описание:

Определяет цвет для отображения сообщений об ошибках.

По умолчанию:

red

Ini:

Раздел:: [colors]
Ключ:: error

Переменная среды:

Переменная:: ANSIBLE_COLOR_ERROR

COLOR_HIGHLIGHT

Описание:

Определяет цвет для выделения.

По умолчанию:

white

Ini:

Раздел:: [colors]
Ключ:: highlight

Переменная среды:

Переменная:: ANSIBLE_COLOR_HIGHLIGHT

COLOR_INCLUDED

Описание:

Определяет цвет для отображения статуса задачи «Включено».

По умолчанию:

cyan

Добавлено в версии:

2.18

Ini:

Раздел:: [colors]
Ключ:: included

Переменная среды:

Переменная:: ANSIBLE_COLOR_INCLUDED

COLOR_OK

Описание:

Определяет цвет для отображения статуса задачи «ОК».

По умолчанию:

green

Ini:

Раздел:: [colors]
Ключ:: ok

Переменная среды:

Переменная:: ANSIBLE_COLOR_OK

COLOR_SKIP

Описание:

Определяет цвет для отображения статуса задачи «Пропущено».

По умолчанию:

cyan

Ini:

Раздел:: [colors]
Ключ:: skip

Переменная среды:

Переменная:: ANSIBLE_COLOR_SKIP

COLOR_UNREACHABLE

Описание:

Определяет цвет для статуса «Недоступен».

По умолчанию:

bright red

Ini:

Раздел:: [colors]
Ключ:: unreachable

Переменная среды:

Переменная:: ANSIBLE_COLOR_UNREACHABLE

COLOR_VERBOSE

Описание:

Определяет цвет для отображения подробных сообщений. Иными словами, сообщений, отображаемых при использовании параметра «-v».

По умолчанию:

blue

Ini:

Раздел:: [colors]
Ключ:: verbose

Переменная среды:

Переменная:: ANSIBLE_COLOR_VERBOSE

COLOR_WARN

Описание:

Определяет цвет для отображения предупреждающих сообщений.

По умолчанию:

bright purple

Ini:

Раздел:: [colors]
Ключ:: warn

Переменная среды:

Переменная:: ANSIBLE_COLOR_WARN

CONNECTION_FACTS_MODULES

Описание:: Какие модули запускать на этапе сбора фактов в плейбуке в зависимости от подключения
Тип:: dict
По умолчанию:: {'asa': 'ansible.legacy.asa_facts', 'cisco.asa.asa': 'cisco.asa.asa_facts', 'eos': 'ansible.legacy.eos_facts', 'arista.eos.eos': 'arista.eos.eos_facts', 'frr': 'ansible.legacy.frr_facts', 'frr.frr.frr': 'frr.frr.frr_facts', 'ios': 'ansible.legacy.ios_facts', 'cisco.ios.ios': 'cisco.ios.ios_facts', 'iosxr': 'ansible.legacy.iosxr_facts', 'cisco.iosxr.iosxr': 'cisco.iosxr.iosxr_facts', 'junos': 'ansible.legacy.junos_facts', 'junipernetworks.junos.junos': 'junipernetworks.junos.junos_facts', 'nxos': 'ansible.legacy.nxos_facts', 'cisco.nxos.nxos': 'cisco.nxos.nxos_facts', 'vyos': 'ansible.legacy.vyos_facts', 'vyos.vyos.vyos': 'vyos.vyos.vyos_facts', 'exos': 'ansible.legacy.exos_facts', 'extreme.exos.exos': 'extreme.exos.exos_facts', 'slxos': 'ansible.legacy.slxos_facts', 'extreme.slxos.slxos': 'extreme.slxos.slxos_facts', 'voss': 'ansible.legacy.voss_facts', 'extreme.voss.voss': 'extreme.voss.voss_facts', 'ironware': 'ansible.legacy.ironware_facts', 'community.network.ironware': 'community.network.ironware_facts'}

CONNECTION_PASSWORD_FILE

Описание:

Файл пароля для плагина подключения. --connection-password-file.

Тип:

path

По умолчанию:

None

Добавлено в версии:

2.12

Ini:

Раздел:: [defaults]
Ключ:: connection_password_file

Переменные окружения:

Переменная:: ANSIBLE_CONNECTION_PASSWORD_FILE

COVERAGE_REMOTE_OUTPUT

Описание:

Задает каталог вывода на удаленном узле для создания отчетов о покрытии. В настоящее время используется только для удаленного сбора данных о покрытии модулей PowerShell. Предназначено только для внутреннего использования.

Тип:

str

Добавлено в версии:

2.9

Переменные окружения:

Переменная:: _ANSIBLE_COVERAGE_REMOTE_OUTPUT

Переменные:

имя:: _ansible_coverage_remote_output

COVERAGE_REMOTE_PATHS

Описание:

Список путей к файлам на контроллере Ansible, для которых нужно собирать данные о покрытии при выполнении на удаленном узле. Данные о покрытии собираются только для файлов, соответствующих шаблону пути. Можно указать несколько шаблонов путей, разделив их с помощью :. В настоящее время используется только для удаленного сбора данных о покрытии модулей PowerShell. Предназначено только для внутреннего использования.

Тип:

str

По умолчанию:

*

Добавлено в версии:

2.9

Переменные окружения:

Переменная:: _ANSIBLE_COVERAGE_REMOTE_PATH_FILTER

DEFAULT_ACTION_PLUGIN_PATH

Описание:

Пути, разделенные двоеточиями, в которых Ansible будет искать плагины действий.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/action:/usr/share/ansible/plugins/action" }}

Ini:

Раздел:: [defaults]
Ключ:: action_plugins

Переменные окружения:

Переменная:: ANSIBLE_ACTION_PLUGINS

DEFAULT_ALLOW_UNSAFE_LOOKUPS

Описание:

Если этот параметр включен, плагины поиска (независимо от того, используются ли они в переменных как {{lookup('foo')}} или в цикле, как with_foo) могут возвращать данные, не помеченные как «небезопасные». По умолчанию такие данные помечаются как небезопасные, чтобы предотвратить обработку шаблонов языка Jinja2 движком шаблонов, поскольку это может представлять угрозу безопасности. Этот параметр предусмотрен для обеспечения обратной совместимости, однако сначала следует рассмотреть возможность добавления allow_unsafe=True во все плагины поиска, которые могут содержать данные, подлежащие поздней обработке движком шаблонов.

Тип:

boolean

По умолчанию:

False

Добавлено в версии:

2.2.3

Ini:

Раздел:: [defaults]
Ключ:: allow_unsafe_lookups

Примечание:

Этот параметр конфигурации устарел и запланирован к удалению. Рекомендуется перейти на актуальную альтернативу.

Запланированное удаление:

2.23

Причина устаревания:

Этот параметр больше не используется в кодовой базе Ansible Core.

Актуальные альтернативы:

Плагины поиска отвечают за пометку строк, содержащих шаблоны, чтобы их можно было обрабатывать как шаблоны.

DEFAULT_ASK_PASS

Описание:

Определяет, должен ли плейбук Ansible запрашивать пароль для входа. Если для аутентификации используются ключи SSH, вероятно, менять этот параметр не нужно.

Тип:

boolean

По умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: ask_pass

Переменные окружения:

Переменная:: ANSIBLE_ASK_PASS

DEFAULT_ASK_VAULT_PASS

Описание:

Определяет, должен ли плейбук Ansible запрашивать пароль хранилища.

Тип:

boolean

По умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: ask_vault_pass

Переменные окружения:

Переменная:: ANSIBLE_ASK_VAULT_PASS

DEFAULT_BECOME

Описание:

Включает или отключает повышение привилегий, позволяя после входа «стать» другим пользователем.

Тип:

boolean

По умолчанию:

False

Ini:

Раздел:: [privilege_escalation]
Ключ:: become

Переменные окружения:

Переменная:: ANSIBLE_BECOME

DEFAULT_BECOME_ASK_PASS

Описание:

Включает или отключает запрос пароля для повышения привилегий.

Тип:

boolean

По умолчанию:

False

Ini:

Раздел:: [privilege_escalation]
Ключ:: become_ask_pass

Переменные окружения:

Переменная:: ANSIBLE_BECOME_ASK_PASS

DEFAULT_BECOME_EXE

Описание:

Исполняемый файл для повышения привилегий; в противном случае Ansible будет использовать PATH.

По умолчанию:

None

Ini:

Раздел:: [privilege_escalation]
Ключ:: become_exe

Переменные окружения:

Переменная:: ANSIBLE_BECOME_EXE

DEFAULT_BECOME_FLAGS

Описание:

Флаги, передаваемые исполняемому файлу для повышения привилегий.

По умолчанию:

Ini:

Раздел:: [privilege_escalation]
Ключ:: become_flags

Переменные окружения:

Переменная:: ANSIBLE_BECOME_FLAGS

DEFAULT_BECOME_METHOD

Описание:

Метод повышения привилегий, используемый, когда включен параметр become.

По умолчанию:

sudo

Ini:

Раздел:: [privilege_escalation]
Ключ:: become_method

Переменные окружения:

Переменная:: ANSIBLE_BECOME_METHOD

DEFAULT_BECOME_USER

Описание:

Пользователь, в которого превращается пользователь для входа/удалённый пользователь при повышении привилегий; в большинстве систем, если пользователь не указан, используется ‘root’.

По умолчанию:

root

Ini:

Раздел:: [privilege_escalation]
Ключ:: become_user

Окружение:

Переменная:: ANSIBLE_BECOME_USER

DEFAULT_CACHE_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible ищет плагины кэширования.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/cache:/usr/share/ansible/plugins/cache" }}

Ini:

Раздел:: [defaults]
Ключ:: cache_plugins

Окружение:

Переменная:: ANSIBLE_CACHE_PLUGINS

DEFAULT_CALLBACK_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible ищет плагины обратного вызова.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/callback:/usr/share/ansible/plugins/callback" }}

Ini:

Раздел:: [defaults]
Ключ:: callback_plugins

Окружение:

Переменная:: ANSIBLE_CALLBACK_PLUGINS

DEFAULT_CLICONF_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible ищет плагины Cliconf.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/cliconf:/usr/share/ansible/plugins/cliconf" }}

Ini:

Раздел:: [defaults]
Ключ:: cliconf_plugins

Окружение:

Переменная:: ANSIBLE_CLICONF_PLUGINS

DEFAULT_CONNECTION_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible ищет плагины подключений.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/connection:/usr/share/ansible/plugins/connection" }}

Ini:

Раздел:: [defaults]
Ключ:: connection_plugins

Окружение:

Переменная:: ANSIBLE_CONNECTION_PLUGINS

DEFAULT_DEBUG

Описание:

Включает или выключает отладочный вывод в Ansible. Он очень подробный и может замедлить параллельное выполнение. Отладочный вывод также может содержать секретную информацию, даже если включены настройки no_log, поэтому режим отладки не следует использовать в рабочей среде.

Тип:

boolean

По умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: debug

Окружение:

Переменная:: ANSIBLE_DEBUG

DEFAULT_EXECUTABLE

Описание:

Указывает команду для запуска оболочки, необходимой Ansible для выполнения задач на целевом узле. В редких случаях пользователям может потребоваться изменить это значение, если использование оболочки ограничено, но обычно его можно оставить без изменений.

По умолчанию:

/bin/sh

Ini:

Раздел:: [defaults]
Ключ:: executable

Окружение:

Переменная:: ANSIBLE_EXECUTABLE

DEFAULT_FILTER_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible ищет плагины фильтров Jinja2.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/filter:/usr/share/ansible/plugins/filter" }}

Ini:

Раздел:: [defaults]
Ключ:: filter_plugins

Окружение:

Переменная:: ANSIBLE_FILTER_PLUGINS

DEFAULT_FORCE_HANDLERS

Описание:

Этот параметр определяет, будут ли запущены уведомлённые обработчики на узле, даже если на нём произошла ошибка. Если значение равно false, обработчики не будут запущены, если на узле произошла ошибка. Этот параметр также можно задать для отдельного сценария или в командной строке. Дополнительные сведения см. в разделах «Обработчики» и «Сбои».

Тип:

boolean

По умолчанию:

False

Добавлено в версии:

1.9.1

Ini:

Раздел:: [defaults]
Ключ:: force_handlers

Окружение:

Переменная:: ANSIBLE_FORCE_HANDLERS

DEFAULT_FORKS

Описание:

Максимальное количество процессов, которые Ansible использует для выполнения задач на целевых узлах.

Тип:

integer

По умолчанию:

5

Ini:

Раздел:: [defaults]
Ключ:: forks

Окружение:

Переменная:: ANSIBLE_FORKS

DEFAULT_GATHERING

Описание:

Этот параметр задаёт политику сбора фактов по умолчанию (фактов, полученных о удалённых системах). Этот параметр может быть полезен тем, кто хочет сократить время сбора фактов. Режимы ‘smart’ и ‘explicit’ используют плагин кэширования.

По умолчанию:

implicit

Варианты:

implicit:

плагин кэширования игнорируется, а факты собираются для каждого сценария, если не задано ‘gather_facts: False’.
explicit:

факты не собираются, если это явно не запрошено в сценарии.
smart:

сканируется каждый новый узел, для которого ещё не собраны факты; однако если один и тот же узел указан в нескольких сценариях, в ходе выполнения к нему больше не будут обращаться.

Добавлено в версии:

1.6

Ini:

Раздел:: [defaults]
Ключ:: gathering

Окружение:

Переменная:: ANSIBLE_GATHERING

DEFAULT_HASH_BEHAVIOUR

Описание:

Этот параметр управляет обработкой повторных определений переменных-словарей (также называемых хешами, картами или ассоциативными массивами) в Ansible. Он не влияет на переменные со скалярными значениями (целыми числами, строками) или массивами. ВНИМАНИЕ: менять этот параметр не рекомендуется, поскольку это ненадежно и делает ваше содержимое (плейбуки, роли, коллекции) непереносимым, что приводит к постоянной путанице и неправильному использованию. Не меняйте этот параметр, если не считаете это абсолютно необходимым. Рекомендуем не использовать повторно имена переменных и полагаться на фильтр combine и поисковые запросы vars и varnames для создания объединённых версий отдельных переменных. По нашему опыту, это требуется редко и свидетельствует о том, что структуры данных и плейбуки стали слишком сложными. В некоторых случаях можно также использовать пользовательские vars_plugins для объединения данных при вводе, даже заменив стандартный host_group_vars, отвечающий за разбор каталогов host_vars/ и group_vars/. Большинство пользователей этого параметра интересуются только областью инвентаризации, однако сам параметр влияет на все источники и ещё больше усложняет отладку. Во всех плейбуках и ролях из официальных репозиториев с примерами предполагается значение этого параметра по умолчанию. Изменение параметра на merge применяется ко всем источникам переменных, однако многие источники по-прежнему будут перезаписывать переменные внутри себя. Например, include_vars выполняет дедупликацию переменных внутри себя перед обновлением Ansible, причём «последнее определение» перезаписывает предыдущие определения в том же файле. Проект Ansible рекомендует не использовать ``merge`` в новых проектах. Разработчики Ansible намерены со временем объявить этот параметр устаревшим и удалить его, но пока сохраняют его, поскольку некоторые пользователи активно на него полагаются. Новым проектам следует избегать «merge».

Тип:

string

По умолчанию:

replace

Варианты:

replace:

Любая переменная, определённая более одного раза, перезаписывается в соответствии с порядком правил приоритета переменных (побеждает переменная с наивысшим приоритетом).
merge:

Любая переменная-словарь рекурсивно объединяется с новыми определениями из различных источников определения переменных.

INI:

Раздел:: [defaults]
Ключ:: hash_behaviour

Окружение:

Переменная:: ANSIBLE_HASH_BEHAVIOUR

DEFAULT_HOST_LIST

Описание:

Список источников инвентаризации Ansible, разделённых запятыми

Тип:

pathlist

По умолчанию:

['/etc/ansible/hosts']

INI:

Раздел:: [defaults]
Ключ:: inventory

Окружение:

Переменная:: ANSIBLE_INVENTORY

DEFAULT_HTTPAPI_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины HttpApi.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/httpapi:/usr/share/ansible/plugins/httpapi" }}

INI:

Раздел:: [defaults]
Ключ:: httpapi_plugins

Окружение:

Переменная:: ANSIBLE_HTTPAPI_PLUGINS

DEFAULT_INTERNAL_POLL_INTERVAL

Описание:

Задаёт интервал (в секундах), с которым внутренние процессы Ansible опрашивают друг друга. Меньшие значения повышают производительность при работе с большими плейбуками за счёт увеличения нагрузки на ЦП. Большие значения лучше подходят для использования Ansible в сценариях автоматизации, когда не требуется высокая отзывчивость интерфейса, но может иметь значение нагрузка на ЦП. Значение по умолчанию соответствует значению, жёстко заданному в Ansible <= 2.1

Тип:

float

По умолчанию:

0.001

Добавлено в версии:

2.2

INI:

Раздел:: [defaults]
Ключ:: internal_poll_interval

DEFAULT_INVENTORY_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины инвентаризации.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/inventory:/usr/share/ansible/plugins/inventory" }}

INI:

Раздел:: [defaults]
Ключ:: inventory_plugins

Окружение:

Переменная:: ANSIBLE_INVENTORY_PLUGINS

DEFAULT_JINJA2_EXTENSIONS

Описание:

Эта функция предназначена для разработчиков и позволяет включать дополнительные расширения Jinja2. Подробности см. в документации Jinja2. Если вы не знаете, что они делают, скорее всего, вам не нужно менять этот параметр :)

Тип:

list

По умолчанию:

[]

INI:

Раздел:: [defaults]
Ключ:: jinja2_extensions

Окружение:

Переменная:: ANSIBLE_JINJA2_EXTENSIONS

Примечание:

Эта настройка устарела и запланирована к удалению. Вам следует перейти на актуальную альтернативу.

Запланированное удаление:

2.23

Причина устаревания:

Расширения Jinja2 объявлены устаревшими

Актуальные альтернативы:

Поддерживаемые Ansible плагины Jinja (тесты, фильтры, поисковые запросы)

DEFAULT_JINJA2_NATIVE

Описание:

Этот параметр сохраняет типы переменных при выполнении операций с шаблонами.

Тип:

boolean

По умолчанию:

True

Добавлено в версии:

2.7

INI:

Раздел:: [defaults]
Ключ:: jinja2_native

Окружение:

Переменная:: ANSIBLE_JINJA2_NATIVE

Примечание:

Эта настройка устарела и запланирована к удалению. Вам следует перейти на актуальную альтернативу.

Запланированное удаление:

2.23

Причина устаревания:

Этот параметр больше не используется в кодовой базе Ansible Core.

Актуальные альтернативы:

Режим Jinja2 с нативными типами теперь используется по умолчанию и является единственным вариантом.

DEFAULT_KEEP_REMOTE_FILES

Описание:

Включает или отключает удаление временных файлов, которые Ansible использовал для выполнения задач на удалённом узле. Если этот параметр включён, он отключает ANSIBLE_PIPELINING.

Тип:

boolean

По умолчанию:

False

INI:

Раздел:: [defaults]
Ключ:: keep_remote_files

Окружение:

Переменная:: ANSIBLE_KEEP_REMOTE_FILES

DEFAULT_LIBVIRT_LXC_NOSECLABEL

Описание:

Этот параметр указывает libvirt подключаться к контейнерам LXC, передавая параметр --noseclabel команде virsh. Это необходимо при работе в системах без SELinux.

Тип:

boolean

Значение по умолчанию:

False

Добавлено в версии:

2.1

Ini:

Раздел:: [selinux]
Ключ:: libvirt_lxc_noseclabel

Переменные среды:

Переменная:: ANSIBLE_LIBVIRT_LXC_NOSECLABEL

Примечание:

Эта настройка объявлена устаревшей и запланирована к удалению. Рекомендуется перейти на актуальную альтернативу.

Запланированное удаление:

2.22

Причина устаревания:

Этот параметр перенесён в сам плагин

Текущие альтернативы:

Используйте параметр самого плагина.

DEFAULT_LOAD_CALLBACK_PLUGINS

Описание:

Определяет, загружаются ли плагины обратного вызова при запуске /usr/bin/ansible. Это можно использовать для ведения журнала активности из командной строки, отправки уведомлений и т. д. Плагины обратного вызова всегда загружаются для ansible-playbook.

Тип:

boolean

Значение по умолчанию:

False

Добавлено в версии:

1.8

Ini:

Раздел:: [defaults]
Ключ:: bin_ansible_callbacks

Переменные среды:

Переменная:: ANSIBLE_LOAD_CALLBACK_PLUGINS

DEFAULT_LOCAL_TMP

Описание:

Временный каталог, который Ansible использует на управляющем узле.

Тип:

tmppath

Значение по умолчанию:

{{ ANSIBLE_HOME ~ "/tmp" }}

Ini:

Раздел:: [defaults]
Ключ:: local_tmp

Переменные среды:

Переменная:: ANSIBLE_LOCAL_TEMP

DEFAULT_LOG_FILTER

Описание:

Список имён регистраторов, которые следует исключить из файла журнала.

Тип:

list

Значение по умолчанию:

[]

Ini:

Раздел:: [defaults]
Ключ:: log_filter

Переменные среды:

Переменная:: ANSIBLE_LOG_FILTER

DEFAULT_LOG_PATH

Описание:

Файл, в который Ansible записывает журнал на управляющем узле. Если значение не задано, ведение журнала отключено.

Тип:

path

Значение по умолчанию:

None

Ini:

Раздел:: [defaults]
Ключ:: log_path

Переменные среды:

Переменная:: ANSIBLE_LOG_PATH

DEFAULT_LOOKUP_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible выполняет поиск плагинов поиска.

Тип:

pathspec

Значение по умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/lookup:/usr/share/ansible/plugins/lookup" }}

Ini:

Раздел:: [defaults]
Ключ:: lookup_plugins

Переменные среды:

Переменная:: ANSIBLE_LOOKUP_PLUGINS

DEFAULT_MANAGED_STR

Описание:

Задаёт макрос для переменной ‘ansible_managed’, доступной в ansible_collections.ansible.builtin.template_module и ansible_collections.ansible.windows.win_template_module. Это относится только к этим двум модулям.

Значение по умолчанию:

Ansible managed

Ini:

Раздел:: [defaults]
Ключ:: ansible_managed

Примечание:

Запланированное удаление:

2.23

Причина устаревания:

Переменную ansible_managed можно задать, как и любую другую переменную, либо использовать другую переменную.

Текущие альтернативы:

Задайте переменную ansible_managed или используйте в шаблонах любую пользовательскую переменную.

DEFAULT_MODULE_ARGS

Описание:

Задаёт аргументы по умолчанию, передаваемые двоичному файлу adhoc ansible, если не указан -a.

Значение по умолчанию:

None

Ini:

Раздел:: [defaults]
Ключ:: module_args

Переменные среды:

Переменная:: ANSIBLE_MODULE_ARGS

DEFAULT_MODULE_COMPRESSION

Описание:

Схема сжатия, используемая при передаче модулей Python на целевой узел.

Значение по умолчанию:

ZIP_DEFLATED

Ini:

Раздел:: [defaults]
Ключ:: module_compression

Переменные:

имя:: ansible_module_compression

DEFAULT_MODULE_NAME

Описание:

Модуль, используемый с командой AdHoc ansible, если он не указан с помощью -m.

Значение по умолчанию:

command

Ini:

Раздел:: [defaults]
Ключ:: module_name

DEFAULT_MODULE_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible выполняет поиск модулей.

Тип:

pathspec

Значение по умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/modules:/usr/share/ansible/plugins/modules" }}

Ini:

Раздел:: [defaults]
Ключ:: library

Переменные среды:

Переменная:: ANSIBLE_LIBRARY

DEFAULT_MODULE_UTILS_PATH

Описание:

Пути, разделённые двоеточиями, по которым Ansible выполняет поиск файлов утилит модулей, используемых совместно модулями.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/module_utils:/usr/share/ansible/plugins/module_utils" }}

Ini:

Раздел:: [defaults]
Ключ:: module_utils

Окружение:

Переменная:: ANSIBLE_MODULE_UTILS

DEFAULT_NETCONF_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, по которым Ansible выполняет поиск плагинов Netconf.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/netconf:/usr/share/ansible/plugins/netconf" }}

Ini:

Раздел:: [defaults]
Ключ:: netconf_plugins

Окружение:

Переменная:: ANSIBLE_NETCONF_PLUGINS

DEFAULT_NO_LOG

Описание:

Включает или отключает отображение и запись в журнал сведений о задачах Ansible; в основном используется для предотвращения раскрытия конфиденциальных данных.

Тип:

boolean

По умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: no_log

Окружение:

Переменная:: ANSIBLE_NO_LOG

DEFAULT_NO_TARGET_SYSLOG

Описание:

Включает или отключает запись Ansible в syslog на целевом узле при выполнении задач. На узлах Windows это отключает запись модулей PowerShell нового типа в журнал событий.

Тип:

boolean

По умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: no_target_syslog

Окружение:

Переменная:: ANSIBLE_NO_TARGET_SYSLOG

Переменные:

имя:: ansible_no_target_syslog
Добавлено в версии:: 2.10

DEFAULT_NULL_REPRESENTATION

Описание:

Значение, которое шаблонизатор должен возвращать как «null». Если оно не задано, решение принимает Jinja2.

Тип:

raw

По умолчанию:

None

Ini:

Раздел:: [defaults]
Ключ:: null_representation

Окружение:

Переменная:: ANSIBLE_NULL_REPRESENTATION

Примечание:

Эта настройка устарела и запланирована к удалению. Вам следует перейти на актуальную альтернативу.

Запланированное удаление:

2.23

Причина устаревания:

Эта опция больше не используется в кодовой базе Ansible Core.

Текущие альтернативы:

На данный момент альтернативы нет. Для этого потребуется реализовать другой механизм в текущей кодовой базе.

DEFAULT_POLL_INTERVAL

Описание:

Для асинхронных задач Ansible (описанных в разделе «Асинхронные действия и опрос») этот параметр задаёт, как часто проверять состояние задач, если интервал опроса не указан явно. Значение по умолчанию — умеренные 15 секунд: это компромисс между частыми проверками и быстрым получением результата после завершения задачи.

Тип:

integer

По умолчанию:

15

Ini:

Раздел:: [defaults]
Ключ:: poll_interval

Окружение:

Переменная:: ANSIBLE_POLL_INTERVAL

DEFAULT_PRIVATE_KEY_FILE

Описание:

Для подключений с аутентификацией по сертификату или файлу ключа вместо агента или пароля здесь можно задать значение по умолчанию, чтобы не указывать --private-key при каждом вызове.

Тип:

path

По умолчанию:

None

Ini:

Раздел:: [defaults]
Ключ:: private_key_file

Окружение:

Переменная:: ANSIBLE_PRIVATE_KEY_FILE

DEFAULT_PRIVATE_ROLE_VARS

Описание:

По умолчанию переменные импортированных ролей становятся доступными в плейбуке и других ролях; этот параметр позволяет отключить такое поведение. Он был введён, чтобы сбрасывать переменные ролей до значений по умолчанию, если роль используется в плейбуке несколько раз. Начиная с версии «2.17», M(ansible.builtin.include_roles) и M(ansible.builtin.import_roles) могут переопределять это поведение по отдельности с помощью параметра C(public). Переменные подключённых ролей становятся общедоступными только во время выполнения, в отличие от импортированных ролей, переменные которых становятся доступными на этапе компиляции плейбука.

Тип:

boolean

По умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: private_role_vars

Окружение:

Переменная:: ANSIBLE_PRIVATE_ROLE_VARS

DEFAULT_REMOTE_PORT

Описание:

Порт для удалённых подключений. Если значение не задано, используется порт по умолчанию для плагина подключения.

Тип:

integer

По умолчанию:

None

Ini:

Раздел:: [defaults]
Ключ:: remote_port

Окружение:

Переменная:: ANSIBLE_REMOTE_PORT

DEFAULT_REMOTE_USER

Описание:

Задаёт пользователя для входа на целевые машины. Если значение не задано, используется значение по умолчанию для плагина подключения — обычно пользователь, от имени которого запущен Ansible.

Ini:

Раздел:: [defaults]
Ключ:: remote_user

Окружение:

Переменная:: ANSIBLE_REMOTE_USER

DEFAULT_ROLES_PATH

Описание:

Пути, разделённые двоеточиями, по которым Ansible выполняет поиск ролей.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/roles:/usr/share/ansible/roles:/etc/ansible/roles" }}

Ini:

Раздел:: [defaults]
Ключ:: roles_path

Окружение:

Переменная:: ANSIBLE_ROLES_PATH

DEFAULT_SELINUX_SPECIAL_FS

Описание:

Некоторые файловые системы не поддерживают безопасные операции и/или возвращают непоследовательные ошибки. Этот параметр позволяет Ansible «терпимо» относиться к файловым системам из списка, не вызывая критических ошибок. При использовании файловой системы из списка возможно повреждение данных, а операции записи не всегда проверяются.

Тип:

list

По умолчанию:

['fuse', 'nfs', 'vboxsf', 'ramfs', '9p', 'vfat']

Ini:

Раздел:: [selinux]
Ключ:: special_context_filesystems

Окружение:

Переменная:: ANSIBLE_SELINUX_SPECIAL_FS
Добавлена в версии:: 2.9

DEFAULT_STDOUT_CALLBACK

Описание:

Задаёт основной callback, используемый для отображения вывода Ansible. Одновременно можно использовать только один такой callback. Можно использовать множество других callback, но только один из них может отвечать за стандартный вывод. Список доступных вариантов см. в разделе Плагины callback.

По умолчанию:

default

Ini:

Раздел:: [defaults]
Ключ:: stdout_callback

Окружение:

Переменная:: ANSIBLE_STDOUT_CALLBACK

DEFAULT_STRATEGY

Описание:

Задаёт стратегию, используемую по умолчанию для play.

По умолчанию:

linear

Добавлена в версии:

2.3

Ini:

Раздел:: [defaults]
Ключ:: strategy

Окружение:

Переменная:: ANSIBLE_STRATEGY

DEFAULT_STRATEGY_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины стратегий.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/strategy:/usr/share/ansible/plugins/strategy" }}

Ini:

Раздел:: [defaults]
Ключ:: strategy_plugins

Окружение:

Переменная:: ANSIBLE_STRATEGY_PLUGINS

DEFAULT_SU

Описание:

Включает или отключает использование «su» для задач.

Тип:

boolean

По умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: su

Окружение:

Переменная:: ANSIBLE_SU

DEFAULT_SYSLOG_FACILITY

Описание:

Категория syslog, используемая при записи Ansible в журнал на удалённом целевом узле.

По умолчанию:

LOG_USER

Ini:

Раздел:: [defaults]
Ключ:: syslog_facility

Окружение:

Переменная:: ANSIBLE_SYSLOG_FACILITY

DEFAULT_TERMINAL_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины терминала.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/terminal:/usr/share/ansible/plugins/terminal" }}

Ini:

Раздел:: [defaults]
Ключ:: terminal_plugins

Окружение:

Переменная:: ANSIBLE_TERMINAL_PLUGINS

DEFAULT_TEST_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible будет искать тестовые плагины Jinja2.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/test:/usr/share/ansible/plugins/test" }}

Ini:

Раздел:: [defaults]
Ключ:: test_plugins

Окружение:

Переменная:: ANSIBLE_TEST_PLUGINS

DEFAULT_TIMEOUT

Описание:

Значение времени ожидания, используемое по умолчанию плагинами подключений.

Тип:

integer

По умолчанию:

10

Ini:

Раздел:: [defaults]
Ключ:: timeout

Окружение:

Переменная:: ANSIBLE_TIMEOUT

DEFAULT_TRANSPORT

Описание:

Может быть любым плагином подключений, доступным в вашей установке Ansible.

По умолчанию:

ssh

Ini:

Раздел:: [defaults]
Ключ:: transport

Окружение:

Переменная:: ANSIBLE_TRANSPORT

DEFAULT_UNDEFINED_VAR_BEHAVIOR

Описание:

Если значение True, шаблонизация Ansible завершает выполнение шагов, в которых используются имена переменных, вероятно, содержащие опечатки. В противном случае любые выражения «{{ template_expression }}» с неопределёнными переменными будут выведены в шаблоне или строке действия Ansible без изменений.

Тип:

boolean

По умолчанию:

True

Добавлена в версии:

1.3

Ini:

Раздел:: [defaults]
Ключ:: error_on_undefined_vars

Окружение:

Переменная:: ANSIBLE_ERROR_ON_UNDEFINED_VARS

Примечание:

Этот параметр конфигурации устарел и запланирован к удалению. Следует перейти на актуальную альтернативу.

Запланированное удаление:

2.23

Причина устаревания:

Этот параметр больше не используется в кодовой базе Ansible Core.

Текущие альтернативы:

В настоящее время альтернативы нет. В кодовую базу потребуется добавить другой механизм.

DEFAULT_VARS_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины переменных.

Тип:

pathspec

Значение по умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/vars:/usr/share/ansible/plugins/vars" }}

Ini:

Раздел:: [defaults]
Ключ:: vars_plugins

Переменная окружения:

Переменная:: ANSIBLE_VARS_PLUGINS

DEFAULT_VAULT_ENCRYPT_IDENTITY

Описание:

Идентификатор vault_id, используемый по умолчанию для шифрования. Если указано несколько vault_id, этот параметр определяет, какой из них использовать для шифрования. Параметр CLI --encrypt-vault-id переопределяет настроенное значение.

Ini:

Раздел:: [defaults]
Ключ:: vault_encrypt_identity

Переменная окружения:

Переменная:: ANSIBLE_VAULT_ENCRYPT_IDENTITY

DEFAULT_VAULT_ID_MATCH

Описание:

Если значение равно true, при расшифровке хранилищ с идентификатором vault будут использоваться только пароли, соответствующие идентификатору vault.

Значение по умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: vault_id_match

Переменная окружения:

Переменная:: ANSIBLE_VAULT_ID_MATCH

DEFAULT_VAULT_IDENTITY

Описание:

Метка, используемая для метки идентификатора vault по умолчанию, если метка идентификатора vault не указана.

Значение по умолчанию:

default

Ini:

Раздел:: [defaults]
Ключ:: vault_identity

Переменная окружения:

Переменная:: ANSIBLE_VAULT_IDENTITY

DEFAULT_VAULT_IDENTITY_LIST

Описание:

Список идентификаторов vault, используемых по умолчанию. Эквивалент нескольких аргументов --vault-id. Идентификаторы vault проверяются по порядку.

Тип:

list

Значение по умолчанию:

[]

Ini:

Раздел:: [defaults]
Ключ:: vault_identity_list

Переменная окружения:

Переменная:: ANSIBLE_VAULT_IDENTITY_LIST

DEFAULT_VAULT_PASSWORD_FILE

Описание:

Файл с паролем vault, который нужно использовать. Эквивалент --vault-password-file или --vault-id. Если файл является исполняемым, он будет запущен, а полученный stdout будет использоваться в качестве пароля.

Тип:

path

Значение по умолчанию:

None

Ini:

Раздел:: [defaults]
Ключ:: vault_password_file

Переменная окружения:

Переменная:: ANSIBLE_VAULT_PASSWORD_FILE

DEFAULT_VERBOSITY

Описание:

Задаёт уровень подробности вывода по умолчанию, эквивалентный количеству -v, переданных в командной строке.

Тип:

integer

Значение по умолчанию:

0

Ini:

Раздел:: [defaults]
Ключ:: verbosity

Переменная окружения:

Переменная:: ANSIBLE_VERBOSITY

DEPRECATION_WARNINGS

Описание:

Включает или отключает отображение предупреждений об устаревших функциях.

Тип:

boolean

Значение по умолчанию:

True

Ini:

Раздел:: [defaults]
Ключ:: deprecation_warnings

Переменная окружения:

Переменная:: ANSIBLE_DEPRECATION_WARNINGS

Переменные:

имя:: ansible_deprecation_warnings
Добавлено в версии:: 2.19

DEVEL_WARNING

Описание:

Включает или отключает отображение предупреждений, связанных с запуском devel.

Тип:

boolean

Значение по умолчанию:

True

Ini:

Раздел:: [defaults]
Ключ:: devel_warning

Переменная окружения:

Переменная:: ANSIBLE_DEVEL_WARNING

DIFF_ALWAYS

Описание:

Параметр конфигурации, указывающий модулям показывать различия при статусе «изменено»; эквивалент --diff.

Тип:

bool

Значение по умолчанию:

False

Ini:

Раздел:: [diff]
Ключ:: always

Переменная окружения:

Переменная:: ANSIBLE_DIFF_ALWAYS

DIFF_CONTEXT

Описание:

Количество строк контекста, отображаемых при показе различий между файлами.

Тип:

integer

Значение по умолчанию:

3

Ini:

Раздел:: [diff]
Ключ:: context

Переменная окружения:

Переменная:: ANSIBLE_DIFF_CONTEXT

DISPLAY_ARGS_TO_STDOUT

Описание:

Обычно ansible-playbook выводит заголовок для каждой выполняемой задачи. В этих заголовках будет указано значение поля name из задачи, если вы его задали. Если нет, ansible-playbook использует действие задачи, чтобы помочь определить, какая задача выполняется в данный момент. Иногда выполняется много задач с одним и тем же действием, поэтому может понадобиться больше информации о задаче, чтобы отличать её от других задач с таким же действием. Если установить для этой переменной значение True в конфигурации, ansible-playbook также добавит в заголовок аргументы задачи. По умолчанию для этого параметра задано значение False, поскольку параметры могут содержать конфиденциальные данные, которые не должны выводиться. Если установить значение True, убедитесь, что стандартный вывод вашей среды защищён (никто не сможет подсмотреть информацию с вашего экрана, а стандартный вывод не сохраняется в незащищённый файл), или проверьте, что во всех ваших плейбуках к задачам с конфиденциальными данными явно добавлен параметр no_log: True. Дополнительную информацию см. в разделе Как хранить конфиденциальные данные в плейбуке?.

Тип:

boolean

По умолчанию:

False

Версия добавления:

2.1

Ini:

Раздел:: [defaults]
Ключ:: display_args_to_stdout

Переменная среды:

Переменная:: ANSIBLE_DISPLAY_ARGS_TO_STDOUT

DISPLAY_SKIPPED_HOSTS

Описание:

Переключатель, управляющий отображением пропущенных задач/узлов в задаче при использовании обработчика обратного вызова по умолчанию.

Тип:

boolean

По умолчанию:

True

Ini:

Раздел:: [defaults]
Ключ:: display_skipped_hosts

Переменная среды:

Переменная:: ANSIBLE_DISPLAY_SKIPPED_HOSTS

DISPLAY_TRACEBACK

Описание:

В каких случаях включать трассировки стека в расширенные сообщения об ошибках

Тип:

list

По умолчанию:

['never']

Допустимые значения:

error
warning
deprecated
deprecated_value
always
never

Версия добавления:

2.19

Ini:

Раздел:: [defaults]
Ключ:: display_traceback

Переменная среды:

Переменная:: ANSIBLE_DISPLAY_TRACEBACK

DOC_FRAGMENT_PLUGIN_PATH

Описание:

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины фрагментов документации.

Тип:

pathspec

По умолчанию:

{{ ANSIBLE_HOME ~ "/plugins/doc_fragments:/usr/share/ansible/plugins/doc_fragments" }}

Ini:

Раздел:: [defaults]
Ключ:: doc_fragment_plugins

Переменная среды:

Переменная:: ANSIBLE_DOC_FRAGMENT_PLUGINS

DOCSITE_ROOT_URL

Описание:

Корневой URL сайта документации, используемый для формирования URL документации в тексте предупреждений и ошибок; должен быть абсолютным URL с допустимой схемой и завершающей косой чертой.

По умолчанию:

https://docs.ansible.com/ansible-core/

Версия добавления:

2.8

Ini:

Раздел:: [defaults]
Ключ:: docsite_root_url

DUPLICATE_YAML_DICT_KEY

Описание:

По умолчанию Ansible выдаёт предупреждение, если в YAML обнаружен повторяющийся ключ словаря. Эти предупреждения можно отключить, установив для этого параметра значение False.

Тип:

string

По умолчанию:

warn

Допустимые значения:

error:

выдать фатальную ошибку и остановить выполнение плейбука
warn:

выдать предупреждение, но продолжить выполнение
ignore:

просто продолжить выполнение без сообщений

Версия добавления:

2.9

Ini:

Раздел:: [defaults]
Ключ:: duplicate_dict_key

Переменная среды:

Переменная:: ANSIBLE_DUPLICATE_YAML_DICT_KEY

EDITOR

Описание:

В случаях, когда Ansible необходимо открыть файл в редакторе, этот параметр задаёт используемое приложение.

По умолчанию:

vi

Ini:

Раздел:: [defaults]
Ключ:: editor
Версия добавления:: 2.15

Переменная среды:

Переменная:

ANSIBLE_EDITOR

Версия добавления:

2.15
Переменная:

EDITOR

ENABLE_TASK_DEBUGGER

Описание:

Включает или отключает отладчик задач. Ранее это поведение реализовывалось с помощью плагина стратегии. Теперь его могут наследовать все плагины стратегий. По умолчанию отладчик запускается, если задача завершается ошибкой из-за недоступности узла. Для большей гибкости используйте ключевое слово debugger.

Тип:

boolean

По умолчанию:

False

Версия добавления:

2.5

Ini:

Раздел:: [defaults]
Ключ:: enable_task_debugger

Переменная среды:

Переменная:: ANSIBLE_ENABLE_TASK_DEBUGGER

ERROR_ON_MISSING_HANDLER

Описание:

Переключатель, позволяющий выдавать предупреждение вместо ошибки при уведомлении об отсутствующем обработчике.

Тип:

boolean

По умолчанию:

True

Ini:

Раздел:: [defaults]
Ключ:: error_on_missing_handler

Переменная среды:

Переменная:: ANSIBLE_ERROR_ON_MISSING_HANDLER

FACTS_MODULES

Описание:

Какие модули запускать на этапе сбора фактов плейбука. При использовании значения по умолчанию ‘smart’ Ansible попытается определить подходящие модули на основе типа подключения. Если вы добавляете собственные модули, но хотите использовать факты Ansible по умолчанию, добавьте в список ‘setup’ или соответствующий сетевой модуль (если добавить ‘smart’, Ansible также определит его самостоятельно). Это не влияет на явные вызовы модуля ‘setup’, но всегда влияет на действие ‘gather_facts’ (неявное или явное).

Тип:

list

По умолчанию:

['smart']

Ini:

Секция:: [defaults]
Ключ:: facts_modules

Окружение:

Переменная:: ANSIBLE_FACTS_MODULES

Переменные:

name:: ansible_facts_modules

GALAXY_CACHE_DIR

Описание:

Каталог для хранения кэшированных ответов сервера Galaxy. Он используется только командами ansible-galaxy collection install и download. Файлы кэша в этом каталоге игнорируются, если к ним есть доступ на запись для всех пользователей.

Тип:

path

По умолчанию:

{{ ANSIBLE_HOME ~ "/galaxy_cache" }}

Добавлено в версии:

2.11

Ini:

Секция:: [galaxy]
Ключ:: cache_dir

Окружение:

Переменная:: ANSIBLE_GALAXY_CACHE_DIR

GALAXY_COLLECTION_IMPORT_POLL_FACTOR

Описание:

Множитель, используемый для увеличения интервала GALAXY_COLLECTION_IMPORT_POLL_INTERVAL при проверке состояния импорта коллекции.

Тип:

float

По умолчанию:

1.5

Добавлено в версии:

2.18

Окружение:

Переменная:: ANSIBLE_GALAXY_COLLECTION_IMPORT_POLL_FACTOR

GALAXY_COLLECTION_IMPORT_POLL_INTERVAL

Описание:

Начальный интервал в секундах между проверками состояния импорта коллекции. Этот интервал экспоненциально увеличивается в соответствии с параметром GALAXY_COLLECTION_IMPORT_POLL_FACTOR, максимальная задержка составляет 30 секунд.

Тип:

float

По умолчанию:

2.0

Добавлено в версии:

2.18

Окружение:

Переменная:: ANSIBLE_GALAXY_COLLECTION_IMPORT_POLL_INTERVAL

GALAXY_COLLECTION_SKELETON

Описание:

Каталог шаблона коллекции, используемый для действия init в ansible-galaxy collection; аналог --collection-skeleton.

Тип:

path

Ini:

Секция:: [galaxy]
Ключ:: collection_skeleton

Окружение:

Переменная:: ANSIBLE_GALAXY_COLLECTION_SKELETON

GALAXY_COLLECTION_SKELETON_IGNORE

Описание:

Шаблоны файлов, которые следует игнорировать в каталоге шаблона коллекции Galaxy.

Тип:

list

По умолчанию:

['^.git$', '^.*/.git_keep$']

Ini:

Секция:: [galaxy]
Ключ:: collection_skeleton_ignore

Окружение:

Переменная:: ANSIBLE_GALAXY_COLLECTION_SKELETON_IGNORE

GALAXY_COLLECTIONS_PATH_WARNING

Описание:

Следует ли ansible-galaxy collection install предупреждать об отсутствующих --collections-path в настроенном параметре COLLECTIONS_PATHS.

Тип:

bool

По умолчанию:

True

Добавлено в версии:

2.16

Ini:

Секция:: [galaxy]
Ключ:: collections_path_warning

Окружение:

Переменная:: ANSIBLE_GALAXY_COLLECTIONS_PATH_WARNING

GALAXY_DISABLE_GPG_VERIFY

Описание:

Отключить проверку подписи GPG при установке коллекций.

Тип:

bool

По умолчанию:

False

Добавлено в версии:

2.13

Ini:

Секция:: [galaxy]
Ключ:: disable_gpg_verify

Окружение:

Переменная:: ANSIBLE_GALAXY_DISABLE_GPG_VERIFY

GALAXY_DISPLAY_PROGRESS

Описание:

На некоторых этапах выполнения ansible-galaxy отображается индикатор выполнения, который может вызывать проблемы на некоторых дисплеях или при выводе stdout в файл. Этот параметр конфигурации определяет, отображать ли индикатор выполнения. По умолчанию индикатор отображается, если stdout подключён к tty.

Тип:

bool

По умолчанию:

None

Добавлено в версии:

2.10

Ini:

Секция:: [galaxy]
Ключ:: display_progress

Окружение:

Переменная:: ANSIBLE_GALAXY_DISPLAY_PROGRESS

GALAXY_GPG_KEYRING

Описание:

Настроить связку ключей для проверки подписи GPG при установке и проверке коллекций.

Тип:

path

Добавлено в версии:

2.13

Ini:

Секция:: [galaxy]
Ключ:: gpg_keyring

Окружение:

Переменная:: ANSIBLE_GALAXY_GPG_KEYRING

GALAXY_IGNORE_CERTS

Описание:

Если установлено значение yes, ansible-galaxy не будет проверять сертификаты TLS. Это может быть полезно для тестирования сервера с самоподписанным сертификатом.

Тип:

boolean

Ini:

Секция:: [galaxy]
Ключ:: ignore_certs

Окружение:

Переменная:: ANSIBLE_GALAXY_IGNORE

GALAXY_IGNORE_INVALID_SIGNATURE_STATUS_CODES

Описание:

Список кодов состояния GPG, которые следует игнорировать при проверке подписи GPG. Описания кодов состояния см. в L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes). Если успешно проверенных подписей коллекции окажется меньше, чем GALAXY_REQUIRED_VALID_SIGNATURE_COUNT, проверка подписи завершится с ошибкой, даже если игнорируются все коды ошибок.

Тип:

list

Варианты:

EXPSIG
EXPKEYSIG
REVKEYSIG
BADSIG
ERRSIG
NO_PUBKEY
MISSING_PASSPHRASE
BAD_PASSPHRASE
NODATA
UNEXPECTED
ERROR
FAILURE
BADARMOR
KEYEXPIRED
KEYREVOKED
NO_SECKEY

INI:

Секция:: [galaxy]
Ключ:: ignore_signature_status_codes

Переменные окружения:

Переменная:: ANSIBLE_GALAXY_IGNORE_SIGNATURE_STATUS_CODES

GALAXY_REQUIRED_VALID_SIGNATURE_COUNT

Описание:

Количество подписей, которые должны успешно пройти проверку GPG при установке или проверке коллекций. Значение должно быть положительным целым числом или all, чтобы указать, что все подписи должны успешно подтвердить подлинность коллекции. Добавьте к значению префикс +, чтобы операция завершалась с ошибкой, если для коллекции не найдено ни одной действительной подписи.

Тип:

str

По умолчанию:

1

INI:

Секция:: [galaxy]
Ключ:: required_valid_signature_count

Переменные окружения:

Переменная:: ANSIBLE_GALAXY_REQUIRED_VALID_SIGNATURE_COUNT

GALAXY_ROLE_SKELETON

Описание:

Каталог каркаса роли, используемый в качестве шаблона для действия init в ansible-galaxy/ansible-galaxy role; соответствует --role-skeleton.

Тип:

path

INI:

Секция:: [galaxy]
Ключ:: role_skeleton

Переменные окружения:

Переменная:: ANSIBLE_GALAXY_ROLE_SKELETON

GALAXY_ROLE_SKELETON_IGNORE

Описание:

Шаблоны файлов, которые следует игнорировать в каталоге каркаса роли или коллекции Galaxy.

Тип:

list

По умолчанию:

['^.git$', '^.*/.git_keep$']

INI:

Секция:: [galaxy]
Ключ:: role_skeleton_ignore

Переменные окружения:

Переменная:: ANSIBLE_GALAXY_ROLE_SKELETON_IGNORE

GALAXY_SERVER

Описание:

URL, добавляемый в начало, если в ролях не указан полный URI; предполагается, что в качестве источника используется этот сервер.

По умолчанию:

https://galaxy.ansible.com

INI:

Секция:: [galaxy]
Ключ:: server

Переменные окружения:

Переменная:: ANSIBLE_GALAXY_SERVER

GALAXY_SERVER_LIST

Описание:

Список серверов Galaxy, используемых при установке коллекции. Значение соответствует заголовку конфигурации INI [galaxy_server.{{item}}], в котором заданы сведения о сервере. Дополнительные сведения о настройке сервера Galaxy см. в разделе Настройка клиента ansible-galaxy. Порядок серверов в этом списке определяет порядок поиска коллекции. При задании этого параметра конфигурации параметр GALAXY_SERVER игнорируется.

Тип:

list

Добавлено в версии:

2.9

INI:

Секция:: [galaxy]
Ключ:: server_list

Переменные окружения:

Переменная:: ANSIBLE_GALAXY_SERVER_LIST

GALAXY_SERVER_TIMEOUT

Описание:

Значение времени ожидания по умолчанию для вызовов API Galaxy. Для серверов Galaxy, в которых не задано собственное значение времени ожидания, используется это значение.

Тип:

int

По умолчанию:

60

INI:

Секция:: [galaxy]
Ключ:: server_timeout

Переменные окружения:

Переменная:: ANSIBLE_GALAXY_SERVER_TIMEOUT

GALAXY_TOKEN_PATH

Описание:

Локальный путь к файлу токена доступа Galaxy

Тип:

path

По умолчанию:

{{ ANSIBLE_HOME ~ "/galaxy_token" }}

Добавлено в версии:

2.9

INI:

Секция:: [galaxy]
Ключ:: token_path

Переменные окружения:

Переменная:: ANSIBLE_GALAXY_TOKEN_PATH

HOST_KEY_CHECKING

Описание:

Установите значение “False”, если хотите отключить проверку ключей узлов, выполняемую используемым Ansible модулем подключения при соединении с узлом. Подробности см. в документации к используемому модулю подключения.

Тип:

boolean

По умолчанию:

True

INI:

Секция:: [defaults]
Ключ:: host_key_checking

Переменные окружения:

Переменная:: ANSIBLE_HOST_KEY_CHECKING

HOST_PATTERN_MISMATCH

Описание:

Этот параметр определяет поведение при несовпадении шаблонов узлов: можно вызвать критическую ошибку, вывести предупреждение или просто проигнорировать несовпадение.

По умолчанию:

warning

Варианты:

error:

выдать «фатальную» ошибку и остановить выполнение сценария
warning:

вывести предупреждение, но продолжить выполнение
ignore:

просто продолжить выполнение без сообщений

Добавлено в версии:

2.8

INI:

Секция:: [inventory]
Ключ:: host_pattern_mismatch

Переменные окружения:

Переменная:: ANSIBLE_HOST_PATTERN_MISMATCH

INJECT_FACTS_AS_VARS

Описание:

Факты доступны внутри переменной ansible_facts; эта настройка также добавляет их как отдельные переменные в основное пространство имён. В отличие от словаря ansible_facts, где префикс ansible_ удаляется из имён фактов, здесь они будут иметь точные имена, возвращаемые модулем.

Тип:

boolean

По умолчанию:

True

Добавлена в версии:

2.5

Ini:

Раздел:: [defaults]
Ключ:: inject_facts_as_vars

Среда:

Переменная:: ANSIBLE_INJECT_FACT_VARS

INJECT_INVOCATION

Описание:

Если параметр включён, в результат задачи будет добавлен ключ invocation с использованными аргументами модуля/действия. Большинство плагинов обратного вызова по умолчанию скрывают ключ invocation при отображении результата задачи.

Тип:

boolean

По умолчанию:

False

Добавлена в версии:

2.21

Ini:

Раздел:: [defaults]
Ключ:: inject_invocation

Среда:

Переменная:: ANSIBLE_INJECT_INVOCATION

Переменные:

имя:: ansible_inject_invocation

INTERPRETER_PYTHON

Описание:

Путь к интерпретатору Python, который будет использоваться для выполнения модулей на удалённых целевых узлах, или режим автоматического обнаружения. Поддерживаются режимы обнаружения auto (по умолчанию) и auto_silent. Все режимы обнаружения проверяют упорядоченный список известных расположений интерпретатора Python. При использовании резервного варианта будет выдано предупреждение о том, что интерпретатор следует задать явно (поскольку установка интерпретаторов позднее может повлиять на выбор используемого интерпретатора). Это предупреждение можно отключить, задав auto_silent. Режимы auto_legacy* удалены. Они сохранены для обратной совместимости со старыми выпусками Ansible, в которых по умолчанию всегда использовался /usr/bin/python3 и применялся этот интерпретатор, если он был установлен.

По умолчанию:

auto

Добавлена в версии:

2.8

Ini:

Раздел:: [defaults]
Ключ:: interpreter_python

Среда:

Переменная:: ANSIBLE_PYTHON_INTERPRETER

Переменные:

имя:: ansible_python_interpreter

INTERPRETER_PYTHON_FALLBACK

Тип:

list

По умолчанию:

['python3.14', 'python3.13', 'python3.12', 'python3.11', 'python3.10', 'python3.9', '/usr/bin/python3', 'python3']

Добавлена в версии:

2.8

Переменные:

имя:: ansible_interpreter_python_fallback

INVALID_TASK_ATTRIBUTE_FAILED

Описание:

Если значение — «false», недопустимые атрибуты задачи будут приводить к предупреждениям, а не к ошибкам.

Тип:

boolean

По умолчанию:

True

Добавлена в версии:

2.7

Ini:

Раздел:: [defaults]
Ключ:: invalid_task_attribute_failed

Среда:

Переменная:: ANSIBLE_INVALID_TASK_ATTRIBUTE_FAILED

INVENTORY_ANY_UNPARSED_IS_FAILED

Описание:

Если значение — «true», невозможность успешно разобрать любой источник инвентаризации с помощью доступных плагинов инвентаризации считается критической ошибкой; в противном случае это приводит лишь к предупреждению.

Тип:

boolean

По умолчанию:

False

Добавлена в версии:

2.7

Ini:

Раздел:: [inventory]
Ключ:: any_unparsed_is_failed

Среда:

Переменная:: ANSIBLE_INVENTORY_ANY_UNPARSED_IS_FAILED

INVENTORY_ENABLED

Описание:

Список включённых плагинов инвентаризации; он также определяет порядок их использования.

Тип:

list

По умолчанию:

['host_list', 'script', 'auto', 'yaml', 'ini', 'toml']

Ini:

Раздел:: [inventory]
Ключ:: enable_plugins

Среда:

Переменная:: ANSIBLE_INVENTORY_ENABLED

INVENTORY_EXPORT

Описание:

Определяет, будет ли ansible-inventory точно отражать представление Ansible об инвентаризации или будет оптимизирован для экспорта.

Тип:

bool

По умолчанию:

False

Ini:

Раздел:: [inventory]
Ключ:: export

Среда:

Переменная:: ANSIBLE_INVENTORY_EXPORT

INVENTORY_IGNORE_EXTS

Описание:

Список расширений, которые следует игнорировать при использовании каталога в качестве источника инвентаризации.

Тип:

list

По умолчанию:

{{ REJECT_EXTS + ['.orig', '.cfg', '.retry'] }}

Ini:

Раздел:

[defaults]

Ключ:

inventory_ignore_extensions
Раздел:

[inventory]

Ключ:

ignore_extensions

Среда:

Переменная:: ANSIBLE_INVENTORY_IGNORE

INVENTORY_IGNORE_PATTERNS

Описание:

Список шаблонов, которые следует игнорировать при использовании каталога в качестве источника инвентаризации.

Тип:

list

По умолчанию:

[]

Ini:

Раздел:

[defaults]

Ключ:

inventory_ignore_patterns
Раздел:

[inventory]

Ключ:

ignore_patterns

Среда:

Переменная:: ANSIBLE_INVENTORY_IGNORE_REGEX

INVENTORY_UNPARSED_IS_FAILED

Описание:

Если значение равно «true», возникнет критическая ошибка, если не удастся разобрать ни один из потенциальных источников инвентаризации; в противном случае будет выведено предупреждение.

Тип:

bool

По умолчанию:

False

Ini:

Раздел:: [inventory]
Ключ:: unparsed_is_failed

Переменные среды:

Переменная:: ANSIBLE_INVENTORY_UNPARSED_FAILED

INVENTORY_UNPARSED_WARNING

Описание:

По умолчанию Ansible выдает предупреждение, если инвентаризация не была загружена, и сообщает, что будет использовать неявную инвентаризацию только с localhost. Эти предупреждения можно отключить, установив для этого параметра значение False.

Тип:

boolean

По умолчанию:

True

Добавлено в версии:

2.14

Ini:

Раздел:: [inventory]
Ключ:: inventory_unparsed_warning

Переменные среды:

Переменная:: ANSIBLE_INVENTORY_UNPARSED_WARNING

LOCALHOST_WARNING

Описание:

По умолчанию Ansible выдает предупреждение, если в инвентаризации нет узлов. Эти предупреждения можно отключить, установив для этого параметра значение False.

Тип:

boolean

По умолчанию:

True

Добавлено в версии:

2.6

Ini:

Раздел:: [defaults]
Ключ:: localhost_warning

Переменные среды:

Переменная:: ANSIBLE_LOCALHOST_WARNING

LOG_VERBOSITY

Описание:

Этот параметр задает подробность журнала, если она выше обычной подробности отображения; в противном случае она будет ей соответствовать.

Тип:

int

Добавлено в версии:

2.17

Ini:

Раздел:: [defaults]
Ключ:: log_verbosity

Переменные среды:

Переменная:: ANSIBLE_LOG_VERBOSITY

MAX_FILE_SIZE_FOR_DIFF

Описание:

Максимальный размер файлов, для которых отображаются различия.

Тип:

int

По умолчанию:

104448

Ini:

Раздел:: [defaults]
Ключ:: max_diff_size

Переменные среды:

Переменная:: ANSIBLE_MAX_DIFF_SIZE

MODULE_IGNORE_EXTS

Описание:

Список расширений, которые следует игнорировать при поиске загружаемых модулей. Это позволяет отклонять резервные расширения скриптовых и двоичных модулей.

Тип:

list

По умолчанию:

{{ REJECT_EXTS + ['.yaml', '.yml', '.ini'] }}

Ini:

Раздел:: [defaults]
Ключ:: module_ignore_exts

Переменные среды:

Переменная:: ANSIBLE_MODULE_IGNORE_EXTS

MODULE_STRICT_UTF8_RESPONSE

Описание:

Включает проверку ответов модулей на наличие данных, не соответствующих UTF-8. Отключение этой проверки может привести к непредвиденному поведению. Оценивать эту конфигурацию должен только ansible-core.

Тип:

bool

По умолчанию:

True

Ini:

Раздел:: [defaults]
Ключ:: module_strict_utf8_response

Переменные среды:

Переменная:: ANSIBLE_MODULE_STRICT_UTF8_RESPONSE

NETCONF_SSH_CONFIG

Описание:

Эта переменная используется для включения бастионного/промежуточного узла при подключении по netconf. Если задано значение True, настройки SSH бастионного/промежуточного узла должны быть указаны в файле ~/.ssh/config; в качестве альтернативы можно задать путь к пользовательскому файлу конфигурации SSH, из которого будут считываться настройки бастионного/промежуточного узла.

По умолчанию:

None

Ini:

Раздел:: [netconf_connection]
Ключ:: ssh_config

Переменные среды:

Переменная:: ANSIBLE_NETCONF_SSH_CONFIG

NETWORK_GROUP_MODULES

Тип:

list

По умолчанию:

['eos', 'nxos', 'ios', 'iosxr', 'junos', 'enos', 'ce', 'vyos', 'sros', 'dellos9', 'dellos10', 'dellos6', 'asa', 'aruba', 'aireos', 'bigip', 'ironware', 'onyx', 'netconf', 'exos', 'voss', 'slxos']

Ini:

Раздел:: [defaults]
Ключ:: network_group_modules

Переменные среды:

Переменная:: ANSIBLE_NETWORK_GROUP_MODULES

OLD_PLUGIN_CACHE_CLEARING

Описание:

Ранее Ansible очищал только некоторые кэши загрузки плагинов при загрузке новых ролей. Это приводило к тому, что плагин, загруженный в предыдущих задачах, неожиданно оставался активным. Этот параметр позволяет вернуться к такому поведению.

Тип:

boolean

По умолчанию:

False

Добавлено в версии:

2.8

Ini:

Раздел:: [defaults]
Ключ:: old_plugin_cache_clear

Переменные среды:

Переменная:: ANSIBLE_OLD_PLUGIN_CACHE_CLEAR

PERSISTENT_COMMAND_TIMEOUT

Описание:

Этот параметр задаёт время ожидания ответа от удалённого устройства до истечения времени ожидания постоянного подключения.

Тип:

int

По умолчанию:

30

Ini:

Раздел:: [persistent_connection]
Ключ:: command_timeout

Окружение:

Переменная:: ANSIBLE_PERSISTENT_COMMAND_TIMEOUT

PERSISTENT_CONNECT_RETRY_TIMEOUT

Описание:

Этот параметр задаёт время ожидания повторного подключения постоянного соединения к локальному доменному сокету.

Тип:

integer

По умолчанию:

15

Ini:

Раздел:: [persistent_connection]
Ключ:: connect_retry_timeout

Окружение:

Переменная:: ANSIBLE_PERSISTENT_CONNECT_RETRY_TIMEOUT

PERSISTENT_CONNECT_TIMEOUT

Описание:

Этот параметр задаёт, как долго постоянное соединение может оставаться неактивным, прежде чем оно будет закрыто.

Тип:

integer

По умолчанию:

30

Ini:

Раздел:: [persistent_connection]
Ключ:: connect_timeout

Окружение:

Переменная:: ANSIBLE_PERSISTENT_CONNECT_TIMEOUT

PERSISTENT_CONTROL_PATH_DIR

Описание:

Путь к сокету, используемому системой постоянных подключений.

Тип:

path

По умолчанию:

{{ ANSIBLE_HOME ~ "/pc" }}

Ini:

Раздел:: [persistent_connection]
Ключ:: control_path_dir

Окружение:

Переменная:: ANSIBLE_PERSISTENT_CONTROL_PATH_DIR

PLAYBOOK_DIR

Описание:

Некоторые CLI-команды, не связанные с плейбуками, принимают аргумент --playbook-dir; этот параметр задаёт для него значение по умолчанию.

Тип:

path

Добавлено в версии:

2.9

Ini:

Раздел:: [defaults]
Ключ:: playbook_dir

Окружение:

Переменная:: ANSIBLE_PLAYBOOK_DIR

PLAYBOOK_VARS_ROOT

Описание:

Этот параметр задаёт, какие каталоги плейбуков будут использоваться в качестве корневых для обработки плагинов переменных, включая поиск host_vars/group_vars.

По умолчанию:

top

Варианты:

top:

соответствует традиционному поведению: корневой каталог определяется по верхнему плейбуку в цепочке.
bottom:

соответствует поведению версии 2.4.0: корневой каталог определяется по текущему плейбуку.
all:

проверяет все плейбуки от первого родительского до текущего.

Добавлено в версии:

2.4.1

Ini:

Раздел:: [defaults]
Ключ:: playbook_vars_root

Окружение:

Переменная:: ANSIBLE_PLAYBOOK_VARS_ROOT

PLUGIN_FILTERS_CFG

Описание:

Путь к файлу конфигурации, определяющему, какие установленные в системе плагины разрешено использовать. Подробнее о формате файла фильтра см. в разделе Отклонение модулей. Значение по умолчанию: /etc/ansible/plugin_filters.yml

Тип:

path

По умолчанию:

None

Добавлено в версии:

2.5.0

Ini:

Раздел:: [defaults]
Ключ:: plugin_filters_cfg

PYTHON_MODULE_RLIMIT_NOFILE

Описание:

При выполнении модулей Python пытается установить мягкое ограничение RLIMIT_NOFILE в указанное значение (это может ускорить использование подпроцессов в Python 2.x. См. https://bugs.python.org/issue11284). Значение ограничивается существующим жёстким лимитом. Значение по умолчанию 0 означает, что изменение существующих системных ограничений не выполняется.

По умолчанию:

0

Добавлено в версии:

2.8

Ini:

Раздел:: [defaults]
Ключ:: python_module_rlimit_nofile

Окружение:

Переменная:: ANSIBLE_PYTHON_MODULE_RLIMIT_NOFILE

Переменные:

имя:: ansible_python_module_rlimit_nofile

RETRY_FILES_ENABLED

Описание:

Этот параметр определяет, должен ли при сбое плейбука Ansible создаваться файл .retry.

Тип:

bool

По умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: retry_files_enabled

Окружение:

Переменная:: ANSIBLE_RETRY_FILES_ENABLED

RETRY_FILES_SAVE_PATH

Описание:

Этот параметр задаёт путь, по которому Ansible сохраняет файлы .retry при сбое плейбука, если создание файлов повторной попытки включено. После каждого запуска этот файл перезаписывается списком узлов, на которых произошёл сбой во всех плейбуках.

Тип:

path

По умолчанию:

None

Ini:

Раздел:: [defaults]
Ключ:: retry_files_save_path

Окружение:

Переменная:: ANSIBLE_RETRY_FILES_SAVE_PATH

RUN_VARS_PLUGINS

Описание:

Этот параметр можно использовать для оптимизации использования vars_plugin в зависимости от размера инвентаря пользователя и выбранных плейбуков.

Тип:

str

По умолчанию:

demand

Варианты:

demand:

будет запускать vars_plugins для источников инвентаря каждый раз, когда задачи «запрашивают» переменные.
start:

будет запускать vars_plugins для источников инвентаря после импорта этого источника инвентаря.

Добавлено в версии:

2.10

Ini:

Раздел:: [defaults]
Ключ:: run_vars_plugins

Окружение:

Переменная:: ANSIBLE_RUN_VARS_PLUGINS

SHOW_CUSTOM_STATS

Описание:

Добавляет пользовательскую статистику, заданную с помощью плагина set_stats, в вывод по умолчанию.

Тип:

bool

По умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: show_custom_stats

Окружение:

Переменная:: ANSIBLE_SHOW_CUSTOM_STATS

SSH_AGENT

Описание:

Управление SSH Agent с помощью Ansible. Конфигурация none не будет взаимодействовать с агентом, auto запустит и завершит работу агента с помощью исполняемого файла ssh-agent во время выполнения, а путь к SSH_AUTH_SOCK позволит взаимодействовать с уже запущенным агентом.

Тип:

string

По умолчанию:

none

Добавлено в версии:

2.19

Ini:

Раздел:: [connection]
Ключ:: ssh_agent

Окружение:

Переменная:: ANSIBLE_SSH_AGENT

SSH_AGENT_EXECUTABLE

Описание:

Если SSH_AGENT равно auto, путь или имя исполняемого файла ssh agent, который необходимо запустить.

Тип:

str

По умолчанию:

ssh-agent

Добавлено в версии:

2.19

Ini:

Раздел:: [connection]
Ключ:: ssh_agent_executable

Окружение:

Переменная:: ANSIBLE_SSH_AGENT_EXECUTABLE

SSH_AGENT_KEY_LIFETIME

Описание:

Для ключей, добавленных в агент, заданный параметром SSH_AGENT, укажите время в секундах, в течение которого ключ может оставаться в агенте.

Тип:

int

Добавлено в версии:

2.19

Ini:

Раздел:: [connection]
Ключ:: ssh_agent_key_lifetime

Окружение:

Переменная:: ANSIBLE_SSH_AGENT_KEY_LIFETIME

STRING_TYPE_FILTERS

Описание:

Этот список фильтров предотвращает «преобразование типов» при шаблонизации переменных. Полезно, когда требуется избежать преобразования строк JSON, например, в списки или словари.

Тип:

list

По умолчанию:

['string', 'to_json', 'to_nice_json', 'to_yaml', 'to_nice_yaml', 'ppretty', 'json']

Ini:

Раздел:: [jinja2]
Ключ:: dont_type_filters

Окружение:

Переменная:: ANSIBLE_STRING_TYPE_FILTERS

Примечание:

Эта конфигурация устарела и запланирована к удалению. Следует перейти на актуальную альтернативу.

Запланированное удаление:

2.23

Причина устаревания:

Этот параметр не оказывает влияния.

Текущие альтернативы:

Нет; исходные типы, возвращаемые фильтрами, всегда сохраняются.

SYSTEM_WARNINGS

Описание:

Позволяет отключить предупреждения о потенциальных проблемах в системе, на которой запущен сам Ansible (а не на управляемых узлах). К ним могут относиться предупреждения о сторонних пакетах и других условиях, которые по возможности следует устранить.

Тип:

boolean

По умолчанию:

True

Ini:

Раздел:: [defaults]
Ключ:: system_warnings

Окружение:

Переменная:: ANSIBLE_SYSTEM_WARNINGS

TAGS_RUN

Описание:

список тегов, запускаемых по умолчанию в плейбуках; пропускаемые теги имеют приоритет.

Тип:

list

По умолчанию:

[]

Добавлено в версии:

2.5

Ini:

Раздел:: [tags]
Ключ:: run

Окружение:

Переменная:: ANSIBLE_RUN_TAGS

TAGS_SKIP

Описание:

список тегов, пропускаемых по умолчанию в плейбуках; имеет приоритет над запускаемыми тегами.

Тип:

list

По умолчанию:

[]

Добавлено в версии:

2.5

Ini:

Раздел:: [tags]
Ключ:: skip

Окружение:

Переменная:: ANSIBLE_SKIP_TAGS

TARGET_LOG_INFO

Описание:

Строка, добавляемая в журнал целевого узла для отслеживания

Добавлено в версии:

2.17

Ini:

Раздел:: [defaults]
Ключ:: target_log_info

Окружение:

Переменная:: ANSIBLE_TARGET_LOG_INFO

Переменные:

name:: ansible_target_log_info

TASK_DEBUGGER_IGNORE_ERRORS

Описание:

Этот параметр определяет, будет ли запускаться отладчик задач для задачи, завершившейся с ошибкой, если указано ignore_errors=True. Значение True означает, что отладчик будет учитывать ignore_errors, а значение False — что не будет.

Тип:

boolean

По умолчанию:

True

Добавлено в версии:

2.7

Ini:

Раздел:: [defaults]
Ключ:: task_debugger_ignore_errors

Окружение:

Переменная:: ANSIBLE_TASK_DEBUGGER_IGNORE_ERRORS

TASK_TIMEOUT

Описание:

Задаёт максимальное время (в секундах) выполнения действия задачи. Тайм-аут действует независимо от шаблонизации и циклов. Он применяется к каждой попытке выполнения действия задачи и не зависит от общего времени, затраченного на задачу. Если выполнение действия превысит тайм-аут, Ansible прервёт процесс. Это регистрируется как сбой, вызванный внешними обстоятельствами, а не как ошибка задачи, чтобы обеспечить соответствующую обработку и восстановление. Если задано значение 0 (по умолчанию), тайм-аут отсутствует.

Тип:

integer

По умолчанию:

0

Добавлено в версии:

2.10

Ini:

Раздел:: [defaults]
Ключ:: task_timeout

Окружение:

Переменная:: ANSIBLE_TASK_TIMEOUT

TRANSFORM_INVALID_GROUP_CHARS

Описание:

Указывает Ansible преобразовывать недопустимые символы в именах групп, полученных из источников инвентаря.

Тип:

string

По умолчанию:

never

Варианты:

always:

заменять все недопустимые символы на «_» (подчёркивание) и предупреждать пользователя
never:

разрешать такое имя группы, но предупреждать о проблеме
ignore:

действовать так же, как при значении ‘never’, но не выдавать предупреждение
silently:

действовать так же, как при значении ‘always’, но не выдавать предупреждение

Добавлено в версии:

2.8

Ini:

Раздел:: [defaults]
Ключ:: force_valid_group_names

Окружение:

Переменная:: ANSIBLE_TRANSFORM_INVALID_GROUP_CHARS

USE_PERSISTENT_CONNECTIONS

Описание:

Включает или отключает использование постоянных подключений.

Тип:

boolean

По умолчанию:

False

Ini:

Раздел:: [defaults]
Ключ:: use_persistent_connections

Окружение:

Переменная:: ANSIBLE_USE_PERSISTENT_CONNECTIONS

VALIDATE_ACTION_GROUP_METADATA

Описание:

Переключатель, позволяющий отключить проверку записи ‘metadata’ в коллекции для группы действий module_defaults. Если этот параметр имеет значение True, метаданные с неожиданными полями или типами значений вызовут предупреждение.

Тип:

bool

По умолчанию:

True

Добавлено в версии:

2.12

Ini:

Раздел:: [defaults]
Ключ:: validate_action_group_metadata

Окружение:

Переменная:: ANSIBLE_VALIDATE_ACTION_GROUP_METADATA

VARIABLE_PLUGINS_ENABLED

Описание:

Принимает список плагинов переменных, которым он необходим.

Тип:

list

По умолчанию:

['host_group_vars']

Добавлено в версии:

2.10

Ini:

Раздел:: [defaults]
Ключ:: vars_plugins_enabled

Окружение:

Переменная:: ANSIBLE_VARS_ENABLED

VARIABLE_PRECEDENCE

Описание:

Позволяет изменить порядок слияния переменных групп по приоритету.

Тип:

list

По умолчанию:

['all_inventory', 'groups_inventory', 'all_plugins_inventory', 'all_plugins_play', 'groups_plugins_inventory', 'groups_plugins_play']

Добавлено в версии:

2.4

Ini:

Раздел:: [defaults]
Ключ:: precedence

Окружение:

Переменная:: ANSIBLE_PRECEDENCE

VAULT_ENCRYPT_SALT

Описание:

Соль, используемая для шифрования vault. Если она не указана, будет использоваться случайная соль.

По умолчанию:

None

Добавлено в версии:

2.15

Ini:

Раздел:: [defaults]
Ключ:: vault_encrypt_salt

Окружение:

Переменная:: ANSIBLE_VAULT_ENCRYPT_SALT

VERBOSE_TO_STDERR

Описание:

Принудительно направляет вывод параметра ‘verbose’ в stderr вместо stdout

Тип:

bool

По умолчанию:

False

Добавлено в версии:

2.8

Ini:

Раздел:: [defaults]
Ключ:: verbose_to_stderr

Окружение:

Переменная:: ANSIBLE_VERBOSE_TO_STDERR

WIN_ASYNC_STARTUP_TIMEOUT

Описание:

Для асинхронных задач в Ansible (описанных в разделе «Асинхронные действия и опрос») этот параметр задаёт время ожидания в секундах, в течение которого задача, запущенная Ansible, должна подключиться к именованному каналу, используемому в системах Windows. Значение по умолчанию — 5 секунд. Для медленных систем или систем с высокой нагрузкой этого времени может быть недостаточно. Это не общее время выполнения асинхронной команды, а отдельный тайм-аут ожидания её запуска. Отсчёт async_timeout для задачи начинается только после подключения к каналу, поэтому указанное здесь время увеличивает максимальную общую продолжительность выполнения задачи.

Тип:

integer

По умолчанию:

5

Добавлено в версии:

2.10

Ini:

Раздел:: [defaults]
Ключ:: win_async_startup_timeout

Окружение:

Переменная:: ANSIBLE_WIN_ASYNC_STARTUP_TIMEOUT

Переменные:

Имя:: ansible_win_async_startup_timeout

WORKER_SESSION_ISOLATION

Описание:

По умолчанию рабочие процессы Ansible, запускаемые через fork, выполняются в отдельных сессиях, чтобы избежать конфликтов при использовании общих TTY. Если требуется доступ к унаследованному TTY родительского процесса, задайте для этого параметра значение false, чтобы отключить изоляцию сессий. Отключение изоляции сессий следует ограничивать минимально возможной областью действия, задавая переменную ansible_worker_session_isolation для отдельных задач, блоков, сценариев, ролей или узлов по мере необходимости.

Тип:

boolean

Значение по умолчанию:

True

Добавлено в версии:

2.21

Ini:

Раздел:: [defaults]
Ключ:: worker_session_isolation

Окружение:

Переменная:: ANSIBLE_WORKER_SESSION_ISOLATION

Переменные:

имя:: ansible_worker_session_isolation

WORKER_SHUTDOWN_POLL_COUNT

Описание:

Максимальное количество проверок рабочих процессов Task Queue Manager, чтобы убедиться, что они завершились корректно. После достижения этого предела все ещё работающие процессы будут принудительно завершены. Этот параметр предназначен только для внутреннего использования.

Тип:

integer

Значение по умолчанию:

0

Добавлено в версии:

2.10

Окружение:

Переменная:: ANSIBLE_WORKER_SHUTDOWN_POLL_COUNT

WORKER_SHUTDOWN_POLL_DELAY

Описание:

Количество секунд ожидания между циклами опроса при проверке рабочих процессов Task Queue Manager, чтобы убедиться, что они завершились корректно. Этот параметр предназначен только для внутреннего использования.

Тип:

float

Значение по умолчанию:

0.1

Добавлено в версии:

2.10

Окружение:

Переменная:: ANSIBLE_WORKER_SHUTDOWN_POLL_DELAY

YAML_FILENAME_EXTENSIONS

Описание:

Проверяйте все эти расширения при поиске файлов «переменных», которые должны иметь формат YAML или JSON либо быть зашифрованными версиями этих форматов. Это влияет, среди прочего, на vars_files, include_vars, inventory и плагины vars.

Тип:

list

Значение по умолчанию:

['.yml', '.yaml', '.json']

Ini:

Раздел:: [defaults]
Ключ:: yaml_valid_extensions

Окружение:

Переменная:: ANSIBLE_YAML_FILENAME_EXT

Переменные окружения

Другие переменные окружения для настройки плагинов в коллекциях можно найти в Указатель всех переменных окружения коллекций.

ANSIBLE_CONFIG: Переопределяет файл конфигурации Ansible по умолчанию

ANSIBLE_ALLOW_BROKEN_CONDITIONALS

Если этот параметр включен, он позволяет использовать условные выражения с результатами, не являющимися логическими значениями. В таких случаях будет выдано предупреждение об устаревании. По умолчанию условные выражения с результатами, не являющимися логическими значениями, приводят к ошибке. Такие результаты часто указывают на непреднамеренное использование шаблонов там, где они не поддерживаются, что приводит к условию, которое всегда истинно. Если этот параметр включен, условные выражения, представляющие собой литерал None или пустую строку, будут считаться истинными для обратной совместимости.

См. также ALLOW_BROKEN_CONDITIONALS

ANSIBLE_ALLOW_EMBEDDED_TEMPLATES

Если этот параметр включен, он позволяет использовать встроенные шаблоны в определенных сценариях для обратной совместимости. В таких случаях будет выдано предупреждение об устаревании. Во-первых, условные выражения (например, failed_when, until, assert.that), полностью заключенные в разделители шаблона. Во-вторых, строковые константы в условных выражениях (например, when: some_var == '{{ some_other_var }}'). Наконец, позиционные аргументы для поисковых плагинов (например, lookup('pipe', 'echo {{ some_var }}')). Эта возможность устарела, поскольку в таких случаях встроенные шаблоны не нужны. Если параметр отключен, использование встроенных шаблонов приведет к ошибке. В будущей версии эта возможность будет отключена по умолчанию.

См. также ALLOW_EMBEDDED_TEMPLATES

ANSIBLE_HOME

Корневой путь по умолчанию для файлов конфигурации Ansible на управляющем узле.

См. также ANSIBLE_HOME

ANSIBLE_CONNECTION_PATH

Указывает, где искать скрипт ansible-connection. Это расположение будет проверено до поиска в $PATH. Если значение равно null, Ansible запустится из того же каталога, что и скрипт ansible.

См. также ANSIBLE_CONNECTION_PATH

ANSIBLE_COW_SELECTION

Позволяет выбрать конкретный трафарет cowsay для баннеров или указать «random», чтобы циклически перебирать их.

См. также ANSIBLE_COW_SELECTION

ANSIBLE_COW_ACCEPTLIST

Принимает список шаблонов cowsay, которые считаются «безопасными» для использования. Укажите пустой список, если хотите разрешить все установленные шаблоны.

См. также ANSIBLE_COW_ACCEPTLIST

Добавлено в версии:: 2.11

ANSIBLE_FORCE_COLOR

Этот параметр принудительно включает цветной режим даже при запуске без TTY или если настройка «nocolor» имеет значение True.

См. также ANSIBLE_FORCE_COLOR

ANSIBLE_NOCOLOR

Этот параметр позволяет отключить раскрашивание вывода, которое используется для более наглядного отображения сведений об ошибках и состоянии.

См. также ANSIBLE_NOCOLOR

NO_COLOR

См. также ANSIBLE_NOCOLOR

Добавлено в версии:: 2.11

ANSIBLE_NOCOWS

Если у вас установлен cowsay, но вы хотите избежать появления «коров» (почему????), используйте этот параметр.

См. также ANSIBLE_NOCOWS

ANSIBLE_COW_PATH

Указывает пользовательский путь к cowsay или позволяет использовать выбранную вами реализацию cowsay.

См. также ANSIBLE_COW_PATH

ANSIBLE_PIPELINING

Это глобальный параметр. Каждый плагин подключения может переопределить его, задав более конкретные параметры, или не поддерживать конвейеризацию вовсе. Если плагин подключения поддерживает конвейеризацию, она сокращает число сетевых операций, необходимых для выполнения модуля на удаленном сервере, позволяя выполнять множество модулей Ansible без фактической передачи файлов. При включении она может значительно повысить производительность. Однако это несовместимо с повышением привилегий (become). Например, при использовании операций «sudo:» необходимо сначала отключить «requiretty» в /etc/sudoers на всех управляемых узлах, поэтому по умолчанию этот параметр отключен. Эта настройка будет отключена, если включен ANSIBLE_KEEP_REMOTE_FILES.

См. также ANSIBLE_PIPELINING

ANSIBLE_ANY_ERRORS_FATAL

Задает значение по умолчанию для ключевого слова any_errors_fatal. Если значение равно True, сбои задач будут считаться критическими ошибками.

См. также ANY_ERRORS_FATAL

ANSIBLE_BECOME_ALLOW_SAME_USER

Если False``(default), Ansible will skip using become if the remote user is the same as the become user, as this is normally a redundant operation. In other words root sudo to root.If ``True, этот параметр принудительно заставляет Ansible использовать плагин become, поскольку в некоторых случаях это необходимо.

См. также BECOME_ALLOW_SAME_USER

ANSIBLE_BECOME_PASSWORD_FILE

Файл пароля, используемый плагином become. --become-password-file. Если файл является исполняемым, он будет запущен, а полученные данные stdout будут использоваться в качестве пароля.

См. также BECOME_PASSWORD_FILE

ANSIBLE_AGNOSTIC_BECOME_PROMPT

Отображает универсальный запрос become вместо запроса, содержащего переданный метод become из командной строки.

См. также AGNOSTIC_BECOME_PROMPT

ANSIBLE_CACHE_PLUGIN

Выбирает используемый плагин кэширования фактов. По умолчанию кэширование не используется, и факты не сохраняются между запусками.

См. также CACHE_PLUGIN

ANSIBLE_CACHE_PLUGIN_CONNECTION

Задает сведения о подключении или пути для плагина кэширования фактов.

См. также CACHE_PLUGIN_CONNECTION

ANSIBLE_CACHE_PLUGIN_PREFIX

Префикс для файлов/таблиц плагина кэширования фактов.

См. также CACHE_PLUGIN_PREFIX

ANSIBLE_CACHE_PLUGIN_TIMEOUT

Время ожидания до истечения срока действия данных плагина кэширования фактов.

См. также CACHE_PLUGIN_TIMEOUT

ANSIBLE_COLLECTIONS_SCAN_SYS_PATH

Логический параметр для включения или отключения поиска установленных коллекций в sys.path.

См. также COLLECTIONS_SCAN_SYS_PATH

ANSIBLE_COLLECTIONS_PATH

Пути, разделенные двоеточиями, в которых Ansible будет искать содержимое коллекций. Коллекции должны находиться во вложенных подкаталогах, а не непосредственно в этих каталогах. Например, если COLLECTIONS_PATHS содержит '{{ ANSIBLE_HOME ~ "/collections" }}' и вы хотите добавить my.collection в этот каталог, его необходимо сохранить как '{{ ANSIBLE_HOME ~ "/collections/ansible_collections/my/collection" }}'.

См. также COLLECTIONS_PATHS

Добавлено в версии:: 2.10

ANSIBLE_COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH

При загрузке коллекции, не поддерживающей используемую версию Ansible (с ключом метаданных коллекции requires_ansible).

См. также COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH

ANSIBLE_COLOR_CHANGED

Задает цвет для состояния задачи «Изменено».

См. также COLOR_CHANGED

ANSIBLE_COLOR_CONSOLE_PROMPT

Задает цвет по умолчанию для ansible-console.

См. также COLOR_CONSOLE_PROMPT

ANSIBLE_COLOR_DEBUG

Задает цвет для сообщений отладки.

См. также COLOR_DEBUG

ANSIBLE_COLOR_DEPRECATE

Задает цвет для сообщений об устаревании.

См. также COLOR_DEPRECATE

ANSIBLE_COLOR_DIFF_ADD

Задает цвет для добавленных строк в различиях.

См. также COLOR_DIFF_ADD

ANSIBLE_COLOR_DIFF_LINES

Задает цвет для отображения различий.

См. также COLOR_DIFF_LINES

ANSIBLE_COLOR_DIFF_REMOVE

Задает цвет для удаленных строк в различиях.

См. также COLOR_DIFF_REMOVE

ANSIBLE_COLOR_ERROR

Задает цвет для сообщений об ошибках.

См. также COLOR_ERROR

ANSIBLE_COLOR_HIGHLIGHT

Задает цвет для выделения.

См. также COLOR_HIGHLIGHT

ANSIBLE_COLOR_INCLUDED

Задает цвет для состояния задачи «Включено».

См. также COLOR_INCLUDED

ANSIBLE_COLOR_OK

Задает цвет для состояния задачи «ОК».

См. также COLOR_OK

ANSIBLE_COLOR_SKIP

Задает цвет для состояния задачи «Пропущено».

См. также COLOR_SKIP

ANSIBLE_COLOR_UNREACHABLE

Определяет цвет для статуса «Недоступен».

См. также COLOR_UNREACHABLE

ANSIBLE_COLOR_VERBOSE

Определяет цвет для вывода подробных сообщений, то есть сообщений, отображаемых с параметрами «-v».

См. также COLOR_VERBOSE

ANSIBLE_COLOR_WARN

Определяет цвет для вывода предупреждений.

См. также COLOR_WARN

ANSIBLE_COLOR_DOC_MODULE

Определяет цвет для вывода имени модуля в выводе ansible-doc.

См. также COLOR_DOC_MODULE

ANSIBLE_COLOR_DOC_REFERENCE

Определяет цвет для вывода перекрёстных ссылок в выводе ansible-doc.

См. также COLOR_DOC_REFERENCE

ANSIBLE_COLOR_DOC_LINK

Определяет цвет для вывода ссылок в выводе ansible-doc.

См. также COLOR_DOC_LINK

ANSIBLE_COLOR_DOC_DEPRECATED

Определяет цвет для вывода устаревших значений в выводе ansible-doc.

См. также COLOR_DOC_DEPRECATED

ANSIBLE_COLOR_DOC_CONSTANT

Определяет цвет для вывода констант в выводе ansible-doc.

См. также COLOR_DOC_CONSTANT

ANSIBLE_COLOR_DOC_PLUGIN

Определяет цвет для вывода имени плагина в выводе ansible-doc.

См. также COLOR_DOC_PLUGIN

ANSIBLE_CONNECTION_PASSWORD_FILE

Файл паролей для использования плагином подключения. --connection-password-file.

См. также CONNECTION_PASSWORD_FILE

_ANSIBLE_COVERAGE_REMOTE_OUTPUT

Задаёт каталог на удалённом узле для создания отчётов о покрытии. В настоящее время используется только для удалённого сбора покрытия модулей PowerShell. Параметр предназначен только для внутреннего использования.

См. также COVERAGE_REMOTE_OUTPUT

_ANSIBLE_COVERAGE_REMOTE_PATH_FILTER

Список путей к файлам на контроллере Ansible, для которых следует собирать данные о покрытии при выполнении на удалённом узле. Данные о покрытии собираются только для файлов, соответствующих шаблону пути. Можно указать несколько шаблонов путей, разделённых символом :. В настоящее время используется только для удалённого сбора покрытия модулей PowerShell. Параметр предназначен только для внутреннего использования.

См. также COVERAGE_REMOTE_PATHS

ANSIBLE_ACTION_WARNINGS

По умолчанию Ansible выдаёт предупреждение, полученное от действия задачи (модуля или плагина действий). Эти предупреждения можно отключить, установив для этого параметра значение False.

См. также ACTION_WARNINGS

ANSIBLE_LOCALHOST_WARNING

По умолчанию Ansible выдаёт предупреждение, если в инвентаре нет узлов. Эти предупреждения можно отключить, установив для этого параметра значение False.

См. также LOCALHOST_WARNING

ANSIBLE_LOG_VERBOSITY

Уровень подробности журналирования будет выше обычного уровня подробности вывода; в противном случае он будет ему соответствовать.

См. также LOG_VERBOSITY

ANSIBLE_INVENTORY_UNPARSED_WARNING

По умолчанию Ansible выдаёт предупреждение, если не удалось загрузить инвентарь, и сообщает, что будет использовать неявный инвентарь только с localhost. Эти предупреждения можно отключить, установив для этого параметра значение False.

См. также INVENTORY_UNPARSED_WARNING

ANSIBLE_DOC_FRAGMENT_PLUGINS

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины фрагментов документации.

См. также DOC_FRAGMENT_PLUGIN_PATH

ANSIBLE_ACTION_PLUGINS

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины действий.

См. также DEFAULT_ACTION_PLUGIN_PATH

ANSIBLE_ASK_PASS

Определяет, должен ли Ansible запрашивать пароль для входа при запуске плейбука. Если для аутентификации используются ключи SSH, скорее всего, этот параметр не потребуется изменять.

См. также DEFAULT_ASK_PASS

ANSIBLE_ASK_VAULT_PASS

Определяет, должен ли Ansible запрашивать пароль хранилища при запуске плейбука.

См. также DEFAULT_ASK_VAULT_PASS

ANSIBLE_BECOME

Включает или отключает повышение привилегий, позволяя после входа переключиться на другого пользователя.

См. также DEFAULT_BECOME

ANSIBLE_BECOME_ASK_PASS

Определяет, следует ли запрашивать пароль для повышения привилегий.

См. также DEFAULT_BECOME_ASK_PASS

ANSIBLE_BECOME_METHOD

Метод повышения привилегий, используемый, когда включён параметр become.

См. также DEFAULT_BECOME_METHOD

ANSIBLE_BECOME_EXE

Исполняемый файл для повышения привилегий; в противном случае Ansible будет использовать PATH.

См. также DEFAULT_BECOME_EXE

ANSIBLE_BECOME_FLAGS

Флаги, передаваемые исполняемому файлу для повышения привилегий.

См. также DEFAULT_BECOME_FLAGS

ANSIBLE_BECOME_PLUGINS

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины повышения привилегий.

См. также BECOME_PLUGIN_PATH

ANSIBLE_BECOME_USER

Пользователь, на которого переключается пользователь для входа или удалённый пользователь при повышении привилегий. В большинстве систем, если пользователь не указан, используется «root».

См. также DEFAULT_BECOME_USER

ANSIBLE_CACHE_PLUGINS

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины кэша.

См. также DEFAULT_CACHE_PLUGIN_PATH

ANSIBLE_CALLBACK_PLUGINS

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины обратного вызова.

См. также DEFAULT_CALLBACK_PLUGIN_PATH

ANSIBLE_CALLBACKS_ENABLED

Список включённых обработчиков обратного вызова. Не все обработчики требуется включать, но это относится ко многим из поставляемых с Ansible, поскольку по умолчанию они не активируются.

См. также CALLBACKS_ENABLED

Добавлена в версии:: 2.11

ANSIBLE_CLICONF_PLUGINS

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины Cliconf.

См. также DEFAULT_CLICONF_PLUGIN_PATH

ANSIBLE_CONNECTION_PLUGINS

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины подключений.

См. также DEFAULT_CONNECTION_PLUGIN_PATH

ANSIBLE_DEBUG

Включает или отключает вывод отладочной информации в Ansible. Он очень подробный и может затруднить многопроцессорную обработку. Отладочная информация может содержать секретные данные, даже если включены настройки no_log, поэтому режим отладки не следует использовать в рабочей среде.

См. также DEFAULT_DEBUG

ANSIBLE_EXECUTABLE

Указывает команду для запуска оболочки, необходимой Ansible для выполнения операций на целевом узле. В редких случаях, когда использование оболочки ограничено, пользователям может потребоваться изменить этот параметр, но обычно его можно оставить без изменений.

См. также DEFAULT_EXECUTABLE

ANSIBLE_FILTER_PLUGINS

Пути, разделённые двоеточиями, в которых Ansible будет искать плагины фильтров Jinja2.

См. также DEFAULT_FILTER_PLUGIN_PATH

ANSIBLE_FORCE_HANDLERS

Этот параметр определяет, будут ли запущены обработчики, уведомлённые на узле, даже если на этом узле произошёл сбой. Если значение равно False, обработчики не будут запущены при возникновении сбоя на узле. Этот параметр также можно задать для отдельного сценария или в командной строке. Подробнее см. разделы «Обработчики» и «Сбои».

См. также DEFAULT_FORCE_HANDLERS

ANSIBLE_FORKS

Максимальное количество процессов, которые Ansible будет использовать для выполнения задач на целевых узлах.

См. также DEFAULT_FORKS

ANSIBLE_GATHERING

Этот параметр определяет политику сбора фактов по умолчанию (сведений об удалённых системах). Он может быть полезен тем, кто хочет сократить время сбора фактов. Для вариантов «smart» и «explicit» используется плагин кэша.

См. также DEFAULT_GATHERING

ANSIBLE_HASH_BEHAVIOUR

Эта настройка определяет, как Ansible обрабатывает повторяющиеся определения переменных-словарей (также называемых хешами, картами или ассоциативными массивами). Она не влияет на переменные со скалярными значениями (целыми числами, строками) или массивами.**ПРЕДУПРЕЖДЕНИЕ**, менять эту настройку не рекомендуется: это ненадёжно и делает ваш контент (плейбуки, роли, коллекции) непереносимым, что приводит к постоянной путанице и неправильному использованию. Не меняйте эту настройку, если не считаете, что она вам абсолютно необходима.Мы рекомендуем не использовать повторно имена переменных и полагаться на фильтр combine, а также средства поиска vars и varnames для создания объединённых версий отдельных переменных. По нашему опыту, такая необходимость возникает редко и свидетельствует о том, что структуры данных и плейбуки стали чрезмерно сложными.В некоторых случаях можно также использовать пользовательские vars_plugins для объединения данных при вводе, в том числе заменив стандартный host_group_vars, отвечающий за обработку каталогов host_vars/ и group_vars/. Большинство пользователей этой настройки интересует только область инвентаризации, однако сама настройка влияет на все источники и ещё больше затрудняет отладку.Во всех плейбуках и ролях в официальных репозиториях с примерами предполагается, что для этой настройки установлено значение по умолчанию.Изменение настройки на merge применяется ко всем источникам переменных, однако многие источники по-прежнему будут перезаписывать переменные внутри себя. Например, include_vars устраняет дубликаты переменных внутри себя перед обновлением Ansible, причём «последнее определённое» значение перезаписывает предыдущие определения в том же файле.Проект Ansible рекомендует не использовать ``merge`` в новых проектах.**Разработчики Ansible намерены в конечном итоге объявить эту настройку устаревшей и удалить её, но пока она сохраняется, поскольку некоторые пользователи активно на неё полагаются. В новых проектах следует **избегать «merge».

См. также DEFAULT_HASH_BEHAVIOUR

ANSIBLE_INVENTORY

Список источников инвентаризации Ansible, разделённых запятыми

См. также DEFAULT_HOST_LIST

ANSIBLE_HTTPAPI_PLUGINS

Пути, разделённые двоеточиями, по которым Ansible будет искать плагины HttpApi.

См. также DEFAULT_HTTPAPI_PLUGIN_PATH

ANSIBLE_INVENTORY_PLUGINS

Пути, разделённые двоеточиями, по которым Ansible будет искать плагины инвентаризации.

См. также DEFAULT_INVENTORY_PLUGIN_PATH

ANSIBLE_JINJA2_EXTENSIONS

Эта функция предназначена для разработчиков и позволяет включать дополнительные расширения Jinja2.Подробности см. в документации Jinja2. Если вы не знаете, для чего они нужны, вероятно, вам не нужно менять эту настройку :)

См. также DEFAULT_JINJA2_EXTENSIONS

ANSIBLE_JINJA2_NATIVE

Этот параметр сохраняет типы переменных при обработке шаблонов.

См. также DEFAULT_JINJA2_NATIVE

ANSIBLE_KEEP_REMOTE_FILES

Включает или отключает очистку временных файлов, которые Ansible использовал для выполнения задач на удалённом узле.Если этот параметр включён, он отключит ANSIBLE_PIPELINING.

См. также DEFAULT_KEEP_REMOTE_FILES

ANSIBLE_LIBVIRT_LXC_NOSECLABEL

Эта настройка заставляет libvirt подключаться к контейнерам LXC, передавая параметр --noseclabel команде virsh. Это необходимо при запуске в системах, в которых отсутствует SELinux.

См. также DEFAULT_LIBVIRT_LXC_NOSECLABEL

ANSIBLE_LOAD_CALLBACK_PLUGINS

Определяет, загружаются ли плагины обратного вызова при запуске /usr/bin/ansible. Это можно использовать для регистрации действий из командной строки, отправки уведомлений и т. п. Для ansible-playbook плагины обратного вызова загружаются всегда.

См. также DEFAULT_LOAD_CALLBACK_PLUGINS

ANSIBLE_LOCAL_TEMP

Временный каталог, используемый Ansible на управляющем узле.

См. также DEFAULT_LOCAL_TMP

ANSIBLE_LOG_PATH

Файл, в который Ansible будет записывать журнал на управляющем узле.Если значение не задано, ведение журнала отключено.

См. также DEFAULT_LOG_PATH

ANSIBLE_LOG_FILTER

Список имён регистраторов, которые следует исключить из файла журнала.

См. также DEFAULT_LOG_FILTER

ANSIBLE_LOOKUP_PLUGINS

Пути, разделённые двоеточиями, по которым Ansible будет искать плагины поиска.

См. также DEFAULT_LOOKUP_PLUGIN_PATH

ANSIBLE_MODULE_ARGS

Задаёт аргументы по умолчанию, передаваемые двоичному файлу ansible для выполнения произвольных команд, если не указан -a.

См. также DEFAULT_MODULE_ARGS

ANSIBLE_LIBRARY

Пути, разделённые двоеточиями, по которым Ansible будет искать модули.

См. также DEFAULT_MODULE_PATH

ANSIBLE_MODULE_UTILS

Пути, разделённые двоеточиями, по которым Ansible будет искать файлы утилит модулей, используемые совместно несколькими модулями.

См. также DEFAULT_MODULE_UTILS_PATH

ANSIBLE_NETCONF_PLUGINS

Пути, разделённые двоеточиями, по которым Ansible будет искать плагины Netconf.

См. также DEFAULT_NETCONF_PLUGIN_PATH

ANSIBLE_NO_LOG

Включает или отключает отображение и запись в журнал сведений о задачах Ansible; в основном используется для предотвращения раскрытия конфиденциальной информации.

См. также DEFAULT_NO_LOG

ANSIBLE_NO_TARGET_SYSLOG

Включает или отключает запись Ansible в syslog на целевом узле при выполнении задач. На узлах Windows это предотвратит запись в журнал событий модулями PowerShell нового типа.

См. также DEFAULT_NO_TARGET_SYSLOG

ANSIBLE_NULL_REPRESENTATION

Значение, которое шаблонизатор должен возвращать для значения «null». Если параметр не задан, решение принимает Jinja2.

См. также DEFAULT_NULL_REPRESENTATION

ANSIBLE_POLL_INTERVAL

Для асинхронных задач Ansible (описанных в разделе «Асинхронные действия и опрос») этот параметр задаёт, как часто проверять состояние таких задач, если явно не задан интервал опроса. По умолчанию установлено умеренное значение — 15 секунд. Это компромисс между частотой проверок и быстрым получением результата после завершения задачи.

См. также DEFAULT_POLL_INTERVAL

ANSIBLE_PRIVATE_KEY_FILE

Для подключений с аутентификацией по сертификату или файлу ключа, а не через агент или с помощью паролей, здесь можно задать значение по умолчанию, чтобы не указывать --private-key при каждом запуске.

См. также DEFAULT_PRIVATE_KEY_FILE

ANSIBLE_PRIVATE_ROLE_VARS

По умолчанию импортированные роли публикуют свои переменные для плейбука и других ролей; эта настройка позволяет избежать такого поведения. Изначально её добавили, чтобы возвращать переменные роли к значениям по умолчанию, если роль используется в плейбуке несколько раз.Начиная с версии «2.17» M(ansible.builtin.include_roles) и M(ansible.builtin.import_roles) могут переопределять это поведение по отдельности с помощью параметра C(public).Подключённые роли делают свои переменные общедоступными только во время выполнения, в отличие от импортированных ролей, у которых это происходит во время компиляции плейбука.

См. также DEFAULT_PRIVATE_ROLE_VARS

ANSIBLE_REMOTE_PORT

См. также DEFAULT_REMOTE_PORT

ANSIBLE_REMOTE_USER

Задаёт имя пользователя для входа на целевые узлы.Если значение не задано, используется значение по умолчанию для плагина подключения — обычно пользователь, от имени которого запущен Ansible.

См. также DEFAULT_REMOTE_USER

ANSIBLE_ROLES_PATH

Пути, разделённые двоеточиями, по которым Ansible будет искать роли.

См. также DEFAULT_ROLES_PATH

ANSIBLE_SELINUX_SPECIAL_FS

Некоторые файловые системы не поддерживают безопасные операции и/или возвращают непоследовательные ошибки. Эта настройка позволяет Ansible «терпимо» обрабатывать перечисленные файловые системы, не вызывая критических ошибок. Если файловая система указана в списке, возможно повреждение данных, а операции записи не всегда проверяются.

См. также DEFAULT_SELINUX_SPECIAL_FS

Добавлена в версии:: 2.9

ANSIBLE_STDOUT_CALLBACK

Задаёт основной плагин обратного вызова, используемый для отображения вывода Ansible. Одновременно можно использовать только один такой плагин.Других плагинов обратного вызова может быть сколько угодно, но только один из них отвечает за стандартный вывод.Список доступных параметров см. в разделе Плагины обратного вызова.

См. также DEFAULT_STDOUT_CALLBACK

ANSIBLE_EDITOR

В случаях, когда Ansible должен открыть файл в редакторе, этот параметр задаёт приложение для использования.

См. также EDITOR

Добавлена в версии:: 2.15

EDITOR

В случаях, когда Ansible должен открыть файл в редакторе, этот параметр задаёт приложение для использования.

См. также EDITOR

ANSIBLE_ENABLE_TASK_DEBUGGER

Определяет, включена ли отладка задач. Ранее это поведение обеспечивалось плагином стратегии.Теперь его могут наследовать все плагины стратегий. По умолчанию отладчик активируется, когда задача завершается с ошибкой из-за недоступности узла. Для более гибкой настройки используйте ключевое слово debugger.

См. также ENABLE_TASK_DEBUGGER

ANSIBLE_TASK_DEBUGGER_IGNORE_ERRORS

Этот параметр определяет, будет ли отладчик задач запускаться при сбое задачи, если указано ignore_errors=True. Значение True означает, что отладчик будет учитывать ignore_errors, а значение False — что не будет.

См. также TASK_DEBUGGER_IGNORE_ERRORS

ANSIBLE_STRATEGY

Задает стратегию, используемую по умолчанию для play.

См. также DEFAULT_STRATEGY

ANSIBLE_STRATEGY_PLUGINS

Пути, разделенные двоеточиями, в которых Ansible будет искать плагины стратегий.

См. также DEFAULT_STRATEGY_PLUGIN_PATH

ANSIBLE_SU

Включает или отключает использование «su» для задач.

См. также DEFAULT_SU

ANSIBLE_SYSLOG_FACILITY

Средство Syslog, используемое при ведении Ansible журнала на удаленной целевой системе.

См. также DEFAULT_SYSLOG_FACILITY

ANSIBLE_TERMINAL_PLUGINS

Пути, разделенные двоеточиями, в которых Ansible будет искать плагины терминала.

См. также DEFAULT_TERMINAL_PLUGIN_PATH

ANSIBLE_TEST_PLUGINS

Пути, разделенные двоеточиями, в которых Ansible будет искать тестовые плагины Jinja2.

См. также DEFAULT_TEST_PLUGIN_PATH

ANSIBLE_TIMEOUT

Значение тайм-аута по умолчанию для плагинов подключения.

См. также DEFAULT_TIMEOUT

ANSIBLE_TRANSPORT

Можно указать любой плагин подключения, доступный в установленной версии Ansible.

См. также DEFAULT_TRANSPORT

ANSIBLE_ERROR_ON_UNDEFINED_VARS

Если задано значение True, шаблонизация Ansible будет завершаться ошибкой на шагах, в которых используются имена переменных с вероятными опечатками. В противном случае любые выражения «{{ template_expression }}», содержащие неопределенные переменные, будут отображаться в шаблоне или строке действия Ansible без изменений.

См. также DEFAULT_UNDEFINED_VAR_BEHAVIOR

ANSIBLE_VARS_PLUGINS

Пути, разделенные двоеточиями, в которых Ansible будет искать плагины переменных.

См. также DEFAULT_VARS_PLUGIN_PATH

ANSIBLE_VAULT_ID_MATCH

Если задано значение true, при расшифровке хранилищ с идентификатором vault будет использоваться только пароль, соответствующий этому идентификатору.

См. также DEFAULT_VAULT_ID_MATCH

ANSIBLE_VAULT_IDENTITY

Метка, используемая для идентификатора vault по умолчанию, если метка идентификатора vault не задана.

См. также DEFAULT_VAULT_IDENTITY

ANSIBLE_VAULT_ENCRYPT_SALT

Соль, используемая для шифрования vault. Если она не задана, будет использоваться случайная соль.

См. также VAULT_ENCRYPT_SALT

ANSIBLE_VAULT_ENCRYPT_IDENTITY

Идентификатор vault, используемый по умолчанию для шифрования. Если указано несколько идентификаторов vault, этот параметр определяет, какой из них использовать для шифрования. Параметр командной строки --encrypt-vault-id переопределяет настроенное значение.

См. также DEFAULT_VAULT_ENCRYPT_IDENTITY

ANSIBLE_VAULT_IDENTITY_LIST

См. также DEFAULT_VAULT_IDENTITY_LIST

ANSIBLE_VAULT_PASSWORD_FILE

Файл с паролем vault. Эквивалент --vault-password-file или --vault-id. Если файл является исполняемым, он будет запущен, а его вывод stdout будет использоваться в качестве пароля.

См. также DEFAULT_VAULT_PASSWORD_FILE

ANSIBLE_VERBOSITY

Задает уровень подробности вывода по умолчанию, соответствующий количеству параметров -v, переданных в командной строке.

См. также DEFAULT_VERBOSITY

ANSIBLE_DEPRECATION_WARNINGS

Включает или отключает предупреждения об устаревших функциях.

См. также DEPRECATION_WARNINGS

ANSIBLE_DEVEL_WARNING

Включает или отключает предупреждения, связанные с запуском версии devel.

См. также DEVEL_WARNING

ANSIBLE_DIFF_ALWAYS

Параметр конфигурации, указывающий модулям показывать различия при статусе «изменено»; эквивалент --diff.

См. также DIFF_ALWAYS

ANSIBLE_DIFF_CONTEXT

Количество строк контекста, отображаемых при показе различий между файлами.

См. также DIFF_CONTEXT

ANSIBLE_DISPLAY_ARGS_TO_STDOUT

Обычно ansible-playbook выводит заголовок для каждой выполняемой задачи. В этих заголовках указывается поле name: задачи, если вы его задали. Если поле не задано, ansible-playbook использует действие задачи, чтобы помочь определить, какая задача выполняется в данный момент. Иногда выполняется много задач с одинаковым действием, поэтому может понадобиться дополнительная информация, позволяющая отличить задачу от других с таким же действием. Если задать этой переменной значение True в конфигурации, ansible-playbook также включит в заголовок аргументы задачи. По умолчанию этот параметр имеет значение False, поскольку параметры могут содержать конфиденциальные данные, которые не следует выводить. Если задать значение True, убедитесь, что вывод stdout в вашей среде защищен (никто не может подсмотреть в ваш экран и вывод stdout не сохраняется в незащищенный файл), или проверьте, что во всех ваших playbook к задачам с конфиденциальными данными явно добавлен параметр no_log: True. Дополнительную информацию см. в разделе Как сохранить конфиденциальные данные в playbook?.

См. также DISPLAY_ARGS_TO_STDOUT

ANSIBLE_DISPLAY_SKIPPED_HOSTS

Включает или отключает отображение пропущенных задач и хостов в задаче при использовании обратного вызова по умолчанию.

См. также DISPLAY_SKIPPED_HOSTS

ANSIBLE_DISPLAY_TRACEBACK

Определяет, когда включать трассировки стека в расширенные сообщения об ошибках.

См. также DISPLAY_TRACEBACK

ANSIBLE_DUPLICATE_YAML_DICT_KEY

По умолчанию Ansible выдает предупреждение при обнаружении повторяющегося ключа словаря в YAML. Эти предупреждения можно отключить, задав для этого параметра значение False.

См. также DUPLICATE_YAML_DICT_KEY

ANSIBLE_ERROR_ON_MISSING_HANDLER

Позволяет при уведомлении выдавать предупреждение вместо ошибки, если обработчик не найден.

См. также ERROR_ON_MISSING_HANDLER

ANSIBLE_FACTS_MODULES

Модули, запускаемые на этапе сбора фактов для play. Значение по умолчанию «smart» позволяет определить подходящий модуль на основе типа подключения. Если вы добавляете собственные модули, но при этом хотите использовать стандартные факты Ansible, добавьте в список «setup» или соответствующий сетевой модуль (если добавить «smart», Ansible также определит его самостоятельно). Это не влияет на явные вызовы модуля «setup», но всегда влияет на действие «gather_facts» (явное или неявное).

См. также FACTS_MODULES

ANSIBLE_GALAXY_IGNORE

Если задано значение yes, ansible-galaxy не будет проверять сертификаты TLS. Это может быть полезно для тестирования подключения к серверу с самоподписанным сертификатом.

См. также GALAXY_IGNORE_CERTS

ANSIBLE_GALAXY_SERVER_TIMEOUT

Тайм-аут по умолчанию для вызовов API Galaxy. Для серверов Galaxy, у которых не задан собственный тайм-аут, будет использоваться это значение.

См. также GALAXY_SERVER_TIMEOUT

ANSIBLE_GALAXY_ROLE_SKELETON

Каталог шаблона роли, используемый в качестве шаблона для действия init в ansible-galaxy/ansible-galaxy role; то же, что --role-skeleton.

См. также GALAXY_ROLE_SKELETON

ANSIBLE_GALAXY_ROLE_SKELETON_IGNORE

Шаблоны файлов, которые следует игнорировать в каталоге шаблона роли или коллекции Galaxy.

См. также GALAXY_ROLE_SKELETON_IGNORE

ANSIBLE_GALAXY_COLLECTION_SKELETON

Каталог шаблона коллекции, используемый в качестве шаблона для действия init в ansible-galaxy collection; то же, что --collection-skeleton.

См. также GALAXY_COLLECTION_SKELETON

ANSIBLE_GALAXY_COLLECTION_SKELETON_IGNORE

Шаблоны файлов, которые следует игнорировать в каталоге шаблона коллекции Galaxy.

См. также GALAXY_COLLECTION_SKELETON_IGNORE

ANSIBLE_GALAXY_COLLECTIONS_PATH_WARNING

Определяет, должно ли ansible-galaxy collection install выдавать предупреждение об отсутствующих --collections-path в настроенном параметре COLLECTIONS_PATHS.

См. также GALAXY_COLLECTIONS_PATH_WARNING

ANSIBLE_GALAXY_SERVER

URL-адрес, добавляемый в начало, если в ролях не указан полный URI; предполагается, что в этом случае роль ссылается на этот сервер как на источник.

См. также GALAXY_SERVER

ANSIBLE_GALAXY_SERVER_LIST

Список серверов Galaxy, используемых при установке коллекции. Значение соответствует заголовку config ini [galaxy_server.{{item}}], который определяет сведения о сервере. Подробнее о том, как определить сервер Galaxy, см. в разделе Настройка клиента ansible-galaxy. Порядок серверов в этом списке определяет порядок разрешения коллекции. Если задан этот параметр конфигурации, параметр GALAXY_SERVER игнорируется.

См. также GALAXY_SERVER_LIST

ANSIBLE_GALAXY_TOKEN_PATH

Локальный путь к файлу токена доступа Galaxy

См. также GALAXY_TOKEN_PATH

ANSIBLE_GALAXY_DISPLAY_PROGRESS

На некоторых этапах ansible-galaxy отображается индикатор выполнения, который может вызывать проблемы на некоторых экранах или при выводе stdout в файл. Этот параметр конфигурации определяет, будет ли отображаться индикатор. По умолчанию индикатор отображается, если stdout связан с tty.

См. также GALAXY_DISPLAY_PROGRESS

ANSIBLE_GALAXY_CACHE_DIR

Каталог для хранения кэшированных ответов сервера Galaxy. Используется только командами ansible-galaxy collection install и download. Кэшированные файлы в этом каталоге игнорируются, если они доступны для записи всем пользователям.

См. также GALAXY_CACHE_DIR

ANSIBLE_GALAXY_DISABLE_GPG_VERIFY

Отключить проверку подписи GPG при установке коллекции.

См. также GALAXY_DISABLE_GPG_VERIFY

ANSIBLE_GALAXY_GPG_KEYRING

Настроить связку ключей, используемую для проверки подписи GPG при установке и проверке коллекции.

См. также GALAXY_GPG_KEYRING

ANSIBLE_GALAXY_IGNORE_SIGNATURE_STATUS_CODES

Список кодов состояния GPG, которые следует игнорировать при проверке подписи GPG. Описания кодов состояния см. в L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes). Если проверку коллекции успешно прошли меньше подписей, чем GALAXY_REQUIRED_VALID_SIGNATURE_COUNT, проверка подписи завершится ошибкой, даже если игнорируются все коды ошибок.

См. также GALAXY_IGNORE_INVALID_SIGNATURE_STATUS_CODES

ANSIBLE_GALAXY_REQUIRED_VALID_SIGNATURE_COUNT

Количество подписей, проверка которых должна завершиться успешно при проверке подписи GPG во время установки или проверки коллекций. Значение должно быть положительным целым числом или all, чтобы указать, что проверку коллекции должны успешно пройти все подписи. Добавьте к значению префикс +, чтобы проверка завершалась ошибкой, если для коллекции не найдено ни одной действительной подписи.

См. также GALAXY_REQUIRED_VALID_SIGNATURE_COUNT

ANSIBLE_GALAXY_COLLECTION_IMPORT_POLL_INTERVAL

Начальный интервал в секундах для опроса состояния импорта коллекции. Этот интервал экспоненциально увеличивается с учетом параметра GALAXY_COLLECTION_IMPORT_POLL_FACTOR; максимальная задержка составляет 30 секунд.

См. также GALAXY_COLLECTION_IMPORT_POLL_INTERVAL

ANSIBLE_GALAXY_COLLECTION_IMPORT_POLL_FACTOR

См. также GALAXY_COLLECTION_IMPORT_POLL_FACTOR

ANSIBLE_HOST_KEY_CHECKING

Задайте значение “False”, если хотите отключить проверку ключа хоста подключаемым модулем соединения, который Ansible использует для подключения к хосту. Подробнее см. в документации к используемому модулю соединения.

См. также HOST_KEY_CHECKING

ANSIBLE_HOST_PATTERN_MISMATCH

Этот параметр изменяет поведение при несовпадении шаблонов хостов: позволяет вызвать фатальную ошибку, вывести предупреждение или просто проигнорировать несовпадение.

См. также HOST_PATTERN_MISMATCH

ANSIBLE_INJECT_INVOCATION

Если параметр включен, в результат задачи будет добавлен ключ invocation с аргументами модуля/действия. Большинство модулей обратного вызова по умолчанию скрывают ключ invocation при отображении результата задачи.

См. также INJECT_INVOCATION

ANSIBLE_PYTHON_INTERPRETER

Путь к интерпретатору Python, используемому для выполнения модулей на удалённых целевых узлах, или режим автоматического обнаружения. Поддерживаются режимы обнаружения auto (по умолчанию) и auto_silent. Во всех режимах обнаружения выполняется поиск по упорядоченному списку известных расположений интерпретатора Python. При использовании резервного варианта будет выдано предупреждение о необходимости явно задать интерпретатор (поскольку интерпретаторы, установленные позднее, могут повлиять на выбор используемого интерпретатора). Это предупреждение можно отключить, задав auto_silent. Режимы auto_legacy* удалены. Они сохранены для обратной совместимости со старыми выпусками Ansible, в которых по умолчанию всегда использовался /usr/bin/python3 и выбирался этот интерпретатор, если он присутствовал.

См. также INTERPRETER_PYTHON

ANSIBLE_TRANSFORM_INVALID_GROUP_CHARS

Преобразовывать недопустимые символы в именах групп, указанных источниками инвентаризации, с помощью Ansible.

См. также TRANSFORM_INVALID_GROUP_CHARS

ANSIBLE_INVALID_TASK_ATTRIBUTE_FAILED

Если задано значение ‘false’, недопустимые атрибуты задачи будут вызывать предупреждения, а не ошибки.

См. также INVALID_TASK_ATTRIBUTE_FAILED

ANSIBLE_INVENTORY_ANY_UNPARSED_IS_FAILED

Если задано значение ‘true’, невозможность успешно обработать любой из указанных источников инвентаризации доступными подключаемыми модулями инвентаризации считается фатальной ошибкой; в противном случае это вызывает только предупреждение.

См. также INVENTORY_ANY_UNPARSED_IS_FAILED

ANSIBLE_INVENTORY_ENABLED

Список включённых подключаемых модулей инвентаризации; он также определяет порядок их использования.

См. также INVENTORY_ENABLED

ANSIBLE_INVENTORY_EXPORT

См. также INVENTORY_EXPORT

ANSIBLE_INVENTORY_IGNORE

См. также INVENTORY_IGNORE_EXTS

ANSIBLE_INVENTORY_IGNORE_REGEX

См. также INVENTORY_IGNORE_PATTERNS

ANSIBLE_INVENTORY_UNPARSED_FAILED

Если задано значение ‘true’, невозможность обработать все потенциальные источники инвентаризации считается фатальной ошибкой; в противном случае это вызывает только предупреждение.

См. также INVENTORY_UNPARSED_IS_FAILED

ANSIBLE_MAX_DIFF_SIZE

Максимальный размер файлов, для которых отображается diff.

См. также MAX_FILE_SIZE_FOR_DIFF

ANSIBLE_NETWORK_GROUP_MODULES: См. также NETWORK_GROUP_MODULES

ANSIBLE_INJECT_FACT_VARS

Факты доступны в переменной ansible_facts; этот параметр также добавляет их в качестве отдельных переменных в основное пространство имён. В отличие от словаря ansible_facts, в котором из имён фактов удаляется префикс ansible_, здесь используются точные имена, возвращаемые модулем.

См. также INJECT_FACTS_AS_VARS

ANSIBLE_MODULE_IGNORE_EXTS

Список расширений, которые следует игнорировать при поиске загружаемых модулей. Используется для отклонения резервных расширений сценариев и двоичных модулей.

См. также MODULE_IGNORE_EXTS

ANSIBLE_MODULE_STRICT_UTF8_RESPONSE

Включает проверку ответов модулей на наличие данных, не относящихся к UTF-8. Отключение этой проверки может привести к неожиданному поведению. Оценивать эту конфигурацию следует только ansible-core.

См. также MODULE_STRICT_UTF8_RESPONSE

ANSIBLE_OLD_PLUGIN_CACHE_CLEAR

Ранее Ansible очищал только некоторые кэши загрузки подключаемых модулей при загрузке новых ролей; из-за этого подключаемый модуль, загруженный в предыдущих задачах, мог неожиданно «закрепиться». Этот параметр позволяет вернуться к такому поведению.

См. также OLD_PLUGIN_CACHE_CLEARING

ANSIBLE_PAGER

Когда Ansible требуется вывести данные с постраничной прокруткой, этот параметр задаёт используемое приложение.

См. также PAGER

Добавлена в версии:: 2.15

PAGER

См. также PAGER

ANSIBLE_PERSISTENT_CONTROL_PATH_DIR

Путь к сокету, используемому системой постоянных подключений.

См. также PERSISTENT_CONTROL_PATH_DIR

ANSIBLE_PERSISTENT_CONNECT_TIMEOUT

Определяет, как долго постоянное подключение может оставаться неактивным, прежде чем будет закрыто.

См. также PERSISTENT_CONNECT_TIMEOUT

ANSIBLE_PERSISTENT_CONNECT_RETRY_TIMEOUT

Это задаёт время ожидания повторных попыток подключения к локальному доменному сокету для постоянного подключения.

См. также PERSISTENT_CONNECT_RETRY_TIMEOUT

ANSIBLE_PERSISTENT_COMMAND_TIMEOUT

Это задаёт время ожидания ответа от удалённого устройства до истечения времени ожидания постоянного подключения.

См. также PERSISTENT_COMMAND_TIMEOUT

ANSIBLE_PLAYBOOK_DIR

Некоторые интерфейсы командной строки, не связанные с плейбуками, имеют аргумент --playbook-dir; этот параметр задаёт для него значение по умолчанию.

См. также PLAYBOOK_DIR

ANSIBLE_PLAYBOOK_VARS_ROOT

Этот параметр задаёт, какие каталоги плейбуков будут использоваться в качестве корневых при обработке плагинов переменных, включая поиск host_vars/group_vars.

См. также PLAYBOOK_VARS_ROOT

ANSIBLE_PYTHON_MODULE_RLIMIT_NOFILE

При выполнении модулей Python пытается установить мягкое ограничение RLIMIT_NOFILE на указанное значение (это может ускорить использование подпроцессов в Python 2.x. См. https://bugs.python.org/issue11284). Значение будет ограничено существующим жёстким ограничением. Значение по умолчанию 0 означает, что система не будет пытаться изменять существующие системные ограничения.

См. также PYTHON_MODULE_RLIMIT_NOFILE

ANSIBLE_RETRY_FILES_ENABLED

Этот параметр определяет, должен ли завершившийся с ошибкой плейбук Ansible создавать файл .retry.

См. также RETRY_FILES_ENABLED

ANSIBLE_RETRY_FILES_SAVE_PATH

Этот параметр задаёт путь, по которому Ansible будет сохранять файлы .retry, если выполнение плейбука завершилось с ошибкой и создание файлов повторных попыток включено. После каждого запуска этот файл будет перезаписываться списком узлов, на которых произошёл сбой во всех плейбуках.

См. также RETRY_FILES_SAVE_PATH

ANSIBLE_RUN_VARS_PLUGINS

Этот параметр можно использовать для оптимизации работы vars_plugin в зависимости от размера инвентаря пользователя и выбора плейбуков.

См. также RUN_VARS_PLUGINS

ANSIBLE_SHOW_CUSTOM_STATS

Этот параметр добавляет пользовательскую статистику, заданную с помощью плагина set_stats, в вывод по умолчанию.

См. также SHOW_CUSTOM_STATS

ANSIBLE_SSH_AGENT

Управление SSH Agent с помощью Ansible. При настройке none взаимодействие с агентом не выполняется, настройка auto запускает и завершает работу агента с помощью исполняемого файла ssh-agent во время запуска, а указание пути к SSH_AUTH_SOCK позволяет взаимодействовать с уже запущенным агентом.

См. также SSH_AGENT

ANSIBLE_SSH_AGENT_EXECUTABLE

Если SSH_AGENT имеет значение auto, путь или имя исполняемого файла ssh agent, который нужно запустить.

См. также SSH_AGENT_EXECUTABLE

ANSIBLE_SSH_AGENT_KEY_LIFETIME

Для ключей, добавляемых в агент, заданный параметром SSH_AGENT, укажите срок действия в секундах — время, в течение которого ключ может оставаться в агенте.

См. также SSH_AGENT_KEY_LIFETIME

ANSIBLE_STRING_TYPE_FILTERS

Этот список фильтров предотвращает «преобразование типов» при шаблонизации переменных. Полезно, например, если нужно избежать преобразования JSON-строк в списки или словари.

См. также STRING_TYPE_FILTERS

ANSIBLE_SYSTEM_WARNINGS

Позволяет отключать предупреждения о возможных проблемах в системе, на которой работает сам Ansible (а не на управляемых узлах). К ним могут относиться предупреждения о сторонних пакетах или других условиях, которые по возможности следует устранить.

См. также SYSTEM_WARNINGS

ANSIBLE_RUN_TAGS

Список тегов по умолчанию для запуска в плейбуках. Теги пропуска имеют приоритет.

См. также TAGS_RUN

ANSIBLE_SKIP_TAGS

Список тегов по умолчанию, которые нужно пропустить в плейбуках. Имеет приоритет над тегами запуска.

См. также TAGS_SKIP

ANSIBLE_TARGET_LOG_INFO

Строка, добавляемая в журнал целевого узла для отслеживания.

См. также TARGET_LOG_INFO

ANSIBLE_TASK_TIMEOUT

Задаёт максимальное время (в секундах) выполнения действия задачи. Тайм-аут действует независимо от шаблонизации и циклов. Он применяется к каждой попытке выполнения действия задачи и не зависит от общего времени, затраченного на задачу. Если время выполнения действия превышает тайм-аут, Ansible прерывает процесс. Это регистрируется как сбой, вызванный внешними обстоятельствами, а не как сбой задачи, чтобы можно было применить надлежащую реакцию и процедуру восстановления. Если задано значение 0 (по умолчанию), тайм-аут не устанавливается.

См. также TASK_TIMEOUT

ANSIBLE_WORKER_SESSION_ISOLATION

По умолчанию рабочие процессы Ansible запускаются в изолированных сеансах, чтобы избежать конфликтов при совместном использовании TTY. Если требуется доступ к унаследованному TTY родительского процесса, установите для этого параметра значение false, чтобы отключить изоляцию сеансов. Отключение изоляции сеансов следует ограничивать минимально возможной областью действия, задавая переменную ansible_worker_session_isolation для отдельных задач, блоков, плейбуков, ролей или узлов по мере необходимости.

См. также WORKER_SESSION_ISOLATION

ANSIBLE_WORKER_SHUTDOWN_POLL_COUNT

Максимальное количество проверок рабочих процессов Task Queue Manager, выполняемых для подтверждения их корректного завершения. После достижения этого предела все ещё работающие процессы будут принудительно завершены. Параметр предназначен только для внутреннего использования.

См. также WORKER_SHUTDOWN_POLL_COUNT

ANSIBLE_WORKER_SHUTDOWN_POLL_DELAY

Количество секунд ожидания между циклами опроса при проверке рабочих процессов Task Queue Manager для подтверждения их корректного завершения. Параметр предназначен только для внутреннего использования.

См. также WORKER_SHUTDOWN_POLL_DELAY

ANSIBLE_USE_PERSISTENT_CONNECTIONS

Включает или отключает использование постоянных подключений.

См. также USE_PERSISTENT_CONNECTIONS

ANSIBLE_VARS_ENABLED

Список допустимых плагинов переменных, которым он требуется.

См. также VARIABLE_PLUGINS_ENABLED

ANSIBLE_PRECEDENCE

Позволяет изменить порядок объединения переменных групп с учётом приоритета.

См. также VARIABLE_PRECEDENCE

ANSIBLE_WIN_ASYNC_STARTUP_TIMEOUT

Для асинхронных задач Ansible (описанных в разделе «Асинхронные действия и опрос») этот параметр задаёт время ожидания в секундах, в течение которого запущенная Ansible задача должна подключиться к именованному каналу, используемому в системах Windows. Значение по умолчанию — 5 секунд. Этого может быть недостаточно для медленных систем или систем с высокой нагрузкой. Это не общее время выполнения асинхронной команды, а отдельный тайм-аут ожидания её запуска. Отсчёт async_timeout для задачи начинается только после подключения к каналу, поэтому указанное здесь значение увеличивает максимальную общую продолжительность задачи.

См. также WIN_ASYNC_STARTUP_TIMEOUT

ANSIBLE_YAML_FILENAME_EXT

При поиске файлов «переменных», которые должны быть в формате YAML или JSON либо в зашифрованном варианте одного из этих форматов, проверяются все расширения из этого списка. Это влияет, помимо прочего, на vars_files, include_vars, инвентарь и плагины переменных.

См. также YAML_FILENAME_EXTENSIONS

ANSIBLE_NETCONF_SSH_CONFIG

Эта переменная используется для включения bastion/jump host при подключении по netconf. Если задано значение True, параметры SSH bastion/jump host должны быть указаны в файле ~/.ssh/config. Также можно задать путь к пользовательскому файлу конфигурации SSH, из которого будут считываться параметры bastion/jump host.

См. также NETCONF_SSH_CONFIG

ANSIBLE_VALIDATE_ACTION_GROUP_METADATA

Переключатель, отключающий проверку записи ‘metadata’ коллекции для группы действий module_defaults. Если для этого параметра задано значение True, наличие в метаданных неожиданных полей или типов значений приведёт к появлению предупреждения.

См. также VALIDATE_ACTION_GROUP_METADATA

ANSIBLE_VERBOSE_TO_STDERR

Принудительно направляет вывод параметра ‘verbose’ в stderr вместо stdout.

См. также VERBOSE_TO_STDERR

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/reference_appendices/config.html

Настройки конфигурации Ansible

Файл конфигурации

Создание примера файла ansible.cfg

Как избежать рисков безопасности при использовании ansible.cfg в текущем каталоге

Относительные пути в конфигурации

Общие параметры

ACTION_WARNINGS

AGNOSTIC_BECOME_PROMPT

ALLOW_BROKEN_CONDITIONALS

ALLOW_EMBEDDED_TEMPLATES

ANSIBLE_CONNECTION_PATH

ANSIBLE_COW_ACCEPTLIST

ANSIBLE_COW_PATH

ANSIBLE_COW_SELECTION

ANSIBLE_FORCE_COLOR

ANSIBLE_HOME

ANSIBLE_NOCOLOR

ANSIBLE_NOCOWS

ANSIBLE_PIPELINING

ANY_ERRORS_FATAL

BECOME_ALLOW_SAME_USER

BECOME_PASSWORD_FILE

BECOME_PLUGIN_PATH

CACHE_PLUGIN

CACHE_PLUGIN_CONNECTION

CACHE_PLUGIN_PREFIX

CACHE_PLUGIN_TIMEOUT

CALLBACKS_ENABLED

COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH

COLLECTIONS_PATHS

COLLECTIONS_SCAN_SYS_PATH

COLOR_CHANGED

COLOR_CONSOLE_PROMPT

COLOR_DEBUG

COLOR_DEPRECATE

COLOR_DIFF_ADD

COLOR_DIFF_LINES

COLOR_DIFF_REMOVE

COLOR_DOC_CONSTANT

COLOR_DOC_DEPRECATED

COLOR_DOC_LINK

COLOR_DOC_MODULE

COLOR_DOC_PLUGIN

COLOR_DOC_REFERENCE

COLOR_ERROR

COLOR_HIGHLIGHT

COLOR_INCLUDED

COLOR_OK

COLOR_SKIP

COLOR_UNREACHABLE

COLOR_VERBOSE

COLOR_WARN

CONNECTION_FACTS_MODULES

CONNECTION_PASSWORD_FILE

COVERAGE_REMOTE_OUTPUT

COVERAGE_REMOTE_PATHS

DEFAULT_ACTION_PLUGIN_PATH

DEFAULT_ALLOW_UNSAFE_LOOKUPS

DEFAULT_ASK_PASS

DEFAULT_ASK_VAULT_PASS

DEFAULT_BECOME

DEFAULT_BECOME_ASK_PASS

DEFAULT_BECOME_EXE

DEFAULT_BECOME_FLAGS

DEFAULT_BECOME_METHOD

DEFAULT_BECOME_USER

DEFAULT_CACHE_PLUGIN_PATH

DEFAULT_CALLBACK_PLUGIN_PATH

DEFAULT_CLICONF_PLUGIN_PATH

DEFAULT_CONNECTION_PLUGIN_PATH

DEFAULT_DEBUG

DEFAULT_EXECUTABLE

DEFAULT_FILTER_PLUGIN_PATH

DEFAULT_FORCE_HANDLERS

DEFAULT_FORKS

DEFAULT_GATHERING

DEFAULT_HASH_BEHAVIOUR

DEFAULT_HOST_LIST

DEFAULT_HTTPAPI_PLUGIN_PATH

DEFAULT_INTERNAL_POLL_INTERVAL

Создание примера файла `ansible.cfg`

Как избежать рисков безопасности при использовании `ansible.cfg` в текущем каталоге