ansible

Определите и запустите одну задачу «playbook» на наборе хостов

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

Синопсис

ansible <host-pattern> [options]

Описание

является очень простым инструментом/фреймворком/API для выполнения «удаленных действий». Эта команда позволяет определить и запустить одну задачу «playbook» на наборе хостов

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

--ask-vault-pass

Запросить пароль vault

--become-method <BECOME_METHOD>

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

--become-user <BECOME_USER>

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

--list-hosts

Выводит список совпадающих хостов; не выполняет никаких других действий

--playbook-dir <BASEDIR>

Поскольку этот инструмент не использует playbooks, используйте его как заменяющую директорию playbooks. Это задаёт относительный путь для многих функций, включая roles/ group_vars/ и т. д.

--private-key, --key-file

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

--scp-extra-args <SCP_EXTRA_ARGS>

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

--sftp-extra-args <SFTP_EXTRA_ARGS>

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

--ssh-common-args <SSH_COMMON_ARGS>

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

--ssh-extra-args <SSH_EXTRA_ARGS>

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

--syntax-check

Выполнить синтаксическую проверку playbook, но не выполнять его

--vault-id

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

--vault-password-file

Файл пароля vault

--version

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

-B <SECONDS>, --background <SECONDS>

Выполнять асинхронно, завершаясь с ошибкой через X секунд (по умолчанию=N/A)

-C, --check

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

-D, --diff

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

-K, --ask-become-pass

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

-M, --module-path

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

-P <POLL_INTERVAL>, --poll <POLL_INTERVAL>

Установить интервал опроса при использовании -B (по умолчанию=15)

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

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

-a <MODULE_ARGS>, --args <MODULE_ARGS>

Аргументы модуля

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

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

-m <MODULE_NAME>, --module-name <MODULE_NAME>

Имя модуля для выполнения (по умолчанию=command)

-o, --one-line

Сжать вывод

-t <TREE>, --tree <TREE>

Записать выходные данные в эту директорию

-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),