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)

提示

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