ansible.builtin.local 连接 – 在控制器上执行

注意

此连接插件是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，您可以使用简短的插件名称 local。但是，我们建议您使用 完全限定集合名称 (FQCN) ansible.builtin.local，以便轻松链接到插件文档并避免与可能具有相同连接插件名称的其他集合发生冲突。

摘要

  • 此连接插件允许 ansible 在 Ansible “控制器” 上执行任务，而不是在远程主机上执行。

别名：redirected_local

参数

参数

注释

流水线

布尔值

流水线通过在不进行实际文件传输的情况下执行许多 Ansible 模块，减少了在远程服务器上执行模块所需的连接操作次数。

启用此功能可以显著提高性能。

但是，这可能会与权限提升 (become) 冲突。例如，当使用 sudo 操作时，必须首先在目标主机的 sudoers 文件中禁用 requiretty，这就是此功能默认情况下处于禁用状态的原因。

选项

  • false ← (默认)

  • true

配置

  • INI 条目

    [defaults]
pipelining = false

    [connection]
pipelining = false

  • 环境变量：ANSIBLE_PIPELINING

  • 变量：ansible_pipelining

注释

注意

  • 远程用户将被忽略，改为使用执行 ansible CLI 的用户。

作者

  • ansible (@core)

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖较高的变量。