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]
            [--task-timeout TASK_TIMEOUT] [-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>

Поскольку этот инструмент не использует playbooks, используйте его в качестве альтернативного каталога playbooks. Это устанавливает относительный путь для многих функций, включая роли/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, но не запускать его

--task-timeout <TASK_TIMEOUT>

Установить лимит времени выполнения задачи в секундах, должно быть положительным целым числом.

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

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

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