ansible-playbook

Запускает Ansible playbook, выполняя определённые задачи на целевых хостах.

• Сводка
• Описание
• Общие параметры
• Окружение
• Файлы
• Автор
• Лицензия
• См. также

Сводка

ansible-playbook [options] playbook.yml [playbook2 ...]

Описание

Инструмент для запуска Ansible playbooks, системы конфигурации и многоузлового развертывания. Для получения дополнительной информации посетите домашнюю страницу проекта (https://docs.ansible.com).

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

--ask-vault-pass

Запрос пароля vault

--become-method <BECOME_METHOD>

Метод повышения привилегий (по умолчанию=%default), используйте ansible-doc -t become -l для просмотра допустимых вариантов.

--become-user <BECOME_USER>

Выполнение операций от имени этого пользователя (по умолчанию=root)

--flush-cache

Очистка кэша фактов для каждого хоста в инвентаре

--force-handlers

Выполнение обработчиков, даже если задача завершилась неудачей

--list-hosts

Вывод списка совпадающих хостов; ничего больше не выполняется

--list-tags

Список всех доступных тегов

--list-tasks

Список всех задач, которые будут выполнены

--private-key, --key-file

Использование этого файла для аутентификации подключения

--scp-extra-args <SCP_EXTRA_ARGS>

Укажите дополнительные параметры для передачи только команде scp (например, -l)

--sftp-extra-args <SFTP_EXTRA_ARGS>

Укажите дополнительные параметры для передачи только команде sftp (например, -f, -l)

--skip-tags

Выполнение только тех play и задач, теги которых не соответствуют этим значениям

--ssh-common-args <SSH_COMMON_ARGS>

Укажите общие параметры для передачи командам sftp/scp/ssh (например, ProxyCommand)

--ssh-extra-args <SSH_EXTRA_ARGS>

Укажите дополнительные параметры для передачи только команде ssh (например, -R)

--start-at-task <START_AT_TASK>

Начало playbook с задачей с указанным именем

--step

Пошаговый режим: подтверждение каждой задачи перед выполнением

--syntax-check

Проверка синтаксиса playbook, но не его выполнение

--vault-id

Идентификатор vault для использования

--vault-password-file

Файл пароля vault

--version

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

-C, --check

Не вносить изменений; вместо этого попытаться предсказать возможные изменения.

-D, --diff

При изменении (небольших) файлов и шаблонов отобразить различия в этих файлах; отлично работает с –check.

-K, --ask-become-pass

Запрос пароля для повышения привилегий.

-M, --module-path

Добавить двоеточием разделенные пути в библиотеку модулей (по умолчанию=~/.ansible/plugins/modules:/usr/share/ansible/plugins/modules).

-T <TIMEOUT>, --timeout <TIMEOUT>

Переопределение таймаута подключения в секундах (по умолчанию=10)

-b, --become

Выполнение операций с повышением привилегий (не подразумевает запрос пароля)

-c <CONNECTION>, --connection <CONNECTION>

Тип подключения для использования (по умолчанию=smart)

-e, --extra-vars

Установление дополнительных переменных в виде ключ=значение или YAML/JSON, если имя файла начинается с @

-f <FORKS>, --forks <FORKS>

Укажите количество параллельных процессов для использования (по умолчанию=5)

-h, --help

Вывод этого сообщения справки и завершение работы

-i, --inventory, --inventory-file

Укажите путь к файлу инвентаризации или список хостов через запятую. –inventory-file устарел

-k, --ask-pass

Запрос пароля для подключения

-l <SUBSET>, --limit <SUBSET>

Дополнительное ограничение выбранных хостов по дополнительному шаблону

-t, --tags

Выполнение только тех play и задач, которые помечены этими тегами

-u <REMOTE_USER>, --user <REMOTE_USER>

Подключение как этот пользователь (по умолчанию=None)

-v, --verbose

Режим подробных сообщений (-vvv для большего, -vvvv для включения отладки подключения)

Окружение

Могут быть указаны следующие переменные окружения.

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

Многие другие доступны для большинства параметров в ansible.cfg

Файлы

/etc/ansible/ansible.cfg – Файл конфигурации, используется при наличии

~/.ansible.cfg – Файл конфигурации пользователя, переопределяет файл конфигурации по умолчанию, если присутствует

Автор

Ansible первоначально был написан Майклом ДеХаном.

Полный список авторов см. в файле AUTHORS.

Лицензия

Ansible распространяется на условиях лицензии GPLv3+.

См. также

ansible(1), ansible-config(1), ansible-console(1), ansible-doc(1), ansible-galaxy(1), ansible-inventory(1), ansible-playbook(1), ansible-pull(1), ansible-vault(1),