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

注意

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

概要

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

别名：redirected_local

参数

参数

注释

pipelining

布尔值

管道传输通过执行许多 Ansible 模块而无需实际的文件传输来减少在远程服务器上执行模块所需的连接操作次数。

启用后，这可以带来非常显著的性能提升。

然而，这可能与特权提升 (become) 冲突。例如，当使用 sudo 操作时，您必须首先在目标主机的 sudoers 文件中禁用 requiretty，这就是为什么此功能默认禁用的原因。

选项

  • false ← (默认)

  • true

配置

  • INI 条目

    [defaults]
pipelining = false

    [connection]
pipelining = false

  • 环境变量：ANSIBLE_PIPELINING

  • 变量：ansible_pipelining

备注

注意

  • 远程用户将被忽略，而是使用执行 Ansible CLI 的用户。

作者

  • ansible (@core)

提示

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