Утилита 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-config view
    

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

  • Проверьте конфигурацию Ansible Core на наличие ошибок:

    ansible-config validate
    

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

Дополнительная информация#

Дополнительную информацию можно получить, выполнив команду:

ansible-config --help