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

Ansible поддерживает несколько источников для настройки своего поведения, включая файл ini с именем ansible.cfg, переменные среды, параметры командной строки, ключевые слова playbooks и переменные. Подробную информацию о приоритетах каждого источника см. в разделе Управление поведением 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 загрузит 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 вместо отображения запроса, содержащего метод become, предоставленный в командной строке

Тип

boolean

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

True

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

2.5

Ini

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

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

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

ALLOW_WORLD_READABLE_TMPFILES

Описание

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

Тип

boolean

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

False

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

2.1

Ini

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

Устарело в

2.14

Подробности об устаревании

перемещено в подход на основе плагинов, который более гибкий

Альтернативы устареванию

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

ANSIBLE_CONNECTION_PATH

Описание

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

Тип

путь

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

None

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

2.8

Ini

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

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

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

ANSIBLE_COW_PATH

Описание

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

Тип

строка

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

None

Ini

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

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

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

ANSIBLE_COW_SELECTION

Описание

Это позволяет выбрать конкретный шаблон cowsay для баннеров или использовать ‘random’, чтобы циклически проходить их.

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

default

Ini

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

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

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

ANSIBLE_COW_WHITELIST

Описание

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

Тип

список

По умолчанию

[‘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]
Ключ: cow_whitelist

Окружение

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

ANSIBLE_FORCE_COLOR

Описание

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

Тип

булево

По умолчанию

False

Ini

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

Окружение

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

ANSIBLE_NOCOLOR

Описание

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

Тип

булево

По умолчанию

False

Ini

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

Окружение

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

ANSIBLE_NOCOWS

Описание

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

Тип

булево

По умолчанию

False

Ini

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

Окружение

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

ANSIBLE_PIPELINING

Описание

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

Тип

булево

По умолчанию

False

Ini

Раздел

[connection]

Ключ

pipelining
Раздел

[ssh_connection]

Ключ

pipelining

Окружение

Переменная

ANSIBLE_PIPELINING
Переменная

ANSIBLE_SSH_PIPELINING

ANSIBLE_SSH_ARGS

Описание

Если задано, это переопределит стандартные аргументы ssh Ansible. В частности, пользователи могут увеличить время ControlPersist для повышения производительности. Может подойти значение 30 минут. Учтите, что если -o ControlPath задано в ssh_args, настройка пути управления не используется.

По умолчанию

-C -o ControlMaster=auto -o ControlPersist=60s

Ini

Раздел: [ssh_connection]
Ключ: ssh_args

Окружение

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

ANSIBLE_SSH_CONTROL_PATH

Описание

Это местоположение для сохранения сокетов ControlPath ssh, оно использует подстановку переменных ssh. С версии 2.3, если значение null, Ansible сгенерирует уникальный хеш. Используйте %(directory)s для указания места использования настройки пути к каталогу управления. До версии 2.3 по умолчанию было control_path=%(directory)s/ansible-ssh-%%h-%%p-%%r. Обратите внимание, что эта настройка игнорируется, если -o ControlPath установлено в ssh args.

По умолчанию

None

Ini

Раздел: [ssh_connection]
Ключ: control_path

Окружение

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

ANSIBLE_SSH_CONTROL_PATH_DIR

Описание

Это задаёт каталог для использования ssh control path, если настройка control path равна null. Также предоставляет переменную %(directory)s для настройки пути control path.

По умолчанию

~/.ansible/cp

Ini

Раздел: [ssh_connection]
Ключ: control_path_dir

Окружение

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

ANSIBLE_SSH_EXECUTABLE

Описание

Определяет расположение бинарного файла ssh. По умолчанию ssh, что будет использовать первый доступный бинарный файл ssh в $PATH. Этот параметр обычно не требуется, он может быть полезен, когда доступ к системному ssh ограничен или при использовании оболочек ssh для подключения к удалённым хостам.

По умолчанию

ssh

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

2.2

Ini

Раздел: [ssh_connection]
Ключ: ssh_executable

Окружение

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

ANSIBLE_SSH_RETRIES

Описание

Количество попыток установления соединения до того, как мы сдаёмся и отмечаем хост как «НЕДОСТУПЕН»

Тип

целое число

По умолчанию

Ini

Раздел: [ssh_connection]
Ключ: retries

Окружение

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

ANY_ERRORS_FATAL

Описание

Устанавливает значение по умолчанию для ключевого слова any_errors_fatal. Если True, сбои задач будут рассматриваться как фатальные ошибки.

Тип

boolean

По умолчанию

False

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

2.4

Ini

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

Окружение

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

BECOME_ALLOW_SAME_USER

Описание

Эта настройка управляет тем, пропускается ли become, когда удаленный пользователь и пользователь become совпадают. Например, root sudo root.

Тип

boolean

По умолчанию

False

Ini

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

Окружение

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

BECOME_PLUGIN_PATH

Описание

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

Тип

pathspec

По умолчанию

~/.ansible/plugins/become:/usr/share/ansible/plugins/become

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

2.8

Ini

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

Окружение

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

CACHE_PLUGIN

Описание

Выбирает плагин кэширования для использования. По умолчанию ‘memory’ — это кэш в оперативной памяти.

По умолчанию

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

COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH

Описание

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

По умолчанию

warning

Варианты

error
warning
ignore

Ini

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

Окружение

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

COLLECTIONS_PATHS

Описание

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

Тип

pathspec

По умолчанию

~/.ansible/collections:/usr/share/ansible/collections

Ini

Раздел

[defaults]

Ключ

collections_paths
Раздел

[defaults]

Ключ

collections_path

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

2.10

Окружение

Переменная

ANSIBLE_COLLECTIONS_PATH

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

2.10
Переменная

ANSIBLE_COLLECTIONS_PATHS

COLLECTIONS_SCAN_SYS_PATH

Тип

boolean

По умолчанию

True

Ini

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

Окружение

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

COLOR_CHANGED

Описание

Определяет цвет, используемый для статуса задачи ‘Изменено’

По умолчанию

yellow

Ini

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

Окружение

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

COLOR_CONSOLE_PROMPT

Описание

Определяет цвет по умолчанию для ansible-console

По умолчанию

белый

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

2.7

Ini

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

Среда

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

COLOR_DEBUG

Описание

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

По умолчанию

темно-серый

Ini

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

Среда

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

COLOR_DEPRECATE

Описание

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

По умолчанию

фиолетовый

Ini

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

Среда

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

COLOR_DIFF_ADD

Описание

Определяет цвет для отображения добавленных строк в diff

По умолчанию

зеленый

Ini

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

Среда

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

COLOR_DIFF_LINES

Описание

Определяет цвет для отображения diff

По умолчанию

голубой

Ini

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

Среда

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

COLOR_DIFF_REMOVE

Описание

Определяет цвет для отображения удаленных строк в diff

По умолчанию

красный

Ini

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

Среда

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

COLOR_ERROR

Описание

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

По умолчанию

красный

Ini

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

Среда

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

COLOR_HIGHLIGHT

Описание

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

По умолчанию

белый

Ini

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

Среда

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

COLOR_OK

Описание

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

По умолчанию

зеленый

Ini

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

Среда

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

COLOR_SKIP

Описание

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

По умолчанию

голубой

Ini

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

Среда

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

COLOR_UNREACHABLE

Описание

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

По умолчанию

ярко-красный

Ini

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

Среда

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

COLOR_VERBOSE

Описание

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

По умолчанию

синий

Ini

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

Среда

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

COLOR_WARN

Описание

Определяет цвет для отображения предупреждений

По умолчанию

ярко-фиолетовый

Ini

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

Среда

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

COMMAND_WARNINGS

Описание

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

Тип

boolean

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

True

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

1.8

Ini

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

Окружение

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

CONDITIONAL_BARE_VARS

Описание

При включенном значении (True), выполнение условной оценки ‘var’ обрабатывается по-другому, чем ‘var.subkey’, так как первое вычисляется непосредственно, а второе проходит через парсер Jinja2. Но строки ‘false’ в ‘var’ вычисляются как булевы значения. При выключенном значении они оба вычисляются одинаково, но в случаях, когда ‘var’ было ‘false’ (строка), оно больше не будет вычисляться как булево значение. В настоящее время это значение по умолчанию равно ‘True’, но вскоре изменится на ‘False’, а само значение будет удалено в будущем. Ожидайте, что это значение в конечном итоге будет устаревшим после 2.12

Тип

boolean

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

False

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

2.8

Ini

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

Окружение

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

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’}

Ini

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

Окружение

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

COVERAGE_REMOTE_OUTPUT

Описание

Устанавливает каталог вывода на удалённом хосте для генерации отчётов о покрытии. В настоящее время используется только для удалённого покрытия модулей PowerShell. Только для внутреннего использования.

Тип

str

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

2.9

Окружение

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

Переменные

name: _ansible_coverage_remote_output

COVERAGE_REMOTE_WHITELIST

Описание

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

Тип

str

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

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

2.9

Окружение

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

DEFAULT_ACTION_PLUGIN_PATH

Описание

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

Тип

pathspec

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

~/.ansible/plugins/action:/usr/share/ansible/plugins/action

Ini

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

Окружение

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

DEFAULT_ALLOW_UNSAFE_LOOKUPS

Описание

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

Тип

boolean

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

False

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

2.2.3

Ini

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

DEFAULT_ASK_PASS

Описание

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

Тип

boolean

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

False

Ini

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

Окружение

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

DEFAULT_ASK_VAULT_PASS

Описание

Управляет тем, будет ли Ansible playbook запрашивать пароль для vault.

Тип

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/plugins/cache:/usr/share/ansible/plugins/cache

Ini

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

Окружение

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

DEFAULT_CALLABLE_WHITELIST

Описание

Белый список вызываемых методов, которые будут доступны для оценки шаблонов

Тип

list

По умолчанию

[]

Ini

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

Окружение

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

DEFAULT_CALLBACK_PLUGIN_PATH

Описание

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

Тип

pathspec

По умолчанию

~/.ansible/plugins/callback:/usr/share/ansible/plugins/callback

Ini

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

Окружение

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

DEFAULT_CALLBACK_WHITELIST

Описание

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

Тип

list

По умолчанию

[]

Ini

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

Окружение

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

DEFAULT_CLICONF_PLUGIN_PATH

Описание

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

Тип

pathspec

По умолчанию

~/.ansible/plugins/cliconf:/usr/share/ansible/plugins/cliconf

Ini

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

Окружение

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

DEFAULT_CONNECTION_PLUGIN_PATH

Описание

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

Тип

pathspec

По умолчанию

~/.ansible/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_FACT_PATH

Описание

Этот параметр позволяет глобально настроить пользовательский путь для «local_facts» для неявной задачи M(ansible.builtin.setup) при использовании сбора фактов. Если не задано, используется значение по умолчанию из модуля M(ansible.builtin.setup): /etc/ansible/facts.d. Это не влияет на пользовательские задачи, которые используют модуль M(ansible.builtin.setup).

Тип

строка

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

None

Ini

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

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

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

DEFAULT_FILTER_PLUGIN_PATH

Описание

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

Тип

путь

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

~/.ansible/plugins/filter:/usr/share/ansible/plugins/filter

Ini

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

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

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

DEFAULT_FORCE_HANDLERS

Описание

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

Тип

boolean

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

False

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

1.9.1

Ini

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

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

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

DEFAULT_FORKS

Описание

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

Тип

целое число

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

Ini

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

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

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

DEFAULT_GATHER_SUBSET

Описание

Установите параметр gather_subset для задачи M(ansible.builtin.setup) в неявном сборе фактов. Подробную информацию см. в документации модуля. Не применяется к пользовательским задачам M(ansible.builtin.setup).

Тип

список

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

[‘all’]

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

2.1

Ini

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

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

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

DEFAULT_GATHER_TIMEOUT

Описание

Установить таймаут в секундах для неявного сбора фактов. Не применяется к пользовательским задачам M(ansible.builtin.setup).

Тип

целое число

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

Ini

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

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

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

DEFAULT_GATHERING

Описание

Этот параметр контролирует политику сбора фактов (фактов, обнаруженных на удалённых системах) по умолчанию. При значении «implicit» (значение по умолчанию), плагин кэширования будет проигнорирован, и факты будут собираться по каждому выполнению, если не установлено «gather_facts: False». При значении «explicit», происходит обратное: факты не будут собираться, если не запрошены напрямую в выполнении. Значение «smart» означает, что каждый новый хост, у которого нет обнаруженных фактов, будет сканироваться, но если к одному и тому же хосту обращаются в нескольких выполнениях, он не будет запрашиваться повторно в процессе выполнения книги задач. Этот параметр может быть полезен для экономии времени на сбор фактов. При значениях «smart» и «explicit» будет использоваться плагин кэширования.

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

implicit

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

smart
explicit
implicit

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

1.6

Ini

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

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

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

DEFAULT_HANDLER_INCLUDES_STATIC

Description

Since 2.0 M(ansible.builtin.include) can be ‘dynamic’, this setting (if True) forces that if the include appears in a handlers section to be ‘static’.

Type

boolean

Default

False

Ini

Section: [defaults]
Key: handler_includes_static

Environment

Variable: ANSIBLE_HANDLER_INCLUDES_STATIC

Deprecated in

2.12

Deprecated detail

include itself is deprecated and this setting will not matter in the future

Deprecated alternatives

none as its already built into the decision between include_tasks and import_tasks

DEFAULT_HASH_BEHAVIOUR

Description

This setting controls how variables merge in Ansible. By default Ansible will override variables in specific precedence orders, as described in Variables. When a variable of higher precedence wins, it will replace the other value. Some users prefer that variables that are hashes (aka ‘dictionaries’ in Python terms) are merged. This setting is called ‘merge’. This is not the default behavior and it does not affect variables whose values are scalars (integers, strings) or arrays. We generally recommend not using this setting unless you think you have an absolute need for it, and playbooks in the official examples repos do not use this setting In version 2.0 a combine filter was added to allow doing this for a particular variable (described in Filters).

Type

string

Default

replace

Choices

replace
merge

Ini

Section: [defaults]
Key: hash_behaviour

Environment

Variable: ANSIBLE_HASH_BEHAVIOUR

Deprecated in

2.13

Deprecated detail

this feature is fragile and not portable, leading to continual confusion and misuse

Deprecated alternatives

the combine filter explicitly

DEFAULT_HOST_LIST

Description

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

Type

pathlist

Default

/etc/ansible/hosts

Ini

Section: [defaults]
Key: inventory

Environment

Variable: ANSIBLE_INVENTORY

DEFAULT_HTTPAPI_PLUGIN_PATH

Description

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

Type

pathspec

Default

~/.ansible/plugins/httpapi:/usr/share/ansible/plugins/httpapi

Ini

Section: [defaults]
Key: httpapi_plugins

Environment

Variable: ANSIBLE_HTTPAPI_PLUGINS

DEFAULT_INTERNAL_POLL_INTERVAL

Description

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

Type

float

Default

0.001

Version Added

2.2

Ini

Section: [defaults]
Key: internal_poll_interval

DEFAULT_INVENTORY_PLUGIN_PATH

Description

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

Type

pathspec

Default

~/.ansible/plugins/inventory:/usr/share/ansible/plugins/inventory

Ini

Section: [defaults]
Key: inventory_plugins

Environment

Variable: ANSIBLE_INVENTORY_PLUGINS

DEFAULT_JINJA2_EXTENSIONS

Description

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

Default

[]

Ini

Section: [defaults]
Key: jinja2_extensions

Environment

Variable: ANSIBLE_JINJA2_EXTENSIONS

DEFAULT_JINJA2_NATIVE

Description

Этот параметр сохраняет типы переменных во время операций с шаблонами. Требуется Jinja2 >= 2.10.

Type

boolean

Default

False

Version Added

2.7

Ini

Section: [defaults]
Key: jinja2_native

Environment

Variable: ANSIBLE_JINJA2_NATIVE

DEFAULT_KEEP_REMOTE_FILES

Description

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

Type

boolean

Default

False

Ini

Section: [defaults]
Key: keep_remote_files

Environment

Variable: 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
Переменная

LIBVIRT_LXC_NOSECLABEL

Устарело начиная с

2.12

Подробное описание устаревания

переменные окружения без префикса ANSIBLE_ устарели

Альтернативы, заменяющие устаревшее

переменная окружения ANSIBLE_LIBVIRT_LXC_NOSECLABEL

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/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 будет искать плагины Lookup.

Тип

pathspec

По умолчанию

~/.ansible/plugins/lookup:/usr/share/ansible/plugins/lookup

Ini

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

Окружение

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

DEFAULT_MANAGED_STR

Описание

Устанавливает макрос для переменной ‘ansible_managed’, доступной для модулей M(ansible.builtin.template) и M(ansible.windows.win_template). Это актуально только для этих двух модулей.

По умолчанию

Ansible managed

Ini

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

DEFAULT_MODULE_ARGS

Описание

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

По умолчанию

Ini

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

Окружение

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

DEFAULT_MODULE_COMPRESSION

Описание

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

По умолчанию

ZIP_DEFLATED

Ini

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

DEFAULT_MODULE_NAME

Описание

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

По умолчанию

command

Ini

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

DEFAULT_MODULE_PATH

Описание

Список путей через двоеточие, по которым Ansible будет искать модули.

Тип

pathspec

По умолчанию

~/.ansible/plugins/modules:/usr/share/ansible/plugins/modules

Ini

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

Окружение

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

DEFAULT_MODULE_UTILS_PATH

Описание

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

Тип

pathspec

По умолчанию

~/.ansible/plugins/module_utils:/usr/share/ansible/plugins/module_utils

Ini

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

Окружение

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

DEFAULT_NETCONF_PLUGIN_PATH

```

Description

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

Type

pathspec

Default

~/.ansible/plugins/netconf:/usr/share/ansible/plugins/netconf

Ini

Section: [defaults]
Key: netconf_plugins

Environment

Variable: ANSIBLE_NETCONF_PLUGINS

DEFAULT_NO_LOG

Description

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

Type

boolean

Default

False

Ini

Section: [defaults]
Key: no_log

Environment

Variable: ANSIBLE_NO_LOG

DEFAULT_NO_TARGET_SYSLOG

Description

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

Type

boolean

Default

False

Ini

Section: [defaults]
Key: no_target_syslog

Environment

Variable: ANSIBLE_NO_TARGET_SYSLOG

Variables

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

DEFAULT_NULL_REPRESENTATION

Description

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

Type

none

Default

None

Ini

Section: [defaults]
Key: null_representation

Environment

Variable: ANSIBLE_NULL_REPRESENTATION

DEFAULT_POLL_INTERVAL

Description

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

Type

integer

Default

Ini

Section: [defaults]
Key: poll_interval

Environment

Variable: ANSIBLE_POLL_INTERVAL

DEFAULT_PRIVATE_KEY_FILE

Description

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

Type

path

Default

None

Ini

Section: [defaults]
Key: private_key_file

Environment

Variable: ANSIBLE_PRIVATE_KEY_FILE

DEFAULT_PRIVATE_ROLE_VARS

Description

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

Type

boolean

Default

False

Ini

Section: [defaults]
Key: private_role_vars

Environment

Variable: ANSIBLE_PRIVATE_ROLE_VARS

DEFAULT_REMOTE_PORT

Description

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

Type

integer

Default

None

Ini

Section: [defaults]
Key: remote_port

Environment

Variable: ANSIBLE_REMOTE_PORT

DEFAULT_REMOTE_USER

Description

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

Default

None

Ini

Section: [defaults]
Key: remote_user

Environment

Variable: ANSIBLE_REMOTE_USER

DEFAULT_ROLES_PATH

Description

Пути с двоеточием, в которых Ansible будет искать роли.

Type

pathspec

Default

~/.ansible/roles:/usr/share/ansible/roles:/etc/ansible/roles

Ini

Section: [defaults]
Key: roles_path

Environment

Variable: ANSIBLE_ROLES_PATH

DEFAULT_SCP_IF_SSH

Description

Предпочтительный метод при передаче файлов через ssh. При значении smart Ansible будет пытаться использовать их, пока один не удастся или все не завершатся ошибкой. Если True, то будет принудительно использоваться ‘scp’, если False, то ‘sftp’.

Default

smart

Ini

Section: [ssh_connection]
Key: scp_if_ssh

Environment

Variable: ANSIBLE_SCP_IF_SSH

DEFAULT_SELINUX_SPECIAL_FS

Описание

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

Тип

список

По умолчанию

fuse, nfs, vboxsf, ramfs, 9p, vfat

Ini

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

Окружение

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

DEFAULT_SFTP_BATCH_MODE

Тип

булево

По умолчанию

True

Ini

Раздел: [ssh_connection]
Ключ: sftp_batch_mode

Окружение

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

DEFAULT_SQUASH_ACTIONS

Описание

Ansible может оптимизировать действия, вызывающие модули, поддерживающие параметры списков, при использовании циклов with_. Вместо вызова модуля для каждого элемента, модуль вызывается один раз со списком целиком. Значение по умолчанию для этой настройки предназначено только для определённых менеджеров пакетов, но может использоваться для любого модуля. В настоящее время это поддерживается только для модулей, имеющих параметр name или pkg, и только когда параметр принимает в качестве значения только элемент.

Тип

список

По умолчанию

apk, apt, dnf, homebrew, openbsd_pkg, pacman, pip, pkgng, yum, zypper

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

2.0

Ini

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

Окружение

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

Устарело в

2.11

Подробности об устаревании

Сжатие циклов устарело, и эта конфигурация больше не будет использоваться.

Альтернативные варианты

непосредственный список в аргументе модуля

DEFAULT_SSH_TRANSFER_METHOD

Описание

не используется?

По умолчанию

None

Ini

Раздел: [ssh_connection]
Ключ: transfer_method

Окружение

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

DEFAULT_STDOUT_CALLBACK

Описание

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

По умолчанию

default

Ini

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

Окружение

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

DEFAULT_STRATEGY

Описание

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

По умолчанию

linear

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

2.3

Ini

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

Окружение

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

DEFAULT_STRATEGY_PLUGIN_PATH

Описание

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

Тип

путь

По умолчанию

~/.ansible/plugins/strategy:/usr/share/ansible/plugins/strategy

Ini

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

Окружение

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

DEFAULT_SU

Описание

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

Тип

булево

По умолчанию

False

Ini

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

Окружение

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

DEFAULT_SYSLOG_FACILITY

Описание

Утилита Syslog для использования при регистрации Ansible на удалённом целевом узле

По умолчанию

LOG_USER

Ini

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

Окружение

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

DEFAULT_TASK_INCLUDES_STATIC

Описание

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

Тип

булево

По умолчанию

False

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

2.1

Ini

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

Окружение

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

Устарело в

2.12

Подробности об устаревании

include устарело, и эта настройка в будущем не будет использоваться.

Альтернативные варианты

Нет, так как это уже встроено в решение между include_tasks и import_tasks

DEFAULT_TERMINAL_PLUGIN_PATH

Описание

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

Тип

pathspec

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

~/.ansible/plugins/terminal:/usr/share/ansible/plugins/terminal

Ini

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

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

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

DEFAULT_TEST_PLUGIN_PATH

Описание

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

Тип

pathspec

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

~/.ansible/plugins/test:/usr/share/ansible/plugins/test

Ini

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

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

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

DEFAULT_TIMEOUT

Описание

Это значение таймаута по умолчанию для подключения плагинов.

Тип

целое число

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

Ini

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

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

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

DEFAULT_TRANSPORT

Описание

Плагин подключения по умолчанию, опция ‘smart’ будет переключаться между ‘ssh’ и ‘paramiko’ в зависимости от операционной системы контроллера и версий ssh

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

smart

Ini

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

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

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

DEFAULT_UNDEFINED_VAR_BEHAVIOR

Описание

При значении True, шаги с ansible шаблонизацией, которые ссылаются на переменные с вероятными опечатками, будут отклоняться. В противном случае любые ‘{{ выражение_шаблона }}’, содержащие не определённые переменные, будут отображены в шаблоне или строке действия ansible точно так, как они написаны.

Тип

boolean

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

True

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

1.3

Ini

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

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

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

DEFAULT_VARS_PLUGIN_PATH

Описание

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

Тип

pathspec

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

~/.ansible/plugins/vars:/usr/share/ansible/plugins/vars

Ini

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

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

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

DEFAULT_VAULT_ENCRYPT_IDENTITY

Описание

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

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

None

Ini

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

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

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

DEFAULT_VAULT_ID_MATCH

Описание

Если true, при расшифровке vault с vault id, будет использоваться только пароль из соответствующего vault-id.

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

False

Ini

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

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

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

DEFAULT_VAULT_IDENTITY

Описание

Метка, используемая для метки vault id по умолчанию в тех случаях, когда метка vault id не указана.

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

default

Ini

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

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

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

DEFAULT_VAULT_IDENTITY_LIST

Описание

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

Тип

список

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

[]

Ini

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

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

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

DEFAULT_VAULT_PASSWORD_FILE

Описание

Файл пароля vault для использования. Эквивалентно –vault-password-file или –vault-id

Тип

путь

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

None

Ini

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

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

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

DEFAULT_VERBOSITY

Описание

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

Тип

целое число

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

Ini

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

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

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

ПРЕДУПРЕЖДЕНИЯ_О_ДЕПРЕКАЦИИ

Описание

Переключатель для управления отображением предупреждений о депрекации

Тип

boolean

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

True

Ini

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

Окружение

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

ПРЕДУПРЕЖДЕНИЕ_DEVEL

Описание

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

Тип

boolean

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

True

Ini

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

Окружение

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

DIFF_ALWAYS

Описание

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

Тип

bool

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

False

Ini

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

Окружение

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

DIFF_CONTEXT

Описание

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

Тип

целое число

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

Ini

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

Окружение

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

ОТОБРАЖЕНИЕ_АРГУМЕНТОВ_В_STDOUT

Описание

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

Тип

boolean

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

False

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

2.1

Ini

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

Окружение

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

ОТОБРАЖЕНИЕ_ПРОПУЩЕННЫХ_ХОСТОВ

Описание

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

Тип

boolean

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

True

Ini

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

Окружение

Переменная

ANSIBLE_DISPLAY_SKIPPED_HOSTS
Переменная

DISPLAY_SKIPPED_HOSTS

Устарело с версии

2.12

Подробности об устаревании

переменные окружения без префикса ANSIBLE_ устарели

Альтернативные варианты

переменная окружения ANSIBLE_DISPLAY_SKIPPED_HOSTS

ПУТЬ_ПЛАГИНА_ФРАГМЕНТА_ДОКУМЕНТАЦИИ

Описание

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

Тип

путь

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

~/.ansible/plugins/doc_fragments:/usr/share/ansible/plugins/doc_fragments

Ini

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

Окружение

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

КОРНЕВОЙ_URL_ДОКУМЕНТАЦИИ

Описание

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

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

https://docs.ansible.com/ansible/

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

2.8

Ini

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

ДУБЛИРУЮЩИЙСЯ_КЛЮЧ_В_YAML_ДЛЯ_СЛОВАРЯ

Описание

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

Тип

строка

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

warn

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

warn
error
ignore

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

2.9

Ini

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

Окружение

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

ВКЛЮЧЕНИЕ_ДЕБАГГЕРА_ЗАДАЧ

Описание

Включить или выключить отладчик задач. Раньше это делалось как плагин стратегии. Теперь все плагины стратегий могут унаследовать это поведение. Отладчик по умолчанию активируется, когда задача завершается с ошибкой по недоступности. Используйте ключевое слово 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», система попытается определить их на основе типа подключения.

Тип

list

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

[‘smart’]

Ini

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

Окружение

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

Переменные

name: ansible_facts_modules

GALAXY_DISPLAY_PROGRESS

Описание

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

Тип

bool

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

None

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

2.10

Ini

Раздел: [galaxy]
Ключ: display_progress

Окружение

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

GALAXY_IGNORE_CERTS

Описание

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

Тип

boolean

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

False

Ini

Раздел: [galaxy]
Ключ: ignore_certs

Окружение

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

GALAXY_ROLE_SKELETON

Описание

Директория шаблона скелета роли или коллекции для использования в качестве шаблона для действия init в ansible-galaxy, аналогично --role-skeleton.

Тип

путь

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

None

Ini

Раздел: [galaxy]
Ключ: role_skeleton

Окружение

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

GALAXY_ROLE_SKELETON_IGNORE

Описание

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

Тип

список

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

[‘^.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.

Тип

список

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

2.9

Ini

Раздел: [galaxy]
Ключ: server_list

Окружение

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

GALAXY_TOKEN_PATH

Описание

Локальный путь к файлу токена доступа galaxy

Тип

путь

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

~/.ansible/galaxy_token

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

2.9

Ini

Раздел: [galaxy]
Ключ: token_path

Окружение

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

HOST_KEY_CHECKING

Описание

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

Тип

boolean

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

Истина

Ini

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

Окружение

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

HOST_PATTERN_MISMATCH

Описание

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

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

предупреждение

Варианты

предупреждение
ошибка
игнорировать

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

2.8

Ini

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

Окружение

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

INJECT_FACTS_AS_VARS

Описание

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

Тип

boolean

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

Истина

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

2.5

Ini

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

Окружение

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

INTERPRETER_PYTHON

Описание

Путь к интерпретатору Python, который будет использоваться для выполнения модулей на удалённых целевых объектах, или режим автоматического обнаружения. Поддерживаемые режимы обнаружения - auto, auto_silent, и auto_legacy (по умолчанию). Все режимы обнаружения используют таблицу поиска для использования системного Python (в дистрибутивах, известные как включающие его), обращаясь к фиксированному упорядоченному списку хорошо известных расположений интерпретаторов Python, если платформа-специфичный по умолчанию недоступен. Поведение по умолчанию выведет предупреждение о том, что интерпретатор должен быть явно указан (поскольку установленные позже интерпретаторы могут изменить используемый), Это поведение предупреждения может быть отключено путём установки auto_silent. Значение по умолчанию auto_legacy обеспечивает аналогичное поведение, но для обратной совместимости со старыми версиями Ansible, которые всегда по умолчанию использовали /usr/bin/python, будет использовать его, если он присутствует (и выдаст предупреждение, что поведение по умолчанию изменится на auto в будущих выпусках Ansible).

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

auto_legacy

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

2.8

Ini

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

Окружение

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

Переменные

название: ansible_python_interpreter

INTERPRETER_PYTHON_DISTRO_MAP

Значение по умолчанию: {‘centos’: {‘6’: ‘/usr/bin/python’, ‘8’: ‘/usr/libexec/platform-python’}, ‘debian’: {‘10’: ‘/usr/bin/python3’}, ‘fedora’: {‘23’: ‘/usr/bin/python3’}, ‘redhat’: {‘6’: ‘/usr/bin/python’, ‘8’: ‘/usr/libexec/platform-python’}, ‘rhel’: {‘6’: ‘/usr/bin/python’, ‘8’: ‘/usr/libexec/platform-python’}, ‘ubuntu’: {‘14’: ‘/usr/bin/python’, ‘16’: ‘/usr/bin/python3’}}
Добавлен в версии: 2.8

INTERPRETER_PYTHON_FALLBACK

Значение по умолчанию: [‘/usr/bin/python’, ‘python3.7’, ‘python3.6’, ‘python3.5’, ‘python2.7’, ‘python2.6’, ‘/usr/libexec/platform-python’, ‘/usr/bin/python3’, ‘python’]
Добавлен в версии: 2.8

INVALID_TASK_ATTRIBUTE_FAILED

Описание

Если ‘ложь’, неверные атрибуты задачи приведут к предупреждениям, а не ошибкам.

Тип

boolean

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

Истина

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

2.7

Ini

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

Окружение

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

INVENTORY_ANY_UNPARSED_IS_FAILED

Описание

Если ‘истина’, то считается фатальной ошибкой, если какой-либо заданный источник инвентаризации не может быть успешно распарсен любым доступным плагином инвентаризации; в противном случае эта ситуация вызывает только предупреждение.

Тип

boolean

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

Ложь

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

2.7

Ini

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

Окружение

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

INVENTORY_CACHE_ENABLED

Описание

Включить кеширование инвентаризации

Тип

bool

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

Ложь

Ini

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

Окружение

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

INVENTORY_CACHE_PLUGIN

Описание

Плагин для кэширования инвентаризации. Если INVENTORY_CACHE_PLUGIN не задан, можно использовать CACHE_PLUGIN.

Ini

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

Окружение

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

INVENTORY_CACHE_PLUGIN_CONNECTION

Описание

Подключение к кэшу инвентаризации. Если INVENTORY_CACHE_PLUGIN_CONNECTION не задан, можно использовать CACHE_PLUGIN_CONNECTION.

Ini

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

Окружение

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

INVENTORY_CACHE_PLUGIN_PREFIX

Описание

Префикс таблицы для плагина кеширования. Если INVENTORY_CACHE_PLUGIN_PREFIX не задан, можно использовать CACHE_PLUGIN_PREFIX.

По умолчанию

ansible_facts

Ini

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

Окружение

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

INVENTORY_CACHE_TIMEOUT

Описание

Таймаут истечения срока действия данных плагина кэширования инвентаря. Если INVENTORY_CACHE_TIMEOUT не задан, можно использовать CACHE_TIMEOUT.

По умолчанию

3600

Ini

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

Окружение

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

INVENTORY_ENABLED

Описание

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

Тип

список

По умолчанию

[‘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

Описание

Список расширений, которые нужно игнорировать при использовании каталога в качестве источника инвентаря.

Тип

список

По умолчанию

Ini

Раздел

[defaults]

Ключ

inventory_ignore_extensions
Раздел

[inventory]

Ключ

ignore_extensions

Окружение

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

INVENTORY_IGNORE_PATTERNS

Описание

Список шаблонов, которые нужно игнорировать при использовании каталога в качестве источника инвентаря.

Тип

список

По умолчанию

[]

Ini

Раздел

[defaults]

Ключ

inventory_ignore_patterns
Раздел

[inventory]

Ключ

ignore_patterns

Окружение

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

INVENTORY_UNPARSED_IS_FAILED

Description

Если ‘true’, то это критическая ошибка, если каждый потенциальный источник инвентаризации не может быть распарсен, в противном случае эта ситуация вызовет только предупреждение.

Type

bool

Default

False

Ini

Section: [inventory]
Key: unparsed_is_failed

Environment

Variable: ANSIBLE_INVENTORY_UNPARSED_FAILED

LOCALHOST_WARNING

Description

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

Type

boolean

Default

True

Version Added

2.6

Ini

Section: [defaults]
Key: localhost_warning

Environment

Variable: ANSIBLE_LOCALHOST_WARNING

MAX_FILE_SIZE_FOR_DIFF

Description

Максимальный размер файлов для отображения diff

Type

int

Default

104448

Ini

Section: [defaults]
Key: max_diff_size

Environment

Variable: ANSIBLE_MAX_DIFF_SIZE

MODULE_IGNORE_EXTS

Description

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

Type

list

Default

Ini

Section: [defaults]
Key: module_ignore_exts

Environment

Variable: ANSIBLE_MODULE_IGNORE_EXTS

NETCONF_SSH_CONFIG

Description

Эта переменная используется для включения бастиона/промежуточного хоста с подключением netconf. Если установлено в True, бастион/промежуточный хост ssh настройки должны быть присутствовать в файле ~/.ssh/config, альтернативно можно установить путь к файлу для пользовательской настройки ssh, чтобы прочитать настройки бастиона/промежуточного хоста.

Default

None

Ini

Section: [netconf_connection]
Key: ssh_config

Environment

Variable: ANSIBLE_NETCONF_SSH_CONFIG

NETWORK_GROUP_MODULES

Тип

список

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

[‘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
Переменная

NETWORK_GROUP_MODULES

Устарело в

2.12

Подробности об устаревании

переменные окружения без префикса ANSIBLE_ устарели

Альтернативы

переменная окружения ANSIBLE_NETWORK_GROUP_MODULES

ОЧИСТКА КЭША СТАРЫХ ПЛАГИНОВ

Описание

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

Тип

булево

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

False

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

2.8

Ini

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

Окружение

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

АВТОМАТИЧЕСКОЕ ДОБАВЛЕНИЕ КЛЮЧА PARAMIKO

Тип

булево

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

False

Ini

Раздел: [paramiko_connection]
Ключ: host_key_auto_add

Окружение

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

ПОИСК КЛЮЧЕЙ PARAMIKO

Тип

булево

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

True

Ini

Раздел: [paramiko_connection]
Ключ: look_for_keys

Окружение

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

ВРЕМЯ ОЖИДАНИЯ ПОСТОЯННОГО КОМАНДНОГО СОЕДИНЕНИЯ

Описание

Управляет временем ожидания ответа от удалённого устройства перед истечением времени ожидания постоянного соединения.

Тип

целое число

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

Ini

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

Окружение

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

ВРЕМЯ ОЖИДАНИЯ ПОВТОРНЫХ ПОДКЛЮЧЕНИЙ ПОСТОЯННОГО СОЕДИНЕНИЯ

Описание

Управляет временем ожидания повторных попыток подключения к постоянному соединению к локальному сокету домена.

Тип

целое число

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

Ini

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

Окружение

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

ВРЕМЯ ОЖИДАНИЯ ПОДКЛЮЧЕНИЯ ПОСТОЯННОГО СОЕДИНЕНИЯ

Описание

Управляет временем, в течение которого постоянное соединение будет оставаться неактивным перед его уничтожением.

Тип

целое число

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

Ini

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

Окружение

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

ДИРЕКТОРИЯ ПУТИ КОНТРОЛЯ ПОСТОЯННОГО СОЕДИНЕНИЯ

Описание

Путь к сокету, используемому системой сохранения соединений.

Тип

путь

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

~/.ansible/pc

Ini

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

Окружение

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

ДИРЕКТОРИЯ СКРИПТОВ PLAYBOOK

Описание

Ряд не-скриптов CLI имеет аргумент --playbook-dir; эта настройка задаёт значение по умолчанию для него.

Тип

путь

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

2.9

Ini

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

Окружение

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

КОРНЕВОЙ ДИРЕКТОРИЙ PLAYBOOK VARS

Описание

Устанавливает, какие директории playbook будут использоваться в качестве корня для обработки плагинов vars, включая поиск host_vars/group_vars. Опция top следует традиционному поведению, используя самую верхнюю директорию playbook в цепочке для поиска корневого каталога. Опция bottom следует поведению версии 2.4.0, используя текущую директорию playbook для поиска корневого каталога. Опция all проверяет родительские директории playbook, начиная с первого родителя.

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

top

Выбираемые значения

top
bottom
all

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

2.4.1

Ini

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

Окружение

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

PLUGIN_FILTERS_CFG

Описание

Путь к конфигурации для фильтрации установленных на системе плагинов, которые разрешено использовать. Подробности о формате файла фильтра см. в разделе Список запрещённых модулей. По умолчанию используется /etc/ansible/plugin_filters.yml

Тип

путь

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

None

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

2.5.0

Ini

Раздел

[default]

Ключ

plugin_filters_cfg

Устарело в версии

2.12

Детали устаревания

Указание «plugin_filters_cfg» в разделе «default» устарело

Альтернативы

используйте раздел «defaults»
Раздел

[defaults]

Ключ

plugin_filters_cfg

PYTHON_MODULE_RLIMIT_NOFILE

Описание

Попытка установить мягкое ограничение RLIMIT_NOFILE до указанного значения при выполнении Python-модулей (может ускорить использование подпроцессов в Python 2.x. См. https://bugs.python.org/issue11284). Значение будет ограничено существующим жёстким лимитом. Значение по умолчанию 0 не пытается настроить существующие системные лимиты.

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

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

2.8

Ini

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

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

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

Переменные

имя: ansible_python_module_rlimit_nofile

RETRY_FILES_ENABLED

Описание

Управляет созданием файла .retry для завершённого с ошибкой Ansible-плейбука.

Тип

bool

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

False

Ini

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

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

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

RETRY_FILES_SAVE_PATH

Описание

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

Тип

путь

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

None

Ini

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

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

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

RUN_VARS_PLUGINS

Описание

Это параметр оптимизирует использование vars_plugin в зависимости от размера инвентаризации пользователя и выбора плей. Установка в C(demand) запустит vars_plugins относительно источников инвентаризации каждый раз, когда переменные «требуются» задачами. Установка в C(start) запустит vars_plugins относительно источников инвентаризации после импорта этого источника.

Тип

строка

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

demand

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

demand
start

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

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

STRING_CONVERSION_ACTION

Описание

Действие, выполняемое при преобразовании значения параметра модуля в строку (это не влияет на переменные). Для строковых параметров значения, такие как ‘1.00’, “[‘a’, ‘b’,]”, и ‘yes’, ‘y’, и т.д. будут преобразованы анализатором YAML, если не будут полностью заключены в кавычки. Допустимые варианты: ‘error’, ‘warn’ и ‘ignore’. С версии 2.8 этот параметр имеет значение по умолчанию ‘warn’, но в версии 2.12 будет изменён на ‘error’.

Тип

строка

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

warn

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

2.8

Ini

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

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

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

STRING_TYPE_FILTERS

Описание

Этот список фильтров избегает «преобразования типов» при шаблонизации переменных. Полезно, когда вы хотите избежать преобразования в списки или словари для JSON-строк, например.

Тип

список

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

[‘string’, ‘to_json’, ‘to_nice_json’, ‘to_yaml’, ‘to_nice_yaml’, ‘ppretty’, ‘json’]

Ini

Раздел: [jinja2]
Ключ: dont_type_filters

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

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

SYSTEM_WARNINGS

Описание

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

Тип

булево

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

True

Ini

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

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

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

TAGS_RUN

Описание

список тегов по умолчанию для запуска в ваших задачах. Теги пропуска имеют приоритет.

Тип

список

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

[]

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

2.5

Ini

Раздел: [tags]
Ключ: run

Окружение

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

TAGS_SKIP

Описание

список тегов по умолчанию для пропуска в ваших задачах. Имеет приоритет над тегами запуска.

Тип

список

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

[]

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

2.5

Ini

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

Окружение

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

TASK_DEBUGGER_IGNORE_ERRORS

Описание

Этот параметр определяет, будет ли вызываться отладчик задач при ошибочной задаче, когда указано ignore_errors=True. True означает, что отладчик учтёт ignore_errors, False — нет.

Тип

булево

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

True

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

2.7

Ini

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

Окружение

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

TASK_TIMEOUT

Описание

Установите максимальное время (в секундах), которое может выполняться задача. Если установлено в 0 (значение по умолчанию), таймаут отсутствует.

Тип

целое число

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

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

2.10

Ini

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

Окружение

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

TRANSFORM_INVALID_GROUP_CHARS

Описание

Преобразовывает недопустимые символы в именах групп, предоставленных источниками инвентаризации. Если ‘never’, имя группы будет разрешено, но будет выдано предупреждение об ошибке. Если ‘ignore’, поведение аналогично ‘never’, но предупреждение не будет выведено. Если ‘always’, любые недопустимые символы будут заменены на ‘_’ (нижнее подчеркивание), и пользователю будет выведено предупреждение. Если ‘silently’, поведение аналогично ‘always’, но предупреждение не будет выведено.

Тип

строка

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

never

Варианты

always
never
ignore
silently

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

2.8

Ini

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

Окружение

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

USE_PERSISTENT_CONNECTIONS

Описание

Включает/выключает использование постоянных соединений.

Тип

булево

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

False

Ini

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

Окружение

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

VARIABLE_PLUGINS_ENABLED

Описание

Белый список для плагинов переменных, которые его требуют.

Тип

список

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

[‘host_group_vars’]

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

2.10

Ini

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

Окружение

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

VARIABLE_PRECEDENCE

Описание

Позволяет изменить порядок слияния переменных группы.

Тип

список

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

[‘all_inventory’, ‘groups_inventory’, ‘all_plugins_inventory’, ‘all_plugins_play’, ‘groups_plugins_inventory’, ‘groups_plugins_play’]

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

2.4

Ini

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

Окружение

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

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 только после подключения к трубе, поэтому общее максимальное время выполнения задачи будет увеличено на указанную здесь величину.

Тип

целое число

По умолчанию

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

2.10

Ini

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

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

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

Переменные

имя: ansible_win_async_startup_timeout

WORKER_SHUTDOWN_POLL_COUNT

Описание

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

Тип

целое число

По умолчанию

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

2.10

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

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

WORKER_SHUTDOWN_POLL_DELAY

Описание

Количество секунд ожидания между циклами опроса при проверке процессов-работников диспетчера очереди задач для проверки их корректного завершения. Только для внутреннего использования.

Тип

вещественное число

По умолчанию

0.1

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

2.10

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

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

YAML_FILENAME_EXTENSIONS

Описание

Проверяются все эти расширения при поиске файлов ‘переменные’, которые должны быть в формате YAML или JSON, или их зашифрованных версий. Это влияет на плагины vars_files, include_vars, inventory и vars, среди прочих.

Тип

список

По умолчанию

[‘.yml’, ‘.yaml’, ‘.json’]

Ini

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

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

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

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

ANSIBLE_CONFIG: Переопределение файла конфигурации ansible по умолчанию

ANSIBLE_CONNECTION_PATH

Указывает местоположение для поиска скрипта ansible-connection. Этот путь проверяется перед поиском в $PATH. Если пусто, ansible начнёт поиск с той же директории, что и скрипт ansible.

См. также ANSIBLE_CONNECTION_PATH

ANSIBLE_COW_SELECTION

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

См. также ANSIBLE_COW_SELECTION

ANSIBLE_COW_WHITELIST

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

См. также ANSIBLE_COW_WHITELIST

ANSIBLE_FORCE_COLOR

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

См. также ANSIBLE_FORCE_COLOR

ANSIBLE_NOCOLOR

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

См. также ANSIBLE_NOCOLOR

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_SSH_PIPELINING

См. также ANSIBLE_PIPELINING

ANSIBLE_SSH_ARGS

Если установлено, это переопределит аргументы ssh по умолчанию для Ansible. В частности, пользователи могут захотеть увеличить время ControlPersist для повышения производительности. Значение в 30 минут может быть подходящим. Учтите, что если -o ControlPath установлено в ssh_args, настройка пути управления не используется.

См. также ANSIBLE_SSH_ARGS

ANSIBLE_SSH_CONTROL_PATH

Это местоположение для сохранения сокетов ControlPath ssh, оно использует подстановку переменных ssh. С версии 2.3, если пусто, ansible сгенерирует уникальный хеш. Используйте %(directory)s для указания, где использовать настройки пути к каталогу управления. До версии 2.3 по умолчанию было control_path=%(directory)s/ansible-ssh-%%h-%%p-%%r. Учтите, что эта настройка игнорируется, если -o ControlPath установлено в ssh args.

См. также ANSIBLE_SSH_CONTROL_PATH

ANSIBLE_SSH_CONTROL_PATH_DIR

Это устанавливает директорию для использования ssh control path, если значение пути управления пусто. Также предоставляет переменную %(directory)s для настройки пути управления.

См. также ANSIBLE_SSH_CONTROL_PATH_DIR

ANSIBLE_SSH_EXECUTABLE

Определяет расположение бинарного файла ssh. По умолчанию ssh, который будет использовать первый доступный бинарный файл ssh в $PATH. Этот параметр обычно не требуется, он может быть полезен, когда доступ к системному ssh ограничен или при использовании оберток ssh для подключения к удалённым хостам.

См. также ANSIBLE_SSH_EXECUTABLE

ANSIBLE_SSH_RETRIES

Количество попыток установить подключение, прежде чем мы откажемся и сообщим о хосте как «НЕДОСТУПНО»

См. также ANSIBLE_SSH_RETRIES

ANSIBLE_ANY_ERRORS_FATAL

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

См. также ANY_ERRORS_FATAL

END_OF_DOCUMENT_MARKER

ANSIBLE_BECOME_ALLOW_SAME_USER

Эта настройка контролирует, пропускается ли become, когда удалённый пользователь и пользователь become совпадают. Т.е. root sudo к root.

См. также BECOME_ALLOW_SAME_USER

ANSIBLE_AGNOSTIC_BECOME_PROMPT

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

См. также AGNOSTIC_BECOME_PROMPT

ANSIBLE_CACHE_PLUGIN

Выбирает плагин кэширования для использования, по умолчанию ‘memory’ — временный.

См. также 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: См. также COLLECTIONS_SCAN_SYS_PATH

ANSIBLE_COLLECTIONS_PATHS

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

См. также COLLECTIONS_PATHS

ANSIBLE_COLLECTIONS_PATH

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

См. также COLLECTIONS_PATHS

Version Added: 2.10

ANSIBLE_COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH

При загрузке коллекции, которая не поддерживает текущую версию Ansible (через ключ метаданных коллекции requires_ansible), по умолчанию выводится предупреждение и выполнение продолжается. Установка этого значения в ignore полностью игнорирует предупреждение, в то время как установка в fatal немедленно останавливает выполнение 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

Определяет цвет, используемый при отображении добавленных строк в diff

См. также COLOR_DIFF_ADD

ANSIBLE_COLOR_DIFF_LINES

Определяет цвет, используемый при отображении diff

См. также COLOR_DIFF_LINES

ANSIBLE_COLOR_DIFF_REMOVE

Определяет цвет, используемый при отображении удалённых строк в diff

См. также COLOR_DIFF_REMOVE

ANSIBLE_COLOR_ERROR

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

См. также COLOR_ERROR

ANSIBLE_COLOR_HIGHLIGHT

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

См. также COLOR_HIGHLIGHT

ANSIBLE_COLOR_OK

Определяет цвет для отображения статуса задачи «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_CONDITIONAL_BARE_VARS

При включённой настройке (True), условные вычисления ‘var’ обрабатываются иначе, чем ‘var.subkey’, так как первое вычисляется непосредственно, а второе проходит через парсер Jinja2. Но строки ‘false’ в ‘var’ вычисляются как булевы значения. При выключенной настройке оба вычисляются одинаково, но в случаях, когда ‘var’ было ‘false’ (строка), оно больше не вычисляется как булево значение. В настоящее время эта настройка по умолчанию установлена в ‘True’, но вскоре будет изменена на ‘False’, а сама настройка будет удалена в будущем. Ожидайте, что эта настройка в конечном итоге будет устарела после 2.12

См. также CONDITIONAL_BARE_VARS

_ANSIBLE_COVERAGE_REMOTE_OUTPUT

Устанавливает выходной каталог на удалённом хосте для генерации отчётов о покрытие. В настоящее время используется только для удалённого покрытия модулей PowerShell. Только для внутреннего использования.

См. также COVERAGE_REMOTE_OUTPUT

_ANSIBLE_COVERAGE_REMOTE_WHITELIST

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

См. также COVERAGE_REMOTE_WHITELIST

ANSIBLE_ACTION_WARNINGS

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

См. также ACTION_WARNINGS

ANSIBLE_COMMAND_WARNINGS

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

См. также COMMAND_WARNINGS

ANSIBLE_LOCALHOST_WARNING

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

См. также LOCALHOST_WARNING

ANSIBLE_DOC_FRAGMENT_PLUGINS

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

См. также DOC_FRAGMENT_PLUGIN_PATH

ANSIBLE_ACTION_PLUGINS

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

См. также DEFAULT_ACTION_PLUGIN_PATH

END_OF_DOCUMENT_MARKER

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_CALLABLE_WHITELIST

Белый список вызываемых методов, которые должны быть доступны для оценки шаблонов

См. также DEFAULT_CALLABLE_WHITELIST

ANSIBLE_CALLBACK_PLUGINS

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

См. также DEFAULT_CALLBACK_PLUGIN_PATH

ANSIBLE_CALLBACK_WHITELIST

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

См. также DEFAULT_CALLBACK_WHITELIST

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_FACT_PATH

Этот параметр позволяет вам глобально настроить пользовательский путь для «local_facts» для предполагаемой задачи M(ansible.builtin.setup) при использовании сбора фактов. Если он не задан, он вернется к значению по умолчанию из модуля M(ansible.builtin.setup): /etc/ansible/facts.d.Это не влияет на пользовательские задачи, использующие модуль M(ansible.builtin.setup).

См. также DEFAULT_FACT_PATH

ANSIBLE_FILTER_PLUGINS

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

См. также DEFAULT_FILTER_PLUGIN_PATH

ANSIBLE_FORCE_HANDLERS

Этот параметр управляет тем, запускаются ли уведомленные обработчики на узле, даже если на этом узле произошел сбой. Если значение false, обработчики не будут выполняться, если на узле произошел сбой. Его также можно задать в плейбуке или в командной строке. Дополнительные сведения см. в разделе Обработчики и сбои.

См. также DEFAULT_FORCE_HANDLERS

ANSIBLE_FORKS

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

См. также DEFAULT_FORKS

ANSIBLE_GATHERING

Эта настройка контролирует политику сбора фактов (фактов, обнаруженных о удалённых системах) по умолчанию. При значении «неявный» (по умолчанию) плагин кэша будет игнорироваться, и факты будут собираться для каждого плейбука, если не установлено «gather_facts: False». При значении «явный» наоборот, факты не будут собираться, если их не запросить непосредственно в плейбуке. Значение «умный» означает, что каждый новый узел, на котором нет обнаруженных фактов, будет сканироваться, но если к одному и тому же узлу обращаются в нескольких плейбуках, к нему не будет обращаться повторно при выполнении плейбука. Этот параметр может быть полезен для тех, кто хочет сэкономить время на сборе фактов. Как «умный», так и «явный» будут использовать плагин кэша.

См. также DEFAULT_GATHERING

ANSIBLE_GATHER_SUBSET

Установите параметр gather_subset для задачи M(ansible.builtin.setup) в неявном сборе фактов. См. документацию модуля для получения подробностей. Он не применяется к пользовательским задачам M(ansible.builtin.setup).

См. также DEFAULT_GATHER_SUBSET

ANSIBLE_GATHER_TIMEOUT

Установите таймаут в секундах для неявного сбора фактов. Он не применяется к пользовательским задачам M(ansible.builtin.setup).

См. также DEFAULT_GATHER_TIMEOUT

ANSIBLE_HANDLER_INCLUDES_STATIC

Начиная с версии 2.0, M(ansible.builtin.include) может быть «динамическим», эта настройка (если True) принудительно устанавливает, что если include появляется в разделе handlers, он будет «статическим».

См. также DEFAULT_HANDLER_INCLUDES_STATIC

ANSIBLE_HASH_BEHAVIOUR

Эта настройка управляет тем, как переменные объединяются в Ansible. По умолчанию Ansible будет перезаписывать переменные в определенных порядках приоритета, как описано в Переменных. Когда переменная с более высоким приоритетом побеждает, она заменит другое значение. Некоторые пользователи предпочитают, чтобы переменные, которые являются хэшами (также известными как «словари» в Python), объединялись. Эта настройка называется «объединение». Это не поведение по умолчанию, и это не влияет на переменные, значения которых являются скалярами (целые числа, строки) или массивами. Мы в целом рекомендуем не использовать эту настройку, если вы не считаете, что у вас есть абсолютная необходимость в ней, и плейбуки в официальных репозиториях примеров не используют эту настройку. В версии 2.0 был добавлен фильтр combine, чтобы можно было сделать это для конкретной переменной (описано в Фильтрах).

См. также DEFAULT_HASH_BEHAVIOUR

ANSIBLE_INVENTORY

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

См. также DEFAULT_HOST_LIST

ANSIBLE_HTTPAPI_PLUGINS

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

См. также DEFAULT_HTTPAPI_PLUGIN_PATH

END_OF_DOCUMENT_MARKER

ANSIBLE_INVENTORY_PLUGINS

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

См. также DEFAULT_INVENTORY_PLUGIN_PATH

ANSIBLE_JINJA2_EXTENSIONS

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

См. также DEFAULT_JINJA2_EXTENSIONS

ANSIBLE_JINJA2_NATIVE

Этот параметр сохраняет типы переменных во время операций с шаблонами. Требуется Jinja2 >= 2.10.

См. также DEFAULT_JINJA2_NATIVE

ANSIBLE_KEEP_REMOTE_FILES

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

См. также DEFAULT_KEEP_REMOTE_FILES

LIBVIRT_LXC_NOSECLABEL

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

См. также DEFAULT_LIBVIRT_LXC_NOSECLABEL

Устарело в: 2.12
Подробности об устаревании: переменные окружения без префикса ANSIBLE_ устарели
Альтернативы при устаревании: переменная окружения ANSIBLE_LIBVIRT_LXC_NOSECLABEL

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

Это устанавливает аргументы по умолчанию, которые необходимо передать бинарному файлу adhoc 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

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

См. также 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_SCP_IF_SSH

Предпочитаемый метод при передаче файлов по SSH. При значении smart Ansible будет пытаться использовать их, пока один из них не увенчается успехом или все не завершатся неудачей. Если значение True, то принудительно используется ‘scp’, если False, то ‘sftp’.

См. также DEFAULT_SCP_IF_SSH

ANSIBLE_SELINUX_SPECIAL_FS

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

См. также DEFAULT_SELINUX_SPECIAL_FS

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

ANSIBLE_SFTP_BATCH_MODE: См. также DEFAULT_SFTP_BATCH_MODE

ANSIBLE_SQUASH_ACTIONS

Ansible может оптимизировать действия, вызывающие модули, поддерживающие параметры списка при использовании with_ циклов. Вместо вызова модуля один раз для каждого элемента, модуль вызывается один раз со списком целиком. Значение по умолчанию этой настройки относится только к определённым менеджерам пакетов, но может быть использовано для любого модуля. В настоящее время это поддерживается только для модулей с параметром name или pkg, и только когда элемент является единственным передаваемым параметром.

См. также DEFAULT_SQUASH_ACTIONS

ANSIBLE_SSH_TRANSFER_METHOD

не используется?

См. также DEFAULT_SSH_TRANSFER_METHOD

END_OF_DOCUMENT_MARKER

ANSIBLE_STDOUT_CALLBACK

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

См. также DEFAULT_STDOUT_CALLBACK

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

Установить используемую по умолчанию стратегию для плейбуков.

См. также DEFAULT_STRATEGY

ANSIBLE_STRATEGY_PLUGINS

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

См. также DEFAULT_STRATEGY_PLUGIN_PATH

ANSIBLE_SU

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

См. также DEFAULT_SU

ANSIBLE_SYSLOG_FACILITY

Обслуживание системного журнала для использования при ведении журнала Ansible на удаленном целевом узле

См. также DEFAULT_SYSLOG_FACILITY

ANSIBLE_TASK_INCLUDES_STATIC

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

См. также DEFAULT_TASK_INCLUDES_STATIC

ANSIBLE_TERMINAL_PLUGINS

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

См. также DEFAULT_TERMINAL_PLUGIN_PATH

ANSIBLE_TEST_PLUGINS

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

См. также DEFAULT_TEST_PLUGIN_PATH

ANSIBLE_TIMEOUT

Это значение по умолчанию для таймаута для использования плагинами соединений.

См. также DEFAULT_TIMEOUT

ANSIBLE_TRANSPORT

Плагин подключения по умолчанию для использования, опция «smart» будет переключаться между «ssh» и «paramiko» в зависимости от операционной системы контроллера и версий ssh.

См. также DEFAULT_TRANSPORT

ANSIBLE_ERROR_ON_UNDEFINED_VARS

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

См. также DEFAULT_UNDEFINED_VAR_BEHAVIOR

ANSIBLE_VARS_PLUGINS

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

См. также DEFAULT_VARS_PLUGIN_PATH

ANSIBLE_VAULT_ID_MATCH

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

См. также DEFAULT_VAULT_ID_MATCH

ANSIBLE_VAULT_IDENTITY

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

См. также DEFAULT_VAULT_IDENTITY

ANSIBLE_VAULT_ENCRYPT_IDENTITY

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

См. также DEFAULT_VAULT_ENCRYPT_IDENTITY

ANSIBLE_VAULT_IDENTITY_LIST

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

См. также DEFAULT_VAULT_IDENTITY_LIST

ANSIBLE_VAULT_PASSWORD_FILE

Файл пароля хранилища vault, используемый по умолчанию. Эквивалентно –vault-password-file или –vault-id

См. также 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 вашей среды (никто не может выполнить shoulder surfing и вы не сохраняете stdout в небезопасный файл) или убедитесь, что все ваши плейбуки явно добавили параметр no_log: True к задачам, имеющим конфиденциальные значения. Для получения дополнительной информации см. раздел Как сохранить конфиденциальные данные в плейбуке?

См. также DISPLAY_ARGS_TO_STDOUT

DISPLAY_SKIPPED_HOSTS

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

См. также DISPLAY_SKIPPED_HOSTS

Устарело в: 2.12
Подробности об устаревании: переменные окружения без префикса ANSIBLE_ устарели
Альтернативы: переменная окружения ANSIBLE_DISPLAY_SKIPPED_HOSTS

ANSIBLE_DISPLAY_SKIPPED_HOSTS

См. также DISPLAY_SKIPPED_HOSTS

ANSIBLE_DUPLICATE_YAML_DICT_KEY

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

См. также DUPLICATE_YAML_DICT_KEY

ANSIBLE_ERROR_ON_MISSING_HANDLER

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

См. также ERROR_ON_MISSING_HANDLER

END_OF_DOCUMENT_MARKER

ANSIBLE_CONNECTION_FACTS_MODULES

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

См. также CONNECTION_FACTS_MODULES

ANSIBLE_FACTS_MODULES

Какие модули следует запускать на стадии сбора фактов в ходе выполнения задачи. По умолчанию используется «smart», который пытается определить их на основе типа подключения.

См. также FACTS_MODULES

ANSIBLE_GALAXY_IGNORE

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

См. также GALAXY_IGNORE_CERTS

ANSIBLE_GALAXY_ROLE_SKELETON

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

См. также GALAXY_ROLE_SKELETON

ANSIBLE_GALAXY_ROLE_SKELETON_IGNORE

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

См. также GALAXY_ROLE_SKELETON_IGNORE

ANSIBLE_GALAXY_SERVER

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

См. также GALAXY_SERVER

ANSIBLE_GALAXY_SERVER_LIST

Список серверов Galaxy, используемых при установке коллекции. Значение соответствует заголовку ini-файла конфигурации [galaxy_server.{{item}}], который определяет данные сервера. См. Настройка клиента ansible-galaxy для получения более подробной информации о том, как определить сервер 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_HOST_KEY_CHECKING

Установите значение «False», чтобы отключить проверку ключа хоста используемыми Ansible инструментами подключения к хосту.

См. также HOST_KEY_CHECKING

ANSIBLE_HOST_PATTERN_MISMATCH

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

См. также HOST_PATTERN_MISMATCH

ANSIBLE_PYTHON_INTERPRETER

Путь к интерпретатору Python, который будет использоваться для выполнения модулей на удаленных целевых узлах или автоматический режим обнаружения. Поддерживаемые режимы обнаружения: auto, auto_silent, и auto_legacy (по умолчанию). Все режимы обнаружения используют таблицу поиска для использования системного интерпретатора Python (в известных дистрибутивах), возвращаясь к фиксированному упорядоченному списку известных расположений интерпретатора Python, если платформенно-специфичный интерпретатор не доступен. Поведение по умолчанию будет выдавать предупреждение о том, что интерпретатор необходимо установить явно (поскольку установленные позже интерпретаторы могут изменить используемый), Это поведение предупреждений можно отключить, установив auto_silent. Значение по умолчанию auto_legacy обеспечивает такое же поведение, но для обратной совместимости со старыми версиями Ansible, в которых по умолчанию всегда использовался /usr/bin/python, будет использовать этот интерпретатор, если он присутствует (и выдавать предупреждение о том, что поведение по умолчанию изменится на такое же, как у auto в будущей версии Ansible).

См. также 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_CACHE

Включение кэширования инвентаризации.

См. также INVENTORY_CACHE_ENABLED

ANSIBLE_INVENTORY_CACHE_PLUGIN

Плагин для кэширования инвентаризации. Если INVENTORY_CACHE_PLUGIN не указан, можно использовать CACHE_PLUGIN.

См. также INVENTORY_CACHE_PLUGIN

ANSIBLE_INVENTORY_CACHE_CONNECTION

Подключение к кэшу инвентаризации. Если INVENTORY_CACHE_PLUGIN_CONNECTION не указан, можно использовать CACHE_PLUGIN_CONNECTION.

См. также INVENTORY_CACHE_PLUGIN_CONNECTION

ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX

Префикс таблицы для плагина кэша. Если INVENTORY_CACHE_PLUGIN_PREFIX не указан, можно использовать CACHE_PLUGIN_PREFIX.

См. также INVENTORY_CACHE_PLUGIN_PREFIX

ANSIBLE_INVENTORY_CACHE_TIMEOUT

Срок действия кэша плагина инвентаризации. Если INVENTORY_CACHE_TIMEOUT не указан, можно использовать CACHE_TIMEOUT.

См. также INVENTORY_CACHE_TIMEOUT

ANSIBLE_INVENTORY_ENABLED

Список включенных плагинов инвентаризации, а также порядок их использования.

См. также INVENTORY_ENABLED

ANSIBLE_INVENTORY_EXPORT

Определяет, будет ли ansible-inventory точно отражать представление Ansible об инвентаризации или оптимизирован для экспорта.

См. также 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

NETWORK_GROUP_MODULES

См. также NETWORK_GROUP_MODULES

Устарело в: 2.12
Подробности об устаревании: переменные среды без префикса ANSIBLE_ устарели
Альтернативы: переменная среды ANSIBLE_NETWORK_GROUP_MODULES

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_OLD_PLUGIN_CACHE_CLEAR

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

См. также OLD_PLUGIN_CACHE_CLEARING

ANSIBLE_PARAMIKO_HOST_KEY_AUTO_ADD: См. также PARAMIKO_HOST_KEY_AUTO_ADD

ANSIBLE_PARAMIKO_LOOK_FOR_KEYS: См. также PARAMIKO_LOOK_FOR_KEYS

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

У ряда CLI без плейбуков есть аргумент --playbook-dir; эта настройка устанавливает значение по умолчанию для него.

См. также PLAYBOOK_DIR

ANSIBLE_PLAYBOOK_VARS_ROOT

Это задаёт, какие каталоги плейбуков будут использоваться в качестве корня для обработки плагинов переменных, включая поиск host_vars/group_vars.Вариант top следует традиционному поведению, используя самый верхний плейбук в цепочке для поиска корневого каталога.Вариант bottom следует поведению от версии 2.4.0, используя текущий плейбук для поиска корневого каталога.Вариант all проверяет от первого родительского до текущего плейбука.

См. также PLAYBOOK_VARS_ROOT

ANSIBLE_PYTHON_MODULE_RLIMIT_NOFILE

Попытка установить мягкое ограничение RLIMIT_NOFILE до указанного значения при выполнении Python-модулей (может ускорить использование подпроцессов в 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 включены. Этот файл будет перезаписываться после каждого запуска с списком неудачных хостов из всех задач.

См. также RETRY_FILES_SAVE_PATH

ANSIBLE_RUN_VARS_PLUGINS

Это настройка может использоваться для оптимизации использования vars_plugins в зависимости от размера инвентаризации пользователя и выбора задачи. Установка в C(demand) запустит vars_plugins относительно источников инвентаризации всякий раз, когда переменные «требуются» задачами. Установка в C(start) запустит vars_plugins относительно источников инвентаризации после импорта этого источника инвентаризации.

См. также RUN_VARS_PLUGINS

ANSIBLE_SHOW_CUSTOM_STATS

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

См. также SHOW_CUSTOM_STATS

ANSIBLE_STRING_TYPE_FILTERS

См. также STRING_TYPE_FILTERS

ANSIBLE_SYSTEM_WARNINGS

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

См. также SYSTEM_WARNINGS

ANSIBLE_RUN_TAGS

Список тегов по умолчанию для запуска в ваших задачах. Теги пропуска имеют приоритет.

См. также TAGS_RUN

ANSIBLE_SKIP_TAGS

Список тегов по умолчанию для пропуска в ваших задачах, имеет приоритет над тегами запуска.

См. также TAGS_SKIP

ANSIBLE_TASK_TIMEOUT

Установите максимальное время (в секундах), которое может выполняться задача. Если установлено в 0 (по умолчанию), таймаут отсутствует.

См. также TASK_TIMEOUT

ANSIBLE_WORKER_SHUTDOWN_POLL_COUNT

Максимальное количество проверок процессов Task Queue Manager, чтобы убедиться, что они завершились без ошибок. После достижения этого лимита любые ещё работающие процессы будут завершены. Используется только внутри Ansible.

См. также WORKER_SHUTDOWN_POLL_COUNT

ANSIBLE_WORKER_SHUTDOWN_POLL_DELAY

Количество секунд, которые нужно подождать между циклами опроса при проверке процессов Task Queue Manager, чтобы убедиться, что они завершились без ошибок. Используется только внутри Ansible.

См. также WORKER_SHUTDOWN_POLL_DELAY

ANSIBLE_USE_PERSISTENT_CONNECTIONS

Включает/выключает использование сохраняемых соединений.

См. также USE_PERSISTENT_CONNECTIONS

ANSIBLE_VARS_ENABLED

Белый список для плагинов переменных, которые требуют его.

См. также VARIABLE_PLUGINS_ENABLED

ANSIBLE_PRECEDENCE

Позволяет изменить порядок слияния приоритетов переменных группы.

См. также VARIABLE_PRECEDENCE

END_OF_DOCUMENT_MARKER

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, инвентаризацию и плагины vars, среди прочих.

См. также YAML_FILENAME_EXTENSIONS

ANSIBLE_NETCONF_SSH_CONFIG

Эта переменная используется для включения бастионного/промежуточного хоста с подключением netconf. Если установлено значение True, настройки бастионного/промежуточного хоста должны быть присутствовать в файле ~/.ssh/config, или можно указать путь к кастомному файлу конфигурации ssh, чтобы прочитать настройки бастионного/промежуточного хоста.

См. также NETCONF_SSH_CONFIG

ANSIBLE_STRING_CONVERSION_ACTION

Действие, которое нужно выполнить при преобразовании значения параметра модуля в строку (это не влияет на переменные). Для строковых параметров значения, такие как «1.00», «[‘a’, ‘b’,]» и «yes», «y» и т. п., будут преобразованы парсером YAML, если не заключены в кавычки полностью. Допустимые значения — «error», «warn» и «ignore». Начиная с версии 2.8, этот параметр по умолчанию устанавливается в «warn», но в версии 2.12 он изменится на «error».

См. также STRING_CONVERSION_ACTION

ANSIBLE_VERBOSE_TO_STDERR

Принудительное использование параметра «verbose» для вывода в stderr вместо stdout

См. также VERBOSE_TO_STDERR

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/reference_appendices/config.html

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

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

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

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

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

ACTION_WARNINGS

AGNOSTIC_BECOME_PROMPT

ALLOW_WORLD_READABLE_TMPFILES

ANSIBLE_CONNECTION_PATH

ANSIBLE_COW_PATH

ANSIBLE_COW_SELECTION

ANSIBLE_COW_WHITELIST

ANSIBLE_FORCE_COLOR

ANSIBLE_NOCOLOR

ANSIBLE_NOCOWS

ANSIBLE_PIPELINING

ANSIBLE_SSH_ARGS

ANSIBLE_SSH_CONTROL_PATH

ANSIBLE_SSH_CONTROL_PATH_DIR

ANSIBLE_SSH_EXECUTABLE

ANSIBLE_SSH_RETRIES

ANY_ERRORS_FATAL

BECOME_ALLOW_SAME_USER

BECOME_PLUGIN_PATH

CACHE_PLUGIN

CACHE_PLUGIN_CONNECTION

CACHE_PLUGIN_PREFIX

CACHE_PLUGIN_TIMEOUT

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_ERROR

COLOR_HIGHLIGHT

COLOR_OK

COLOR_SKIP

COLOR_UNREACHABLE

COLOR_VERBOSE

COLOR_WARN

COMMAND_WARNINGS

CONDITIONAL_BARE_VARS

CONNECTION_FACTS_MODULES

COVERAGE_REMOTE_OUTPUT

COVERAGE_REMOTE_WHITELIST

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_CALLABLE_WHITELIST

DEFAULT_CALLBACK_PLUGIN_PATH

DEFAULT_CALLBACK_WHITELIST

DEFAULT_CLICONF_PLUGIN_PATH

DEFAULT_CONNECTION_PLUGIN_PATH

DEFAULT_DEBUG

DEFAULT_EXECUTABLE

DEFAULT_FACT_PATH

DEFAULT_FILTER_PLUGIN_PATH

DEFAULT_FORCE_HANDLERS

DEFAULT_FORKS

DEFAULT_GATHER_SUBSET

DEFAULT_GATHER_TIMEOUT

DEFAULT_GATHERING

DEFAULT_HANDLER_INCLUDES_STATIC

DEFAULT_HASH_BEHAVIOUR

DEFAULT_HOST_LIST

DEFAULT_HTTPAPI_PLUGIN_PATH

DEFAULT_INTERNAL_POLL_INTERVAL

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