ansible.builtin.sh shell – POSIX shell (/bin/sh)

注意

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

概要

  • 此 shell 插件是您在大多数 Unix 系统上要使用的插件，它是兼容性最高且安装最广泛的 shell。

参数

参数

注释

admin_users

list / elements=string

预期具有管理员权限的用户列表。控制器使用它来确定如何与远程用户和 become 用户之间共享临时文件。

默认值： ["root", "toor"]

配置

  • INI 条目

    [defaults]
admin_users = root, toor

  • 环境变量：ANSIBLE_ADMIN_USERS

  • 变量：ansible_admin_users

async_dir

string

Ansible 用于保存异步作业信息的目录。

默认值： "~/.ansible_async"

配置

  • INI 条目

    [defaults]
async_dir = ~/.ansible_async

  • 环境变量：ANSIBLE_ASYNC_DIR

  • 变量：ansible_async_dir

common_remote_group

string

在 ansible-base 2.10 中添加

当 Ansible 需要以不同用户身份执行模块时进行检查。

如果 setfacl 和 chown 都失败，并且不允许不同用户访问模块的文件，则它们将被 chgrp 到此组。

为了使此方法起作用，远程用户和 become 用户必须共享一个公共组，并且此设置必须设置为该组。

配置

remote_tmp

string

在执行任务时，在目标上使用的临时目录。

默认值： "~/.ansible/tmp"

配置

system_tmpdirs

list / elements=string

受管机器上有效的系统临时目录列表，Ansible 用于针对 remote_tmp 进行验证，当需要特定权限时。这些目录必须对所有人可读、可写和可执行。此列表中只应包含系统管理员已预先创建并具有适当所有权和权限的目录，否则可能会出现安全问题。

当 remote_tmp 需要成为系统临时目录，并且它与列表中的任何目录都不匹配时，将使用列表中的第一个目录。

默认值： ["/var/tmp", "/tmp"]

配置

  • INI 条目

    [defaults]
system_tmpdirs = /var/tmp, /tmp

  • 环境变量：ANSIBLE_SYSTEM_TMPDIRS

  • 变量：ansible_system_tmpdirs

world_readable_temp

boolean

在 ansible-base 2.10 中添加

这将使在机器上创建的临时文件对所有人可读，并且将发出警告而不是导致任务失败。

在成为非特权用户时很有用。

选项

  • false ← (默认值)

  • true

配置

提示

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