ansible

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

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

Синопсис

usage: ansible [-h] [--version] [-v] [-b] [--become-method BECOME_METHOD]
            [--become-user BECOME_USER] [-K] [-i INVENTORY] [--list-hosts]
            [-l SUBSET] [-P POLL_INTERVAL] [-B SECONDS] [-o] [-t TREE] [-k]
            [--private-key PRIVATE_KEY_FILE] [-u REMOTE_USER]
            [-c CONNECTION] [-T TIMEOUT]
            [--ssh-common-args SSH_COMMON_ARGS]
            [--sftp-extra-args SFTP_EXTRA_ARGS]
            [--scp-extra-args SCP_EXTRA_ARGS]
            [--ssh-extra-args SSH_EXTRA_ARGS] [-C] [--syntax-check] [-D]
            [-e EXTRA_VARS] [--vault-id VAULT_IDS]
            [--ask-vault-password | --vault-password-file VAULT_PASSWORD_FILES]
            [-f FORKS] [-M MODULE_PATH] [--playbook-dir BASEDIR]
            [-a MODULE_ARGS] [-m MODULE_NAME]
            pattern

Описание

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

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

--ask-vault-password, --ask-vault-pass

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

--become-method <BECOME_METHOD>

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

--become-user <BECOME_USER>

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

--list-hosts

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

--playbook-dir <BASEDIR>

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

--private-key <PRIVATE_KEY_FILE>, --key-file <PRIVATE_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-pass-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

выполнять операции с 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),