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

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

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

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

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

Плагины ssh

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

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

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

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

Транспорт можно изменить через настройки, в командной строке (-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> для просмотра подробной документации и примеров.

• buildah - Взаимодействие с существующим контейнером buildah
• chroot - Взаимодействие с локальным chroot
• docker - Выполнение задач в контейнерах docker
• funcd - Использование funcd для подключения к целевому объекту
• iocage - Выполнение задач в тюрьмах iocage
• jail - Выполнение задач в тюрьмах
• kubectl - Выполнение задач в под контейнерах, запущенных в Kubernetes.
• libvirt_lxc - Выполнение задач в контейнерах lxc через libvirt
• local - выполнение на контроллере
• lxc - Выполнение задач в контейнерах lxc с использованием lxc python библиотеки
• lxd - Выполнение задач в контейнерах lxc через lxd CLI
• netconf - Предоставляет постоянное подключение с использованием протокола netconf
• network_cli - Использование network_cli для запуска команд на сетевых устройствах
• oc - Выполнение задач в под контейнерах, запущенных в OpenShift.
• paramiko_ssh - Выполнение задач через python ssh (paramiko)
• persistent - Использование постоянного unix сокета для подключения
• saltstack - Разрешить ansible «подсаживаться» на salt minions
• ssh - подключение через ssh клиентскую утилиту
• winrm - Выполнение задач через Microsoft WinRM
• zone - Выполнение задач в экземпляре зоны