Конфигурационные файлы ansible.cfg#
ansible.cfg — это основной файл, который используется для настройки поведения Ansible Core. Он позволяет задавать различные параметры и настройки, влияющие на выполнение команд, playbooks и взаимодействие с удаленными хостами. Файл может находиться в нескольких местах, и Ansible Core будет искать его в следующем порядке:
Текущий каталог
./ansible.cfg.Домашний каталог пользователя
~/.ansible.cfg.Системный файл конфигурации
/etc/ansible/ansible.cfg.
Строки, начинающиеся с символа ;, являются комментариями и игнорируются при обработке.
Параметры#
Параметр |
Описание |
Тип |
Значение по умолчанию |
Секция файла |
Ключ |
Переменная окружения |
|---|---|---|---|---|---|---|
|
Выдать предупреждение по умолчанию, когда оно будет получено от действия задачи. Вывод данных предупреждений можно отменить, установив значение параметра |
boolean |
|
|
|
|
|
Отобразить в командной строке для пользователя нейтральный запрос повышения привилегий (без указания конкретного метода их повышения, например, |
boolean |
|
|
|
|
|
Указать, где искать скрипт |
path |
|
|
|
|
|
Принять список шаблонов cowsay-сообщений, которые являются «безопасными» для использования, установить пустой список, если необходимо разрешить все установленные шаблоны |
list |
|
|
|
|
|
Указать пользовательский путь к cowsay-сообщениям или заменить его на пользовательскую реализацию по выбору |
string |
|
|
|
|
|
Выбрать конкретный шаблон cowsay-сообщений для баннеров или использовать «random», чтобы циклически переключаться между ними |
string |
|
|
|
|
|
Включить принудительно «цветной» режим вывода (подсветку сообщений разными цветами), даже если Ansible Core выполняется без TTY или настройка «nocolor» установлена в |
boolean |
|
|
|
|
|
Установить путь по умолчанию для файлов конфигурации Ansible Core на контроллере |
path |
|
|
|
|
|
Выводить текст без цветового оформления - используется для лучшего отображения информации о сбоях и статусе |
boolean |
|
|
|
|
|
Отключить сообщения утилиты |
boolean |
|
|
|
|
|
Установить глобальный параметр, который может быть переопределен для каждого плагина подключения. Pipelining (потоковая передача данных), если поддерживается плагином подключения, уменьшает количество сетевых операций, необходимых для выполнения модуля на удаленном сервере, выполняя многие модули Ansible Core без фактической передачи файлов. Это может привести к значительному улучшению производительности при включении, но конфликтует с повышением привилегий ( |
boolean |
|
|
|
|
|
Установить значение по умолчанию для ключевого слова |
boolean |
|
|
|
|
|
Изменить поведение - когда |
boolean |
|
|
|
|
|
Указать файл пароля для использования с плагином повышения привилегий. Если файл исполняемый, он будет запущен, и полученный вывод будет использоваться в качестве пароля |
path |
|
|
|
|
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины повышения привилегий |
pathspec |
|
|
|
|
|
Выбрать, какой плагин кеширования использовать |
string |
|
|
|
|
|
Определить информацию о соединении или пути для плагина кеша |
|
|
|
|
|
|
Использовать префикс для файлов/таблиц плагина кеша |
|
|
|
|
|
|
Установить время истечения для данных плагина кеша |
integer |
|
|
|
|
|
Указать список включенных обратных вызовов; не все доступные обратные вызовы обязательны для активации - пользователи сами выбирают, какие из них необходимы |
list |
|
|
|
|
|
Определить действие при загрузке коллекции, не поддерживающей текущую версию Ansible Core |
string |
|
|
|
|
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать содержимое коллекций |
pathspec |
|
|
|
|
|
Включить или отключить сканирование |
boolean |
|
|
|
|
|
Определить цвет, используемый для статуса задачи «Changed» |
string |
|
|
|
|
|
Определить цвет, используемый по умолчанию для |
string |
|
|
|
|
|
Определить цвет, используемый при выводе отладочных сообщений |
string |
|
|
|
|
|
Определить цвет, используемый при выводе предупреждений об использовании устаревших функций или методов |
string |
|
|
|
|
|
Определить цвет, используемый для отображения добавленных строк в diffs |
string |
|
|
|
|
|
Определить цвет, используемый для отображения diffs |
string |
|
|
|
|
|
Определить цвет, используемый для отображения удаленных строк в diffs |
string |
|
|
|
|
|
Определить цвет, используемый для отображения констант в выводе |
string |
|
|
|
|
|
Определить цвет, используемый при выводе устаревшего значения в выводе |
string |
|
|
|
|
|
Определить цвет, используемый при выводе ссылки в выводе |
string |
|
|
|
|
|
Определить цвет, используемый при выводе имени модуля в выводе |
string |
|
|
|
|
|
Определить цвет, используемый при выводе имени плагина в выводе |
string |
|
|
|
|
|
Определить цвет, используемый при выводе перекрестной ссылки в выводе |
string |
|
|
|
|
|
Определить цвет, используемый при выводе сообщений об ошибках |
string |
|
|
|
|
|
Определить цвет, используемый для выделения |
string |
|
|
|
|
|
Определить цвет, используемый при отображении статуса задачи «Included» |
string |
|
|
|
|
|
Определить цвет, используемый при отображении статуса задачи «OK» |
string |
|
|
|
|
|
Определить цвет, используемый при отображении статуса задачи «Skipped» |
string |
|
|
|
|
|
Определить цвет, используемый для статуса «Unreachable» |
string |
|
|
|
|
|
Определить цвет, используемый при выводе подробных сообщений |
string |
|
|
|
|
|
Определить цвет, используемый при выводе предупреждающих сообщений |
string |
|
|
|
|
|
Указать, какие модули запускать во время этапа сбора фактов (информации о целевых хостах перед выполнением задач, которая может включать данные о системе - операционная система, версия, доступная память, процессоры, сетевые интерфейсы и др.) в зависимости от соединения |
dict |
|
|||
|
Задать файл пароля, который следует использовать для плагина соединения |
path |
|
|
|
|
|
Установить путь к каталогу на удаленном хосте для генерации отчетов о покрытии (показывают, какая часть кода была протестирована с помощью автоматизированных тестов) |
str |
|
|||
|
Определить список путей для файлов на контроллере Ansible Core для выполнения покрытия на удаленном хосте |
str |
|
|
||
|
Определить пути, разделенные двоеточием, в которых Ansible Core будет искать плагины действий |
pathspec |
|
|
|
|
|
Позволить плагинам поиска возвращать данные, не помеченные как «небезопасные» |
boolean |
|
|
|
|
|
Указать, должен ли playbook Ansible Core запрашивать пароль для входа. Если используются SSH-ключи для аутентификации, то не нужно изменять эту настройку |
boolean |
|
|
|
|
|
Указать, должен ли playbook Ansible Core запрашивать пароль для хранилища |
boolean |
|
|
|
|
|
Задать использование повышения привилегий, позволяющего «стать» другим пользователем после входа |
boolean |
|
|
|
|
|
Включить/отключить запрос пароля повышения привилегий |
boolean |
|
|
|
|
|
Указать исполняемый файл для использования при повышении привилегий, в противном случае Ansible Core будет зависеть от |
string |
|
|
|
|
|
Задать флаги, которые передаются исполняемому файлу повышения привилегий |
string |
`` |
|
|
|
|
Задать метод повышения привилегий, который следует использовать, когда включено повышение привилегий |
string |
|
|
|
|
|
Указать пользователя, которым становятся при использовании повышения привилегий; большинство систем будут использовать |
string |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины кеша |
pathspec |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины обратных вызовов |
pathspec |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины cliconf (плагины, которые позволяют управлять сетевыми устройствами через командную строку) |
pathspec |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины соединения |
pathspec |
|
|
|
|
|
Вывести отладочную информацию в Ansible Core. Может привести к очень многословному выводу, затрудняющему восприятие информации, особенно в многопоточных сценариях |
boolean |
|
|
|
|
|
Указать команду, используемую для запуска оболочки, что необходимо для выполнения Ansible Core на целевом хосте |
string |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины фильтров Jinja2 |
pathspec |
|
|
|
|
|
Указать, будут ли выполняться на хосте обработчики в случае получения ими уведомлений о произошедших на этом хосте ошибках |
boolean |
|
|
|
|
|
Указать максимальное количество процессов, которые Ansible Core будет использовать для выполнения задач на целевых хостах |
integer |
|
|
|
|
|
Указать политику сбора фактов (информации о целевых хостах перед выполнением задач, которая может включать данные о системе - операционная система, версия, доступная память, процессоры, сетевые интерфейсы и др.) по умолчанию. Полезно для экономии времени на сбор фактов |
string |
|
|
|
|
|
Указать, как обрабатываются дублирующие определения переменных словаря |
string |
|
|
|
|
|
Задать список источников inventory Ansible Core, разделенный запятыми |
pathlist |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины HttpApi |
pathspec |
|
|
|
|
|
Установить интервал (в секундах) опроса внутренних процессов Ansible Core друг друга |
float |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины inventory |
pathspec |
|
|
|
|
|
Включить дополнительные расширения Jinja2 |
list |
|
|
|
|
|
Сохранить типы переменных во время операций с шаблонами |
boolean |
|
|
|
|
|
Включить/отключить очистку временных файлов, которые Ansible Core использовал для выполнения задач на удаленном хосте |
boolean |
|
|
|
|
|
Заставить |
boolean |
|
|
|
|
|
Указать, загружаются ли плагины обратных вызовов при запуске |
boolean |
|
|
|
|
|
Задать временный каталог для использования Ansible Core на контроллере |
tmppath |
|
|
|
|
|
Задать список имен журналов, которые следует исключить из файла журнала |
list |
|
|
|
|
|
Указать файл, в который Ansible Core будет записывать журналы на контроллере. Если не установлен, ведение журнала отключено |
path |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины поиска |
pathspec |
|
|
|
|
|
Установить макрос для переменной |
string |
|
|
|
|
|
Установить аргументы по умолчанию, которые передаются в |
string |
|
|
|
|
|
Обозначить схему сжатия, используемую при передаче Python-модулей на целевой хост |
string |
|
|
|
|
|
Указать модуль, который следует использовать с командой |
string |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать модули |
pathspec |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать файлы утилит модулей, которые используются модулями |
pathspec |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины Netconf |
pathspec |
|
|
|
|
|
Включить отображение и ведение журнала деталей задач Ansible Core, в основном используется для предотвращения раскрытия информации о безопасности |
boolean |
|
|
|
|
|
Включить ведение журнала Ansible Core в |
boolean |
|
|
|
|
|
Указать, что шаблонизация должна возвращать значение |
raw |
|
|
|
|
|
Задать интервал проверки статуса для асинхронных задач в Ansible Core, когда явный интервал опроса не указан. По умолчанию 15 секунд |
integer |
|
|
|
|
|
Обозначить соединения с использованием сертификата или ключа для аутентификации, чтобы избежать повторного указания |
path |
|
|
|
|
|
Избежать публикации переменных, которые импортируются в сценарии playbooks и другие роли по умолчанию |
boolean |
|
|
|
|
|
Задать порт для использования в удаленных соединениях. При пустом значении будет использоваться порт плагина соединения по умолчанию |
integer |
|
|
|
|
|
Установить пользователя для входа на целевые машины. При пустом значении используется пользователь плагина соединения по умолчанию |
string |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать роли |
pathspec |
|
|
|
|
|
Игнорировать ситуации, когда некоторые файловые системы не поддерживают безопасные операции и/или возвращают неконсистентные ошибки, и не выводить фатальные ошибки |
list |
|
|
|
|
|
Установить основной обратный вызов, используемый для отображения вывода Ansible Core. Одномоментно может использоваться только один |
string |
|
|
|
|
|
Установить стратегию по умолчанию, используемую для сценариев playbooks |
string |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины стратегии |
pathspec |
|
|
|
|
|
Включить использование |
boolean |
|
|
|
|
|
Указать «facility» (категорию логов) |
string |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины терминала |
pathspec |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины тестов Jinja2 |
pathspec |
|
|
|
|
|
Указать значение по умолчанию для тайм-аута, используемого плагинами соединения |
integer |
|
|
|
|
|
Выбрать плагин соединения, доступный в пользовательской установке Ansible Core |
string |
|
|
|
|
|
Включить выдачу ошибок при сбоях шаблонизации Ansible Core для шагов, которые ссылаются на неопределенные имена переменных, например, с опечатками (если |
boolean |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины переменных |
pathspec |
|
|
|
|
|
Указать |
string |
|
|
|
|
|
Указать (если |
boolean |
|
|
|
|
|
Указать метку идентификатора хранилища по умолчанию, если она не указана |
string |
|
|
|
|
|
Задать список идентификаторов хранилищ, используемых по умолчанию. Эквивалентно нескольким аргументам |
list |
|
|
|
|
|
Обозначить файл пароля хранилища для использования. Эквивалентно |
path |
|
|
|
|
|
Установить уровень детализации по умолчанию, эквивалентный количеству |
integer |
|
|
|
|
|
Задать отображение предупреждений об устаревании |
boolean |
|
|
|
|
|
Задать отображение предупреждений, связанных с запуском в режиме разработки |
boolean |
|
|
|
|
|
Указать модулям показывать различия при статусе «changed», эквивалентно |
bool |
|
|
|
|
|
Задать количество строк контекста, которые следует показывать при отображении различий между файлами |
integer |
|
|
|
|
|
Изменить поведение - обычно |
boolean |
|
|
|
|
|
Задать отображение пропущенных записей задач/хостов в задаче в стандартном обратном вызове |
boolean |
|
|
|
|
|
Задать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины фрагментов документации |
pathspec |
|
|
|
|
|
Указать корневой URL документации, используемый для генерации URL документации в текстах предупреждений/ошибок; должен быть абсолютным URL с действующей схемой и завершающим слешем |
string |
Соответствующий URL |
|
|
|
|
Изменить поведение - по умолчанию Ansible Core выдает предупреждение при обнаружении дублирующего ключа словаря в YAML. Вывод данных предупреждений можно отменить, установив значение параметра |
string |
|
|
|
|
|
Выбрать используемое приложение в случаях, когда Ansible Core необходимо открыть файл в редакторе |
string |
|
|
|
|
|
Включить/отключить отладчик задач, который ранее выполнялся как плагин стратегии. По умолчанию отладчик активируется при сбое задачи из-за недоступности |
boolean |
|
|
|
|
|
Определить поведение при уведомлении об обработчиках, которые не были определены (предупреждение вместо ошибки) |
boolean |
|
|
|
|
|
Указать, какие модули запускать во время этапа сбора фактов (информации о целевых хостах перед выполнением задач, которая может включать данные о системе - операционная система, версия, доступная память, процессоры, сетевые интерфейсы и др.) playbook |
list |
|
|
|
|
|
Указать каталог, в котором хранятся кешированные ответы от сервера Galaxy (репозитория, предоставляющего коллекции и роли для использования в автоматизации). Используется только командами |
path |
|
|
|
|
|
Увеличить |
float |
|
|
|
|
|
Задать начальный интервал в секундах для опроса статуса импорта коллекции. Этот интервал увеличивается экспоненциально на основе |
float |
|
|
|
|
|
Указать каталог скелета коллекции, используемый в качестве шаблона для действия |
path |
|
|
|
|
|
Задать шаблоны файлов, которые следует игнорировать внутри каталога скелета коллекции Galaxy |
list |
|
|
|
|
|
Указать, должна ли |
bool |
|
|
|
|
|
Отключить проверку подписи GPG во время установки коллекции |
bool |
|
|
|
|
|
Задать отображение индикатора: некоторые шаги в |
bool |
|
|
|
|
|
Настроить keyring, используемый для проверки подписи GPG во время установки и проверки коллекции |
path |
|
|
|
|
|
Изменить поведение - если установлено в |
boolean |
|
|
|
|
|
Задать список кодов состояния GPG, которые следует игнорировать во время проверки подписи GPG |
list |
|
|
|
|
|
Указать количество подписей, которые должны быть успешными во время проверки подписи GPG при установке или проверке коллекций |
str |
|
|
|
|
|
Задать каталог скелета роли, используемый в качестве шаблона для действия |
path |
|
|
|
|
|
Обозначить шаблоны файлов, которые следует игнорировать внутри каталога скелета роли или коллекции Galaxy |
list |
|
|
|
|
|
Задать URL, который будет добавлен, когда роли не указывают полный URI, предполагая, что они ссылаются на этот сервер как источник |
string |
Соответствующий URL |
|
|
|
|
Задать список серверов Galaxy, которые будут использоваться при установке коллекции. Порядок серверов в этом списке используется для определения порядка разрешения коллекции |
list |
|
|
|
|
|
Задать значение по умолчанию для тайм-аута при вызовах API Galaxy. Серверы Galaxy, которые не настраивают конкретный тайм-аут, будут использовать это значение |
int |
|
|
|
|
|
Задать локальный путь к файлу токена доступа Galaxy |
path |
|
|
|
|
|
Избежать проверки ключа хоста при установке значения в |
boolean |
|
|
|
|
|
Изменить поведение при несовпадении шаблонов хостов, позволяя вызвать фатальную ошибку, предупреждение или просто игнорировать это |
string |
|
|
|
|
|
Изменить поведение - факты (информация о целевых хостах перед выполнением задач, которая может включать данные о системе - операционная система, версия, доступная память, процессоры, сетевые интерфейсы и др.) доступны внутри переменной |
boolean |
|
|
|
|
|
Задать путь к интерпретатору Python, который будет использоваться для выполнения модулей на удаленных целевых хостах |
string |
|
|
|
|
|
Задать список интерпретаторов Python, которые будут использоваться в качестве резервных |
list |
|
|
|
|
|
Изменить поведение - если |
boolean |
|
|
|
|
|
Изменить поведение - если |
boolean |
|
|
|
|
|
Задать список включенных плагинов inventory, а также определить порядок их использования |
list |
|
|
|
|
|
Указать, будет ли |
bool |
|
|
|
|
|
Задать список расширений, которые следует игнорировать при использовании каталога в качестве источника inventory |
list |
|
|
|
|
|
Задать список шаблонов, которые следует игнорировать при использовании каталога в качестве источника inventory |
list |
|
|
|
|
|
Изменить поведение - если |
bool |
|
|
|
|
|
Изменить поведение - по умолчанию Ansible Core выдает предупреждение, когда inventory не был загружен. Вывод данных предупреждений можно отменить, установив значение параметра |
boolean |
|
|
|
|
|
Изменить поведение - по умолчанию Ansible Core выдает предупреждение, когда в inventory нет хостов. Вывод данных предупреждений можно отменить, установив значение параметра |
boolean |
|
|
|
|
|
Установить уровень детализации логирования, если он выше обычного уровня отображения, в противном случае он будет соответствовать ему |
int |
|
|
|
|
|
Задать максимальный размер файлов, которые будут рассматриваться для отображения diffs |
int |
|
|
|
|
|
Задать список расширений, которые следует игнорировать при поиске загружаемых модулей |
list |
|
|
|
|
|
Включить проверку, содержат ли ответы модулей не-UTF-8 данные. Отключение этого может привести к неожиданному поведению |
bool |
|
|
|
|
|
Включить bastion/jump хоста с подключением |
string |
|
|
|
|
|
Задать список модулей для управления и настройки сетевых устройств |
list |
|
|
|
|
|
Изменить поведение - ранее Ansible Core очищал только некоторые кеши загрузки плагинов при загрузке новых ролей, что приводило к неожиданному поведению. Эта настройка позволяет пользователю вернуться к этому поведению |
boolean |
|
|
|
|
|
Выбрать используемое приложение для случаев, когда Ansible Core должен возвращать вывод в постраничном формате |
string |
|
|
|
|
|
Указать, следует ли автоматически добавлять ключи хоста при использовании Paramiko |
boolean |
|
|
|
|
|
Указать, следует ли искать ключи при использовании Paramiko |
boolean |
|
|
|
|
|
Указать время ожидания ответа от удаленного устройства перед истечением времени для постоянного соединения |
int |
|
|
|
|
|
Указать время повторной попытки для постоянного соединения с локальным доменным сокетом |
integer |
|
|
|
|
|
Указать, как долго постоянное соединение будет оставаться неактивным перед его уничтожением |
integer |
|
|
|
|
|
Задать путь к сокету, который будет использоваться системой сохранения соединений |
path |
|
|
|
|
|
Установить значение по умолчанию для аргумента |
path |
|
|
|
|
|
Установить, какие каталоги playbooks будут использоваться в качестве корневых для обработки плагинов переменных, включая поиск |
string |
|
|
|
|
|
Задать путь к файлу конфигурации для фильтрации установленных плагинов |
path |
|
|
|
|
|
Попытаться установить «мягкий» лимит |
int |
|
|
|
|
|
Указать, должен ли неудавшийся playbook Ansible Core создавать файл |
bool |
|
|
|
|
|
Установить путь, в котором Ansible Core будет сохранять файлы |
path |
|
|
|
|
|
Оптимизировать использование плагинов переменных в зависимости от размера inventory и выбора сценария playbook |
string |
|
|
|
|
|
Добавить пользовательские статистики (результаты сбора данных о выполнении задач, настраиваемые пользователем), установленные через плагин |
bool |
|
|
|
|
|
Задать список фильтров для избежания «преобразования типов» при шаблонизировании переменных |
list |
|
|
|
|
|
Отключить предупреждения, связанные с потенциальными проблемами на системе, на которой работает Ansible Core |
boolean |
|
|
|
|
|
Задать список тегов по умолчанию для выполнения в playbooks; теги для пропуска |
list |
|
|
|
|
|
Задать список тегов по умолчанию для пропуска в playbooks, имеет приоритет над тегами для выполнения |
list |
|
|
|
|
|
Указать строку для вставки в целевой журнал для отслеживания |
string |
|
|
|
|
|
Определить, будет ли вызван отладчик задач при неудаче задачи, если указано |
boolean |
|
|
|
|
|
Установить максимальное время (в секундах) для выполнения действия задачи |
integer |
|
|
|
|
|
Позволить Ansible Core преобразовывать недопустимые символы в именах групп, предоставленных источниками inventory |
string |
|
|
|
|
|
Переключить использование постоянных соединений |
boolean |
|
|
|
|
|
Отключить проверку записи |
bool |
|
|
|
|
|
Определить список разрешенных плагинов переменных - для тех плагинов, которые требуют явного разрешения в конфигурации |
list |
|
|
|
|
|
Изменить порядок слияния приоритета переменных группы |
list |
|
|
|
|
|
Задать соль, используемую для шифрования хранилища. Если не указан, будет использована случайная соль |
string |
|
|
|
|
|
Определить принудительное использование опции |
bool |
|
|
|
|
|
Задать для асинхронных задач в Ansible Core время ожидания (в секундах) для подключения задачи к именованному каналу на Windows |
integer |
|
|
|
|
|
Определить максимальное количество проверок процессов рабочих групп Task Queue Manager для подтверждения их корректного завершения |
integer |
|
|
|
|
|
Указать количество секунд ожидания между циклами опроса при проверке процессов рабочих групп Task Queue Manager |
float |
|
|
|
|
|
Проверить все расширения при поиске файлов переменных, которые должны быть в формате YAML или JSON |
list |
|
|
|
|
Переменные среды#
Переменная |
Описание |
|---|---|
|
Переопределить файл конфигурации Ansible Core по умолчанию |
|
Указать путь по умолчанию для файлов конфигурации Ansible Core на контроллере |
|
Указать, где будет искать скрипт |
|
Выбрать конкретный шаблон cowsay-сообщений для баннеров или использовать |
|
Принять список шаблонов cowsay-сообщений, «безопасных» для использования; установить пустой список, если необходимо разрешить все установленные шаблоны |
|
Включить принудительно «цветной» вывод (подсветку сообщений разными цветами), даже если выполняется без TTY или установлено значение |
|
Выводить текст без цветового оформления - для улучшения читаемости при отображении ошибок и информации о статусе |
|
См. |
|
Отключить cowsay-сообщения, даже если установлен |
|
Указать пользовательский путь к cowsay-сообщениям или заменить его на пользовательскую реализацию по выбору |
|
Установить глобальную опцию, которую может переопределить каждый плагин подключения; pipelining, если поддерживается плагином подключения, уменьшает количество сетевых операций, необходимых для выполнения модуля на удаленном сервере, что может значительно улучшить производительность, однако это конфликтует с повышением привилегий ( |
|
Установить значение по умолчанию для ключевого слова |
|
Пропустить использование |
|
Указать файл пароля для использования с плагином |
|
Отобразить нейтральный запрос |
|
Выбрать, какой плагин кеша использовать |
|
Определить информацию о подключении или пути для плагина кеша |
|
Установить префикс для использования в файлах/таблицах плагина кеша |
|
Указать время истечения для данных плагина кеша |
|
Включить/отключить сканирование |
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать содержимое коллекций; коллекции должны находиться во вложенных подкаталогах, а не непосредственно в этих каталогах |
|
Установить поведение, когда загружается коллекция, которая не поддерживает текущую версию Ansible Core (с ключом метаданных коллекции |
|
Определить цвет для статуса задачи |
|
Указать цвет по умолчанию для |
|
Определить цвет для вывода отладочных сообщений |
|
Указать цвет для вывода предупреждений об использовании устаревших функций или методов |
|
Определить цвет, используемый при отображении добавленных строк в diffs |
|
Определить цвет, используемый при отображении diffs |
|
Указать цвет, используемый при отображении удаленных строк в diffs |
|
Определить цвет, используемый при выводе сообщений об ошибках |
|
Указать цвет, используемый для выделения |
|
Определить цвет, используемый при отображении статуса задачи |
|
Указать цвет, используемый при отображении статуса задачи |
|
Определить цвет, используемый при отображении статуса задачи |
|
Указать цвет, используемый для статуса |
|
Определить цвет, используемый при выводе подробных сообщений, то есть тех, что отображаются с |
|
Указать цвет, используемый при выводе предупреждающих сообщений |
|
Определить цвет, используемый при выводе имени модуля в выводе |
|
Указать цвет, используемый при выводе перекрестной ссылки в выводе |
|
Определить цвет, используемый при выводе ссылки в выводе |
|
Указать цвет, используемый при выводе устаревшего значения в выводе |
|
Определить цвет, используемый для отображения констант в выводе |
|
Указать цвет, используемый при выводе имени плагина в выводе |
|
Указать файл пароля для использования с плагином подключения |
|
Установить путь к каталогу на удаленном хосте для генерации отчетов о покрытии (показывают, какая часть кода была протестирована с помощью автоматизированных тестов); используется только для удаленного покрытия на модулях PowerShell и предназначено только для внутреннего использования |
|
Указать список путей для файлов на контроллере Ansible Core, для которых будет выполняться покрытие при выполнении на удаленном хосте; покрытие будет собираться только для файлов, соответствующих шаблону пути; несколько шаблонов пути могут быть указаны и разделены двоеточием; используется только для удаленного покрытия на модулях PowerShell и предназначено только для внутреннего использования |
|
Установить, что по умолчанию Ansible Core будет выдавать предупреждение, когда оно получено от действия задачи (модуля или плагина действия); эти предупреждения можно отключить, установив это значение в |
|
Установить, что по умолчанию Ansible Core будет выдавать предупреждение, когда в inventory нет хостов; эти предупреждения можно отключить, установив это значение в |
|
Установить уровень ведения журнала, если он выше обычного уровня отображения, в противном случае он будет соответствовать ему |
|
Указать, что по умолчанию Ansible Core будет выдавать предупреждение, когда inventory не был загружен, и будет использовать неявный inventory для |
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины фрагментов документации |
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины действия |
|
Указать, должен ли playbook Ansible Core запрашивать пароль для входа; если используются SSH-ключи для аутентификации, не нужно изменять эту настройку |
|
Указать, должен ли playbook Ansible Core запрашивать пароль для хранилища |
|
Переключить использование повышения привилегий, позволяя «стать» другим пользователем после входа |
|
Установить переключатель для запроса пароля повышения привилегий |
|
Указать метод повышения привилегий, который будет использоваться, когда включено повышение привилегий |
|
Указать исполняемый файл для использования для повышения привилегий; в противном случае Ansible Core будет зависеть от |
|
Указать флаги, которые будут переданы исполняемому файлу повышения привилегий |
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины повышения привилегий |
|
Указать пользователя, которым «становится» входящий/удаленный пользователь при использовании повышения привилегий; большинство систем будет использовать |
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины кеша |
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины обратного вызова |
|
Указать список включенных обратных вызовов; не все обратные вызовы требуют включения, но многие из тех, что поставляются с Ansible Core, требуют этого, так как нет необходимости в том, чтобы они были активированы по умолчанию |
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины cliconf (плагины, которые позволяют управлять сетевыми устройствами через командную строку) |
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины подключения |
|
Переключить вывод отладки в Ansible Core; может привести к очень многословному и объемному выводу и может затруднить многопоточность; вывод отладочных сообщений также может включать секретную информацию, несмотря на то, что настройки |
|
Указать команду, используемую для запуска оболочки для выполнения Ansible Core на целевом хосте. Может понадобиться в редких случаях, когда использование оболочки ограничено |
|
Указать пути, разделенные двоеточием, в которых Ansible Core будет искать плагины фильтров Jinja2 |
|
Указать, выполняются ли уведомленные обработчики на хосте, даже если на этом хосте произошла ошибка; когда значение |
|
Указать максимальное количество процессов, которые Ansible Core будет использовать для выполнения задач на целевых хостах |
|
Указать политику по умолчанию для сбора фактов (информации о целевых хостах перед выполнением задач, которая может включать данные о системе - операционная система, версия, доступная память, процессоры, сетевые интерфейсы и др.), обнаруженных на удаленных хостах; эта опция может быть полезна для тех, кто хочет сэкономить время на сборе фактов; оба значения |
|
Указать, как обрабатываются дублирующие определения переменных словаря в Ansible Core; не влияет на переменные, значения которых являются скалярными или массивами; изменение этой настройки не рекомендуется, так как это нестабильно и делает контент непереносимым; рекомендуется избегать повторного использования имен переменных |
|
Указать список источников inventory Ansible Core, разделенный запятыми |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать плагины HttpApi |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать плагины inventory |
|
Включить дополнительные расширения Jinja2 |
|
Сохранить типы переменных во время операций с шаблонами |
|
Включить/отключить очистку временных файлов, которые Ansible Core использовал для выполнения задач на удаленном хосте; если эта опция включена, она отключит |
|
Заставить |
|
Указать, загружаются ли плагины обратного вызова при запуске |
|
Указать временный каталог для использования Ansible Core на контроллере |
|
Указать файл, в который Ansible Core будет записывать логи на контроллере; при отсутствии настройки ведение журнала отключено |
|
Указать список имен регистраторов, которые следует исключить из файла журнала |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать плагины поиска |
|
Установить аргументы по умолчанию, которые передаются в бинарный файл |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать модули |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать файлы утилит модулей, которые используются модулями |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать плагины Netconf |
|
Переключить отображение и ведение журнала деталей задач Ansible Core, в основном используется для избежания раскрытия информации о безопасности |
|
Переключить ведение журнала Ansible Core в |
|
Указать, что должно возвращаться в шаблонах как значение |
|
Указать интервал, с которым следует проверять статус асинхронных задач в Ansible Core, когда явный интервал опроса не указан; по умолчанию это 15 секунд |
|
Выполнить соединение с использованием сертификата или ключа для аутентификации, а не агента или паролей; можно установить значение по умолчанию здесь, чтобы избежать повторного указания |
|
Указать, что по умолчанию импортированные роли публикуют свои переменные в сценарии playbooks и другие роли; эта настройка может этого избежать, сбрасывая переменные роли к значениям по умолчанию |
|
Указать порт для использования в удаленных соединениях; если пусто, будет использоваться значение плагина соединения по умолчанию |
|
Установить пользователя для входа на целевые машины; если пусто, используется значение плагина соединения по умолчанию |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать роли |
|
Позволить Ansible Core продолжить выполнение задач при обнаружении файловых систем, не поддерживающих безопасные операции и/или возвращающих непоследовательные ошибки, не вызывая фатальных ошибок. Может произойти повреждение данных |
|
Установить основной обратный вызов, используемый для отображения вывода Ansible Core. Одномоментно может использоваться только один |
|
Указать приложение, используемое для редактирования файлов, когда Ansible Core должен вернуть файл в редакторе |
|
Включить/отключить отладчик задач; отладчик по умолчанию активируется, когда задача завершилась с ошибкой из-за недоступности |
|
Определить, будет ли отладчик задач вызываться при неудаче задачи, когда указано |
|
Установить стратегию по умолчанию, используемую для сценариев playbooks |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать плагины стратегии |
|
Включить использование |
|
Указать системный журнал, который будет использоваться, когда Ansible Core ведет журнал на удаленном хосте |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать плагины терминала |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать плагины тестов Jinja2 |
|
Указать значение по умолчанию для тайм-аута, используемого плагинами соединения |
|
Указать любой плагин соединения, доступный для пользовательской установки Ansible Core; также есть устаревший специальный вариант |
|
Изменить поведение - когда |
|
Указать путь, разделенный двоеточиями, в котором Ansible Core будет искать плагины переменных |
|
Указать, что если |
|
Указать метку, используемую для метки идентификатора хранилища по умолчанию, когда метка идентификатора хранилища не предоставлена |
|
Указать соль, используемую для шифрования хранилища; если не предоставлена, будет использована случайная соль |
|
Указать идентификатор хранилища, используемый для шифрования по умолчанию; если предоставлено несколько идентификаторов хранилища, это указывает, какой использовать для шифрования |
|
Указать список идентификаторов хранилищ, используемых по умолчанию; эквивалентно нескольким аргументам |
|
Указать файл пароля хранилища для использования; эквивалентно |
|
Установить уровень детализации по умолчанию, эквивалентный количеству |
|
Задать режим отображения предупреждений об устаревании |
|
Задать режим отображения предупреждений, связанных с запуском разработки |
|
Указать модулям показывать различия, когда они находятся в состоянии |
|
Указать количество строк контекста, которые следует показывать при отображении различий между файлами |
|
Указать, что задачам, содержащим конфиденциальные значения, следует отображать аргументы в стандартном выводе |
|
Управлять отображением пропущенных записей задач/хостов в задаче в стандартном обратном вызове |
|
Указать, что по умолчанию Ansible Core выдает предупреждение, когда в YAML встречается дублирующийся ключ словаря; вывод данных предупреждений можно отменить, установив значение параметра |
|
Задать тип уведомления в случае отсутствующих обработчиков - предупреждение вместо ошибки |
|
Определить, какие модули запускать на этапе сбора фактов (информации о целевых хостах перед выполнением задач, которая может включать данные о системе - операционная система, версия, доступная память, процессоры, сетевые интерфейсы и др.) сценария playbook, используя значение по умолчанию |
|
Позволить |
|
Установить значение по умолчанию для тайм-аута API вызовов Galaxy |
|
Использовать каталог скелета роли в качестве шаблона для действия |
|
Определить шаблоны файлов для игнорирования внутри каталога скелета роли или коллекции Galaxy |
|
Использовать каталог скелета коллекции в качестве шаблона для действия |
|
Определить шаблоны файлов для игнорирования внутри каталога скелета коллекции Galaxy |
|
Указать, следует ли |
|
Добавить URL, когда роли не указывают полный URI, предполагая, что они ссылаются на этот сервер как источник |
|
Задать список серверов Galaxy, которые будут использоваться при установке коллекции |
|
Указать локальный путь к файлу токена доступа Galaxy |
|
Указать, отображается ли индикатор прогресса при выполнении некоторых шагов в |
|
Определить каталог, в котором хранятся кешированные ответы от сервера Galaxy |
|
Отключить проверку подписи GPG во время установки коллекции |
|
Настроить ключевую цепочку для проверки подписи GPG во время установки и проверки коллекции |
|
Указать список кодов состояния GPG, которые следует игнорировать во время проверки подписи GPG |
|
Определить количество подписей, которые должны быть успешными во время проверки подписи GPG |
|
Установить начальный интервал в секундах для опроса статуса импорта коллекции |
|
Указать множитель, используемый для увеличения |
|
Установить значение в |
|
Изменить поведение при несовпадении шаблонов хостов, позволяя вызвать принудительно фатальную ошибку или предупреждение, либо игнорировать данное несовпадение |
|
Указать путь к интерпретатору Python, который будет использоваться для выполнения модулей на удаленных системах |
|
Заставить Ansible Core преобразовывать недопустимые символы в именах групп, предоставленных источниками inventory |
|
Установить |
|
Задать сценарий обработки ошибок разбора inventory. |
|
Определить список включенных плагинов inventory и порядок их использования |
|
Указать, будет ли |
|
Указать список расширений, которые следует игнорировать при использовании каталога в качестве источника inventory |
|
Определить список шаблонов для игнорирования при использовании каталога в качестве источника inventory |
|
Задать поведение при обработке inventory. |
|
Определить максимальный размер файлов, которые будут рассматриваться для отображения различий |
|
См. |
|
Добавить факты (информацию о целевых хостах перед выполнением задач, которая может включать данные о системе - операционная система, версия, доступная память, процессоры, сетевые интерфейсы и др.) как свои собственные переменные в основное namespace, помимо доступности внутри переменной |
|
Указать список расширений, которые следует игнорировать при поиске загружаемых модулей |
|
Включить проверку на наличие в ответах модулей данных, закодированных не в формате UTF-8 |
|
Позволить пользователю вернуться к поведению, при котором очищались только некоторые кеши загрузки плагинов |
|
Выбрать приложение, используемое для постраничного вывода в Ansible Core |
|
См. |
|
См. |
|
Указать путь к сокету, который будет использоваться системой постоянного соединения |
|
Указать, как долго постоянное соединение будет оставаться неактивным, прежде чем оно будет уничтожено |
|
Указать тайм-аут повторной попытки для постоянного соединения с локальным доменным сокетом |
|
Указать время ожидания ответа от удаленного устройства, прежде чем произойдет тайм-аут постоянного соединения |
|
Установить значение по умолчанию для аргумента |
|
Определить, какие каталоги playbooks будут использоваться в качестве корня для обработки плагинов переменных |
|
Установить «мягкий» лимит |
|
Указать, должен ли неудавшийся playbook создавать файл |
|
Определить путь, в котором будут сохраняться файлы |
|
Оптимизировать использование плагинов переменных в зависимости от размера inventory и выбора сценария playbook |
|
Добавить пользовательские статистические данные, установленные через плагин |
|
Предотвратить «преобразование типов» при шаблонировании переменных, полезно для строк JSON |
|
Отключить предупреждения о потенциальных проблемах в системе, где выполняется Ansible Core |
|
Установить список тегов по умолчанию, которые будут выполняться в пользовательских playbooks |
|
Установить список тегов по умолчанию, которые будут пропущены в пользовательских playbooks |
|
Указать строку, которая будет вставлена в целевое логирование для целей отслеживания |
|
Установить максимальное время (в секундах) для выполнения действия задачи |
|
Указать максимальное количество проверок рабочих процессов диспетчера очереди задач для подтверждения их корректного завершения. После достижения этого предела все еще работающие рабочие процессы будут завершены. Это значение предназначено только для внутреннего использования |
|
Указать количество секунд, которые нужно подождать между циклами опроса при проверке завершения работы рабочих процессов |
|
Включить использование постоянных соединений |
|
Указать список плагинов переменных, которые должны быть активированы - для тех плагинов, которые требуют явного указания в конфигурации |
|
Изменить порядок слияния приоритетов переменных группы |
|
Установить время в секундах, которое нужно подождать для подключения асинхронной задачи к именованному каналу в системах Windows |
|
Проверить указанные расширения при поиске файлов переменных в формате YAML или JSON |
|
Включить bastion/jump хоста с соединением netconf |
|
Отключить проверку записи |
|
Использовать опцию |
Содержимое конфигурационного файла по умолчанию#
По умолчанию /etc/ansible/ansible.cfg содержит инструкцию по созданию примера конфигурационного файла и включению в него существующих плагинов:
# Since Ansible 2.12 (core):
# To generate an example config file (a "disabled" one with all default settings, commented out):
# $ ansible-config init --disabled > ansible.cfg
#
# Also you can now have a more complete file by including existing plugins:
# ansible-config init --disabled -t all > ansible.cfg
# For previous versions of Ansible you can check for examples in the 'stable' branches of each version
# Note that this file was always incomplete and lagging changes to configuration settings
# for example, for 2.9: https://github.com/ansible/ansible/blob/stable-2.9/examples/ansible.cfg
После выполнения ansible-config init --disabled > ansible.cfg будет сгенерирован пример конфигурационного файла ansible.cfg, в котором все настройки по умолчанию закомментированы (отключены). В нем можно увидеть все доступные параметры конфигурации и их значения по умолчанию, не изменяя текущую конфигурацию. Пример начальных строк такого файла:
# (boolean) By default Ansible will issue a warning when received from a task action (module or action plugin)
# These warnings can be silenced by adjusting this setting to False.
;action_warnings=True
# (list) Accept list of cowsay templates that are 'safe' to use, set to empty list if you want to enable all installed templates.
;cowsay_enabled_stencils=bud-frogs, bunny, cheese, daemon, default, dragon, elephant-in-snake, elephant, eyes, hellokitty, kitty, luke-koala, meo
w, milk, moofasa, moose, ren, sheep, small, stegosaurus, stimpy, supermilker, three-eyes, turkey, turtle, tux, udder, vader-koala, vader, www
# (string) Specify a custom cowsay path or swap in your cowsay implementation of choice
;cowpath=
# (string) This allows you to chose a specific cowsay stencil for the banners or use 'random' to cycle through them.
;cow_selection=default
# (boolean) This option forces color mode even when running without a TTY or the "nocolor" setting is True.
;force_color=False
# (path) The default root path for Ansible config files on the controller.
;home=~/.ansible
# (boolean) This setting allows suppressing colorizing output, which is used to give a better indication of failure and status information.
;nocolor=False
# (boolean) If you have cowsay installed but want to avoid the 'cows' (why????), use this.
;nocows=False
# (boolean) Sets the default value for the any_errors_fatal keyword, if True, Task failures will be considered fatal errors.
;any_errors_fatal=False
...