ansible.builtin.su become – 替换用户

注意

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

Ansible 2.8 中新增

摘要

  • 此 become 插件允许您的远程/登录用户通过 su 实用程序以其他用户身份执行命令。

参数

参数

注释

become_exe

字符串

Su 可执行文件

默认值： "su"

配置

  • INI 条目

    [privilege_escalation]
become_exe = su

    [su_become_plugin]
executable = su

  • 环境变量：ANSIBLE_BECOME_EXE

  • 环境变量：ANSIBLE_SU_EXE

  • 变量：ansible_become_exe

  • 变量：ansible_su_exe

  • 关键字：become_exe

become_flags

字符串

传递给 su 的选项

默认值： ""

配置

  • INI 条目

    [privilege_escalation]
become_flags = ""

    [su_become_plugin]
flags = ""

  • 环境变量：ANSIBLE_BECOME_FLAGS

  • 环境变量：ANSIBLE_SU_FLAGS

  • 变量：ansible_become_flags

  • 变量：ansible_su_flags

  • 关键字：become_flags

become_pass

字符串

传递给 su 的密码

配置

  • INI 条目

    [su_become_plugin]
password = VALUE

  • 环境变量：ANSIBLE_BECOME_PASS

  • 环境变量：ANSIBLE_SU_PASS

  • 变量：ansible_become_password

  • 变量：ansible_become_pass

  • 变量：ansible_su_pass

become_user

字符串

您“成为”以执行任务的用户

默认值： "root"

配置

  • INI 条目

    [privilege_escalation]
become_user = root

    [su_become_plugin]
user = root

  • 环境变量：ANSIBLE_BECOME_USER

  • 环境变量：ANSIBLE_SU_USER

  • 变量：ansible_become_user

  • 变量：ansible_su_user

  • 关键字：become_user

prompt_l10n

列表 / 元素=字符串

要匹配以进行提示检测的本地化字符串列表

如果为空，我们将使用内置的字符串

请勿在自定义条目中添加冒号 (:)。Ansible 会在每个提示的末尾添加一个冒号；如果您在字符串中添加了另一个冒号，您的提示将因“超时”错误而失败。

默认值： []

配置

  • INI 条目

    [su_become_plugin]
localized_prompts =

  • 环境变量：ANSIBLE_SU_PROMPT_L10N

  • 变量：ansible_su_prompt_l10n

作者

  • ansible (@core)

提示

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