Утилита ansible-config
Описание
ansible-config - утилита для просмотра конфигурации Ansible Core.
Синтаксис утилиты:
ansible-config <options> <action>
Где:
<options> - опции;
<action> - действие.
Настройка конфигурации Ansible Core производится с помощью файлов, описанных в разделе «Конфигурационные файлы ansible.cfg».
Опции
Опции утилиты представлены в таблице ниже.
Опции ansible-config
Опция |
Описание |
--version
|
Показать номер версии утилиты, расположение конфигурационного файла, настроенный путь поиска модулей, расположение модулей, расположение исполняемого файла и выходит |
-h, --help
|
Показать справочное сообщение и выйти |
-v, --verbose
|
Заставить Ansible Core выводить больше отладочных сообщений. Добавление нескольких -v увеличивает уровень подробности, встроенные плагины в настоящее время оцениваются до -vvvvvv. Разумный уровень для начала - -vvv, отладка соединения может потребовать -vvvv |
Действия
Действия утилиты представлены в таблице ниже.
Действия ansible-config
Действие |
Опции действия |
list - перечислить и вывести доступные конфигурации
|
--format 'FORMAT', -f 'FORMAT' - задать формат вывода для списка;
-c 'CONFIG_FILE', --config 'CONFIG_FILE' - указать путь к конфигурационному файлу, по умолчанию используется первый файл, найденный в порядке приоритета;
-t 'TYPE', --type 'TYPE' - отфильтровать по конкретному типу плагина
|
dump - показать текущие настройки, объединить ansible.cfg, если указано
|
--format 'FORMAT', -f 'FORMAT' - задать формат вывода для дампа;
--only-changed, --changed-only - показать только конфигурации, которые изменились от значения по умолчанию;
-c 'CONFIG_FILE', --config 'CONFIG_FILE' - указать путь к конфигурационному файлу, по умолчанию используется первый файл, найденный в порядке приоритета;
-t 'TYPE', --type 'TYPE' - отфильтровать по конкретному типу плагина
|
view - отобразить текущий конфигурационный файл
|
-c 'CONFIG_FILE', --config 'CONFIG_FILE' - указать путь к конфигурационному файлу, по умолчанию используется первый файл, найденный в порядке приоритета;
-t 'TYPE', --type 'TYPE' - отфильтровать по конкретному типу плагина
|
init - создать начальную конфигурацию
|
--disabled - добавить к каждому элементу символ комментария, чтобы отключить его;
--format 'FORMAT', -f 'FORMAT' - задать формат вывода для инициализации;
-c 'CONFIG_FILE', --config 'CONFIG_FILE' - указать путь к конфигурационному файлу, по умолчанию используется первый файл, найденный в порядке приоритета;
-t 'TYPE', --type 'TYPE' - отфильтровать по конкретному типу плагина
|
validate - проверить конфигурацию на корректность
|
--format 'FORMAT', -f 'FORMAT' - задать формат вывода для валидации;
-c 'CONFIG_FILE', --config 'CONFIG_FILE' - указать путь к конфигурационному файлу, по умолчанию используется первый файл, найденный в порядке приоритета;
-t 'TYPE', --type 'TYPE' - отфильтровать по конкретному типу плагина
|
Переменные окружения
Переменная окружения, влияющая на работу утилиты - ANSIBLE_CONFIG – переопределить конфигурационный файл по умолчанию.
Другие варианты доступны в качестве параметров ansible.cfg (подробнее - в разделе «Конфигурационные файлы ansible.cfg»).
Примеры использования
Проверьте текущую конфигурацию Ansible Core:
Команда выведет текущий конфигурационный файл, показывая все настройки, которые применяются в данный момент.
Проверьте конфигурацию Ansible Core на наличие ошибок:
Если конфигурационный файл содержит ошибки или некорректные настройки, команда выведет соответствующие сообщения.
Дополнительная информация
Дополнительную информацию можно получить, выполнив команду: