连接插件

连接插件允许 Ansible 连接到目标主机,以便在其上执行任务。Ansible 附带许多连接插件,但每个主机一次只能使用一个插件。

默认情况下,Ansible 附带几个连接插件。最常用的是 paramiko SSH、原生 ssh(简称 ssh)和 local 连接类型。所有这些都可以在 Playbook 中以及与 /usr/bin/ansible 一起使用,以决定您希望如何与远程机器通信。如有必要,您可以创建自定义连接插件。要更改任务的连接插件,可以使用 connection 关键字。

这些连接类型的基础知识在 入门 部分中介绍。

ssh 插件

由于 SSH 是系统管理中使用的默认协议,也是 Ansible 中最常用的协议,因此命令行工具中包含了 SSH 选项。有关更多详细信息,请参见 ansible-playbook

使用连接插件

您可以使用 配置全局设置连接插件,也可以在命令行 (-c--connection) 上、作为 Playbook 中的 关键字 或通过设置变量 来设置,最常见的是在您的清单中设置。例如,对于 Windows 机器,您可能希望将 winrm 插件设置为清单变量。

大多数连接插件可以使用最少的配置进行操作。默认情况下,它们使用 清单主机名,并使用默认值来查找目标主机。

插件是自文档化的。每个插件都应记录其配置选项。以下是大多数连接插件通用的连接变量

ansible_host

要连接的主机名,如果与清单主机名不同。

ansible_port

sshparamiko_ssh 的 SSH 端口号,默认为 22。

ansible_user

用于登录的默认用户名。大多数插件默认为“运行 Ansible 的当前用户”。

每个插件还可能具有覆盖常规版本的变量的特定版本。例如,ssh 插件的 ansible_ssh_host

插件列表

您可以使用 ansible-doc -t connection -l 查看可用插件的列表。使用 ansible-doc -t connection <插件名称> 查看特定于插件的文档和示例。

另请参见

使用 Playbook

Playbook 简介

回调插件

回调插件

过滤器插件

过滤器插件

测试插件

测试插件

查找插件

查找插件

变量插件

变量插件

沟通

有疑问?需要帮助?想分享您的想法?请访问 Ansible 沟通指南