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

注意

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

概要

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

别名：redirected_local

参数

参数

注释

pipelining

布尔值

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

启用后，这会导致性能大幅提升。

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

选择

  • false ← (默认)

  • true

配置

  • INI 条目

    [defaults]
pipelining = false

    [connection]
pipelining = false

  • 环境变量：ANSIBLE_PIPELINING

  • 变量：ansible_pipelining

说明

注意

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

作者

  • ansible (@core)

提示

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