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

ssh плагины

Поскольку SSH — протокол, используемый по умолчанию в системном администрировании и чаще всего применяемый в Ansible, параметры SSH включены в инструменты командной строки. Дополнительные сведения см. в разделе ansible-playbook.

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

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