Плагины подключения
Плагины подключения позволяют Ansible подключаться к целевым хостам, чтобы выполнять на них задачи. Ansible поставляется со многими плагинами подключения, но только один может использоваться на один хост за раз.
По умолчанию, Ansible поставляется с несколькими плагинами подключения. Наиболее часто используемые — paramiko SSH, нативный ssh (просто ssh) и local типы подключения. Все они могут использоваться в плейбуках и с /usr/bin/ansible, чтобы определить, как вы хотите взаимодействовать с удалёнными машинами. При необходимости можно создать собственные плагины подключения. Чтобы изменить плагин подключения для ваших задач, можно использовать ключевое слово connection.
Основы этих типов подключения описаны в разделе начала работы.
ssh плагины
Поскольку SSH является стандартным протоколом, используемым в администрировании систем, и протоколом, наиболее часто используемым в Ansible, опции SSH включены в инструменты командной строки. Подробнее см. ansible-playbook.
Использование плагинов подключения
Вы можете задать плагин подключения глобально с помощью настройки, в командной строке (-c, --connection), в качестве ключевого слова в вашем плейбуке или задав переменную, чаще всего в вашем инвентаре. Например, для машин Windows вы можете задать плагин winrm в качестве переменной инвентаря.
Большинство плагинов подключения могут работать с минимальной настройкой. По умолчанию они используют имя хоста из инвентаря и значения по умолчанию для поиска целевого хоста.
Плагины самодокументированы. Каждый плагин должен документировать свои параметры настройки. Ниже перечислены переменные подключения, общие для большинства плагинов подключения:
- ansible_host
-
Имя хоста для подключения, если оно отличается от имени хоста в инвентаре.
- ansible_port
-
Номер порта ssh, для ssh и paramiko_ssh по умолчанию 22.
- ansible_user
-
Используемое по умолчанию имя пользователя для входа. Большинство плагинов по умолчанию используют пользователя, под которым запущен Ansible.
Каждый плагин также может иметь специфичную версию переменной, которая переопределяет общую версию. Например, ansible_ssh_host для плагина ssh.
Список плагинов
Для просмотра списка доступных плагинов используйте ansible-doc -t connection -l. Используйте ansible-doc -t connection <plugin name> для просмотра документации и примеров, специфичных для плагинов.
См. также
- Работа с плейбуками
-
Введение в плейбуки
- Плагины обратного вызова
-
Плагины обратного вызова
- Плагины фильтров
-
Плагины фильтров
- Плагины тестов
-
Плагины тестов
- Плагины поиска
-
Плагины поиска
- Плагины переменных
-
Плагины переменных
- Связь
-
Есть вопросы? Нужна помощь? Хотите поделиться идеями? Посетите руководство по коммуникации Ansible
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/plugins/connection.html
