Плагины подключения

• ssh плагины
• Добавление плагинов подключения
• Использование плагинов подключения
• Список плагинов

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

По умолчанию Ansible поставляется с несколькими плагинами. Наиболее часто используемые — SSH с paramiko, собственный ssh (называемый просто ssh), и локальное подключение. Все они могут быть использованы в playbook-файлах и с командой /usr/bin/ansible для определения способа взаимодействия с удалёнными машинами.

Основы этих типов подключения освещаются в разделе начального руководства.

ssh плагины

Поскольку ssh является стандартным протоколом, используемым в системной администрировании, и наиболее используемым протоколом в Ansible, опции ssh включены в инструменты командной строки. Для получения более подробной информации см. ansible-playbook.

Добавление плагинов подключения

Вы можете расширить функциональность Ansible для поддержки других транспортов (таких как SNMP или транспортные шины сообщений), поместив пользовательский плагин в директорию connection_plugins.

Использование плагинов подключения

Вы можете установить плагин подключения глобально через настройки конфигурации, в командной строке (-c, --connection), в качестве ключа в вашем playbook-файле или установив переменную, чаще всего в вашем инвентаре. Например, для машин 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> для просмотра подробной документации и примеров.