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

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

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

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

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

ssh плагины

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

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

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

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

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