连接插件
连接插件允许 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>
查看特定于插件的文档和示例。