Ansible 配置设置
Ansible 支持多种配置其行为的来源，包括名为 ansible.cfg 的 ini 文件、环境变量、命令行选项、playbook 关键字和变量。有关每个来源的相对优先级的详细信息，请参阅 控制 Ansible 的行为方式：优先级规则。
ansible-config 实用程序允许用户查看所有可用的配置设置、它们的默认值、如何设置它们以及它们的当前值来自哪里。有关更多信息，请参阅 ansible-config。
配置文件
可以在配置文件中进行和使用更改，该文件将按以下顺序搜索
ANSIBLE_CONFIG（如果设置了环境变量）
ansible.cfg（在当前目录中）
~/.ansible.cfg（在家目录中）
/etc/ansible/ansible.cfg
Ansible 将处理上述列表并使用找到的第一个文件，所有其他文件都将被忽略。
注意
配置文件是 INI 格式的一种变体。当注释以行开头时，井号 (#) 和分号 (;) 都允许作为注释标记。但是，如果注释与常规值内联，则只允许使用分号来引入注释。例如
# some basic default values...
inventory = /etc/ansible/hosts ; This points to the file that lists your hosts
生成示例 ansible.cfg 文件
您可以生成一个完全注释掉的示例 ansible.cfg 文件，例如
$ ansible-config init --disabled > ansible.cfg
您还可以拥有一个包含现有插件的更完整的文件
$ ansible-config init --disabled -t all > ansible.cfg
您可以将这些作为起点来创建自己的 ansible.cfg 文件。
避免在当前目录中使用 ansible.cfg 时的安全风险
如果 Ansible 要从可写世界的当前工作目录加载 ansible.cfg，则会造成严重的安全风险。其他用户可以在那里放置他们自己的配置文件，旨在使 Ansible 在本地和远程运行恶意代码，并且可能具有提升的权限。因此，如果目录是可写世界的，Ansible 将不会自动从当前工作目录加载配置文件。
如果您依赖于在当前工作目录中使用配置文件的 Ansible，避免此问题的最佳方法是将对 Ansible 目录的访问权限限制为特定的用户和/或组。如果您的 Ansible 目录位于必须模拟 Unix 权限的文件系统上，例如 Vagrant 或适用于 Linux 的 Windows 子系统 (WSL)，您最初可能不知道如何修复此问题，因为 chmod、chown 和 chgrp 可能在那里不起作用。在大多数情况下，正确的解决方法是修改文件系统的挂载选项，以便运行 Ansible 的用户和组可以读取和写入文件和目录，但对其他人关闭。有关正确设置的更多详细信息，请参阅
对于 Vagrant，Vagrant 文档 涵盖了同步文件夹权限。
对于 WSL，WSL 文档 和此 Microsoft 博客文章 涵盖了挂载选项。
如果您绝对依赖于将 Ansible 配置存储在可写世界的当前工作目录中，则可以通过 ANSIBLE_CONFIG 环境变量显式指定配置文件。请在这样做之前采取适当的步骤来缓解上述安全问题。
配置的相对路径
您可以为许多配置选项指定相对路径。在大多数情况下，使用的路径将相对于当前执行中使用的 ansible.cfg 文件。如果您需要相对于当前工作目录 (CWD) 的路径，则可以使用 {{CWD}} 宏来指定它。我们不建议使用此方法，因为使用 CWD 作为相对路径的根目录可能存在安全风险。例如： cd /tmp; secureinfo=./newrootpassword ansible-playbook ~/safestuff/change_root_pwd.yml。
常用选项
这是我们发布版本中可用选项的副本，您的本地安装可能由于额外的插件而具有额外的选项，您可以使用上面提到的命令行工具（ansible-config）来浏览这些选项。
ACTION_WARNINGS
- 描述：
默认情况下，Ansible 在从任务操作（模块或操作插件）接收到警告时会发出警告。可以通过将此设置调整为 False 来禁用这些警告。
- 类型：
布尔值
- 默认值：
True- 版本添加：
2.5
- Ini：
- 部分：
[defaults]
- 键：
action_warnings
- 环境：
AGNOSTIC_BECOME_PROMPT
- 描述：
显示一个不可知的 become 提示，而不是显示一个包含命令行提供的 become 方法的提示。
- 类型：
布尔值
- 默认值：
True- 版本添加：
2.5
- Ini：
- 部分：
[privilege_escalation]
- 键：
agnostic_become_prompt
- 环境：
ANSIBLE_CONNECTION_PATH
- 描述：
指定在哪里查找 ansible-connection 脚本。在搜索 $PATH 之前，将检查此位置。如果为 null，ansible 将从与 ansible 脚本相同的目录开始。
- 类型：
路径
- 默认值：
无- 版本添加：
2.8
- Ini：
- 部分：
[persistent_connection]
- 键：
ansible_connection_path
- 环境：
- 已弃用：
2.22
- 已弃用详细信息：
此设置无效。
ANSIBLE_COW_ACCEPTLIST
- 描述：
接受一个“安全”的 cowsay 模板列表，如果要启用所有已安装的模板，请将其设置为空列表。
- 类型：
列表
- 默认值：
['bud-frogs', 'bunny', 'cheese', 'daemon', 'default', 'dragon', 'elephant-in-snake', 'elephant', 'eyes', 'hellokitty', 'kitty', 'luke-koala', 'meow', 'milk', 'moofasa', 'moose', 'ren', 'sheep', 'small', 'stegosaurus', 'stimpy', 'supermilker', 'three-eyes', 'turkey', 'turtle', 'tux', 'udder', 'vader-koala', 'vader', 'www']- Ini：
- 部分：
[defaults]
- 键：
cowsay_enabled_stencils :版本添加: 2.11
- 环境：
- 变量：
ANSIBLE_COW_ACCEPTLIST:版本添加: 2.11
ANSIBLE_COW_PATH
- 描述：
指定自定义 cowsay 路径或换入您选择的 cowsay 实现。
- 类型：
字符串
- 默认值：
无- Ini：
- 部分：
[defaults]
- 键：
cowpath
- 环境：
- 变量：
ANSIBLE_COW_SELECTION
- 描述：
这允许您为横幅选择特定的 cowsay 模板，或使用“随机”循环浏览它们。
- 默认值：
默认- Ini：
- 部分：
[defaults]
- 键：
cow_selection
- 环境：
ANSIBLE_FORCE_COLOR
- 描述：
即使在没有 TTY 运行或“nocolor”设置 为 True 时，此选项也会强制使用颜色模式。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
force_color
- 环境：
ANSIBLE_HOME
- 描述：
控制器上 Ansible 配置文件的默认根路径。
- 类型：
路径
- 默认值：
~/.ansible- 版本添加：
2.14
- Ini：
- 部分：
[defaults]
- 键：
home
- 环境：
- 变量：
ANSIBLE_NOCOLOR
- 描述：
此设置允许禁止对输出进行着色，着色用于更好地指示失败和状态信息。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
nocolor
- 环境：
- 变量：
- 变量：
- 版本添加：
2.11
ANSIBLE_NOCOWS
- 描述：
如果您安装了 cowsay 但想避免“cows”（为什么？？？？），请使用此选项。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
nocows
- 环境：
- 变量：
ANSIBLE_PIPELINING
- 描述：
这是一个全局选项，每个连接插件都可以通过具有更具体的选项或根本不支持流水线来覆盖它。如果连接插件支持流水线，则可以通过执行许多 Ansible 模块而无需实际文件传输来减少在远程服务器上执行模块所需网络操作的数量。启用后，它可以显著提高性能。但这与权限提升（become）相冲突。例如，当使用“sudo:”操作时，您必须首先在所有托管主机上的 /etc/sudoers 中禁用“requiretty”，这就是默认禁用它的原因。如果启用了
ANSIBLE_KEEP_REMOTE_FILES，则此设置将被禁用。- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[connection]
- 键：
pipelining
- 部分：
[defaults]
- 键：
pipelining
- 环境：
ANY_ERRORS_FATAL
- 描述：
设置 any_errors_fatal 关键字的默认值，如果为 True，则任务失败将被视为致命错误。
- 类型：
布尔值
- 默认值：
False- 版本添加：
2.4
- Ini：
- 部分：
[defaults]
- 键：
any_errors_fatal
- 环境：
BECOME_ALLOW_SAME_USER
- 描述：
当
False``(默认值) 时，如果远程用户与 become 用户相同，Ansible 将跳过使用 become ，因为这通常是冗余操作。换句话说， root sudo 到 root 。如果 ``True，这将强制 Ansible 使用 become 插件，因为在某些情况下需要这样做。- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[privilege_escalation]
- 键：
become_allow_same_user
- 环境：
BECOME_PASSWORD_FILE
- 描述：
become 插件使用的密码文件。
--become-password-file。如果可执行，它将被运行，并将生成的标准输出用作密码。- 类型：
路径
- 默认值：
无- 版本添加：
2.12
- Ini：
- 部分：
[defaults]
- 键：
become_password_file
- 环境：
BECOME_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索 Become 插件的冒号分隔路径。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/become:/usr/share/ansible/plugins/become" }}- 版本添加：
2.8
- Ini：
- 部分：
[defaults]
- 键：
become_plugins
- 环境：
CACHE_PLUGIN
- 描述：
选择要使用的缓存插件，默认的“内存”是短暂的。
- 默认值：
内存- Ini：
- 部分：
[defaults]
- 键：
fact_caching
- 环境：
CACHE_PLUGIN_CONNECTION
- 描述：
定义缓存插件的连接或路径信息。
- 默认值：
无- Ini：
- 部分：
[defaults]
- 键：
fact_caching_connection
- 环境：
CACHE_PLUGIN_PREFIX
- 描述：
用于缓存插件文件/表的。前缀。
- 默认值：
ansible_facts- Ini：
- 部分：
[defaults]
- 键：
fact_caching_prefix
- 环境：
CACHE_PLUGIN_TIMEOUT
- 描述：
缓存插件数据的过期超时。
- 类型：
整数
- 默认值：
86400- Ini：
- 部分：
[defaults]
- 键：
fact_caching_timeout
- 环境：
CALLBACKS_ENABLED
- 描述：
已启用的回调列表，并非所有回调都需要启用，但 Ansible 附带的许多回调都需要启用，因为我们不希望默认情况下激活它们。
- 类型：
列表
- 默认值：
[]- Ini：
- 部分：
[defaults]
- 键：
callbacks_enabled :版本添加: 2.11
- 环境：
- 变量：
ANSIBLE_CALLBACKS_ENABLED:版本新增: 2.11
COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH
- 描述：
当加载的 collection 不支持正在运行的 Ansible 版本时（使用 collection 元数据键 requires_ansible）。
- 默认值：
警告- 选项：
- error：
发出“致命”错误并停止运行
- warning：
发出警告但继续运行
- ignore：
只是默默地继续
- Ini：
- 部分：
[defaults]
- 键：
collections_on_ansible_version_mismatch
- 环境：
COLLECTIONS_PATHS
- 描述：
Ansible 将在其中搜索 collection 内容的路径，以冒号分隔。Collection 必须位于嵌套的*子目录*中，而不能直接位于这些目录中。例如，如果
COLLECTIONS_PATHS包含'{{ ANSIBLE_HOME ~ "/collections" }}'，并且您想将my.collection添加到该目录，则必须将其保存为'{{ ANSIBLE_HOME} ~ "/collections/ansible_collections/my/collection" }}'。- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/collections:/usr/share/ansible/collections" }}- Ini：
- 部分：
[defaults]
- 键：
collections_paths
- 已弃用：
2.19
- 已弃用详细信息：
不符合变量命名标准，请改用单数形式 collections_path
- 部分：
[defaults]
- 键：
collections_path
- 版本添加：
2.10
- 环境：
- 变量：
- 版本添加：
2.10
- 变量：
- 已弃用：
2.19
- 已弃用详细信息：
不符合变量命名标准，请改用单数形式 ANSIBLE_COLLECTIONS_PATH
COLLECTIONS_SCAN_SYS_PATH
- 描述：
一个布尔值，用于启用或禁用扫描 sys.path 以查找已安装的 collection。
- 类型：
布尔值
- 默认值：
True- Ini：
- 部分：
[defaults]
- 键：
collections_scan_sys_path
- 环境：
COLOR_CHANGED
- 描述：
定义用于“已更改”任务状态的颜色。
- 默认值：
黄色- Ini：
- 部分：
[颜色]
- 键：
已更改
- 环境：
COLOR_CONSOLE_PROMPT
- 描述：
定义用于 ansible-console 的默认颜色。
- 默认值：
白色- 版本添加：
2.7
- Ini：
- 部分：
[颜色]
- 键：
console_prompt
- 环境：
COLOR_DEBUG
- 描述：
定义发出调试消息时使用的颜色。
- 默认值：
深 灰色- Ini：
- 部分：
[颜色]
- 键：
调试
- 环境：
COLOR_DEPRECATE
- 描述：
定义发出弃用消息时使用的颜色。
- 默认值：
紫色- Ini：
- 部分：
[颜色]
- 键：
弃用
- 环境：
COLOR_DIFF_ADD
- 描述：
定义在差异中显示添加的行时使用的颜色。
- 默认值：
绿色- Ini：
- 部分：
[颜色]
- 键：
diff_add
- 环境：
COLOR_DIFF_LINES
- 描述：
定义显示差异时使用的颜色。
- 默认值：
青色- Ini：
- 部分：
[颜色]
- 键：
diff_lines
- 环境：
COLOR_DIFF_REMOVE
- 描述：
定义在差异中显示删除的行时使用的颜色。
- 默认值：
红色- Ini：
- 部分：
[颜色]
- 键：
diff_remove
- 环境：
COLOR_DOC_CONSTANT
- 描述：
定义在 ansible-doc 输出中发出常量时使用的颜色。
- 默认值：
深 灰色- 版本添加：
2.18
- Ini：
- 部分：
[颜色]
- 键：
doc_constant
- 环境：
COLOR_DOC_DEPRECATED
- 描述：
定义在 ansible-doc 输出中发出已弃用值时使用的颜色。
- 默认值：
品红色- 版本添加：
2.18
- Ini：
- 部分：
[颜色]
- 键：
doc_deprecated
- 环境：
COLOR_DOC_LINK
- 描述：
定义在 ansible-doc 输出中发出链接时使用的颜色。
- 默认值：
青色- 版本添加：
2.18
- Ini：
- 部分：
[颜色]
- 键：
doc_link
- 环境：
COLOR_DOC_MODULE
- 描述：
定义在 ansible-doc 输出中发出模块名称时使用的颜色。
- 默认值：
黄色- 版本添加：
2.18
- Ini：
- 部分：
[颜色]
- 键：
doc_module
- 环境：
COLOR_DOC_PLUGIN
- 描述：
定义在 ansible-doc 输出中发出插件名称时使用的颜色。
- 默认值：
黄色- 版本添加：
2.18
- Ini：
- 部分：
[颜色]
- 键：
doc_plugin
- 环境：
COLOR_DOC_REFERENCE
- 描述：
定义在 ansible-doc 输出中发出交叉引用时使用的颜色。
- 默认值：
品红色- 版本添加：
2.18
- Ini：
- 部分：
[颜色]
- 键：
doc_reference
- 环境：
COLOR_ERROR
- 描述：
定义发出错误消息时使用的颜色。
- 默认值：
红色- Ini：
- 部分：
[颜色]
- 键：
错误
- 环境：
COLOR_HIGHLIGHT
- 描述：
定义用于高亮的顏色。
- 默认值：
白色- Ini：
- 部分：
[颜色]
- 键：
高亮
- 环境：
COLOR_INCLUDED
- 描述：
定义显示“已包含”任务状态时使用的颜色。
- 默认值：
青色- 版本添加：
2.18
- Ini：
- 部分：
[颜色]
- 键：
已包含
- 环境：
COLOR_OK
- 描述：
定义显示“确定”任务状态时使用的颜色。
- 默认值：
绿色- Ini：
- 部分：
[颜色]
- 键：
确定
- 环境：
- 变量：
COLOR_SKIP
- 描述：
定义显示“已跳过”任务状态时使用的颜色。
- 默认值：
青色- Ini：
- 部分：
[颜色]
- 键：
已跳过
- 环境：
COLOR_UNREACHABLE
- 描述：
定义“不可达”状态时使用的颜色。
- 默认值：
亮 红色- Ini：
- 部分：
[颜色]
- 键：
不可达
- 环境：
COLOR_VERBOSE
- 描述：
定义发出详细消息时使用的颜色。换句话说，就是那些用“-v”显示的消息。
- 默认值：
蓝色- Ini：
- 部分：
[颜色]
- 键：
详细
- 环境：
COLOR_WARN
- 描述：
定义发出警告消息时使用的颜色。
- 默认值：
亮 紫色- Ini：
- 部分：
[颜色]
- 键：
警告
- 环境：
CONNECTION_FACTS_MODULES
- 描述：
根据连接在剧本的信息收集阶段运行哪些模块
- 类型：
字典
- 默认值：
{'asa': 'ansible.legacy.asa_facts', 'cisco.asa.asa': 'cisco.asa.asa_facts', 'eos': 'ansible.legacy.eos_facts', 'arista.eos.eos': 'arista.eos.eos_facts', 'frr': 'ansible.legacy.frr_facts', 'frr.frr.frr': 'frr.frr.frr_facts', 'ios': 'ansible.legacy.ios_facts', 'cisco.ios.ios': 'cisco.ios.ios_facts', 'iosxr': 'ansible.legacy.iosxr_facts', 'cisco.iosxr.iosxr': 'cisco.iosxr.iosxr_facts', 'junos': 'ansible.legacy.junos_facts', 'junipernetworks.junos.junos': 'junipernetworks.junos.junos_facts', 'nxos': 'ansible.legacy.nxos_facts', 'cisco.nxos.nxos': 'cisco.nxos.nxos_facts', 'vyos': 'ansible.legacy.vyos_facts', 'vyos.vyos.vyos': 'vyos.vyos.vyos_facts', 'exos': 'ansible.legacy.exos_facts', 'extreme.exos.exos': 'extreme.exos.exos_facts', 'slxos': 'ansible.legacy.slxos_facts', 'extreme.slxos.slxos': 'extreme.slxos.slxos_facts', 'voss': 'ansible.legacy.voss_facts', 'extreme.voss.voss': 'extreme.voss.voss_facts', 'ironware': 'ansible.legacy.ironware_facts', 'community.network.ironware': 'community.network.ironware_facts'}
CONNECTION_PASSWORD_FILE
- 描述：
用于连接插件的密码文件。
--connection-password-file。- 类型：
路径
- 默认值：
无- 版本添加：
2.12
- Ini：
- 部分：
[defaults]
- 键：
connection_password_file
- 环境：
COVERAGE_REMOTE_OUTPUT
- 描述：
设置远程主机上的输出目录，用于生成覆盖率报告。目前仅用于 PowerShell 模块的远程覆盖率。这仅供内部使用。
- 类型：
字符串
- 版本添加：
2.9
- 环境：
- 变量：
- 名称：
_ansible_coverage_remote_output
COVERAGE_REMOTE_PATHS
- 描述：
Ansible 控制器上要运行覆盖率的文件路径列表，当在远程主机上执行时。只有与路径 glob 匹配的文件才会收集其覆盖率。可以指定多个路径 glob，并用
:分隔。目前仅用于 PowerShell 模块的远程覆盖率。这仅供内部使用。- 类型：
字符串
- 默认值：
*- 版本添加：
2.9
- 环境：
DEFAULT_ACTION_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索操作插件的以冒号分隔的路径。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/action:/usr/share/ansible/plugins/action" }}- Ini：
- 部分：
[defaults]
- 键：
action_plugins
- 环境：
DEFAULT_ALLOW_UNSAFE_LOOKUPS
- 描述：
启用后，此选项允许查找插件（无论是在变量中用作
{{lookup('foo')}}还是作为循环用作 with_foo）返回未标记为“不安全”的数据。默认情况下，此类数据被标记为不安全，以防止模板引擎评估任何 jinja2 模板语言，因为这可能代表安全风险。提供此选项是为了向后兼容，但是，用户应首先考虑向任何可能包含可能在稍后通过模板引擎运行的数据的查找添加 allow_unsafe=True。- 类型：
布尔值
- 默认值：
False- 版本添加：
2.2.3
- Ini：
- 部分：
[defaults]
- 键：
allow_unsafe_lookups
DEFAULT_ASK_PASS
- 描述：
这控制 Ansible playbook 是否应提示输入登录密码。如果使用 SSH 密钥进行身份验证，则您可能不需要更改此设置。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
ask_pass
- 环境：
- 变量：
DEFAULT_ASK_VAULT_PASS
- 描述：
这控制 Ansible playbook 是否应提示输入保管库密码。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
ask_vault_pass
- 环境：
DEFAULT_BECOME
- 描述：
切换权限提升的使用，允许您在登录后“成为”另一个用户。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[privilege_escalation]
- 键：
become
- 环境：
- 变量：
DEFAULT_BECOME_ASK_PASS
- 描述：
切换以提示输入权限提升密码。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[privilege_escalation]
- 键：
become_ask_pass
- 环境：
DEFAULT_BECOME_EXE
- 描述：
用于权限提升的可执行文件，否则 Ansible 将依赖于 PATH。
- 默认值：
无- Ini：
- 部分：
[privilege_escalation]
- 键：
become_exe
- 环境：
DEFAULT_BECOME_FLAGS
- 描述：
传递给权限提升可执行文件的标志。
- 默认值：
- Ini：
- 部分：
[privilege_escalation]
- 键：
become_flags
- 环境：
DEFAULT_BECOME_METHOD
- 描述：
启用 become 时要使用的权限提升方法。
- 默认值：
sudo- Ini：
- 部分：
[privilege_escalation]
- 键：
become_method
- 环境：
DEFAULT_BECOME_USER
- 描述：
使用权限提升时，您的登录/远程用户“成为”的用户，大多数系统在未指定用户时将使用“root”。
- 默认值：
root- Ini：
- 部分：
[privilege_escalation]
- 键：
become_user
- 环境：
DEFAULT_CACHE_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索缓存插件的以冒号分隔的路径。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/cache:/usr/share/ansible/plugins/cache" }}- Ini：
- 部分：
[defaults]
- 键：
cache_plugins
- 环境：
DEFAULT_CALLBACK_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索回调插件的以冒号分隔的路径。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/callback:/usr/share/ansible/plugins/callback" }}- Ini：
- 部分：
[defaults]
- 键：
callback_plugins
- 环境：
DEFAULT_CLICONF_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索 Cliconf 插件的以冒号分隔的路径。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/cliconf:/usr/share/ansible/plugins/cliconf" }}- Ini：
- 部分：
[defaults]
- 键：
cliconf_plugins
- 环境：
DEFAULT_CONNECTION_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索连接插件的以冒号分隔的路径。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/connection:/usr/share/ansible/plugins/connection" }}- Ini：
- 部分：
[defaults]
- 键：
connection_plugins
- 环境：
DEFAULT_DEBUG
- 描述：
在 Ansible 中切换调试输出。这将非常详细，并且可能会妨碍多处理。尽管已启用 no_log 设置，但调试输出也可能包含机密信息，这意味着调试模式不应在生产环境中使用。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
调试
- 环境：
- 变量：
DEFAULT_EXECUTABLE
- 描述：
这指示用于生成 shell 的命令，这是 Ansible 在目标上执行所需的操作。当 shell 使用受到限制时，用户可能需要在极少数情况下更改此设置，但在大多数情况下，可以保留原样。
- 默认值：
/bin/sh- Ini：
- 部分：
[defaults]
- 键：
可执行文件
- 环境：
DEFAULT_FILTER_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索 Jinja2 过滤器插件的以冒号分隔的路径。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/filter:/usr/share/ansible/plugins/filter" }}- Ini：
- 部分：
[defaults]
- 键：
filter_plugins
- 环境：
DEFAULT_FORCE_HANDLERS
- 描述：
此选项控制即使主机上发生故障，通知处理程序是否仍在主机上运行。如果为 false，则如果主机上发生故障，则处理程序将不会运行。这也可以按播放或在命令行上设置。有关更多详细信息，请参阅处理程序和故障。
- 类型：
布尔值
- 默认值：
False- 版本添加：
1.9.1
- Ini：
- 部分：
[defaults]
- 键：
force_handlers
- 环境：
DEFAULT_FORKS
- 描述：
Ansible 用于在目标主机上执行任务的最大分支数。
- 类型：
整数
- 默认值：
5- Ini：
- 部分：
[defaults]
- 键：
分支
- 环境：
- 变量：
DEFAULT_GATHERING
- 描述：
此设置控制事实收集的默认策略（有关远程系统发现的事实）。此选项对于那些希望节省事实收集时间的人很有用。“智能”和“显式”都将使用缓存插件。
- 默认值：
隐式- 选项：
- 隐式：
缓存插件将被忽略，并且除非设置了“gather_facts: False”，否则将为每次播放收集事实。
- 显式：
除非在播放中直接请求，否则不会收集事实。
- 智能：
每个没有发现事实的新主机都将被扫描，但如果同一主机在多个剧本中被寻址，则在运行中不会再次联系它。
- 版本添加：
1.6
- Ini：
- 部分：
[defaults]
- 键：
收集
- 环境：
DEFAULT_HASH_BEHAVIOUR
- 描述：
此设置控制 Ansible 中如何处理字典变量（也称为哈希、映射、关联数组）的重复定义。 这不会影响其值为标量（整数、字符串）或数组的变量。 警告，不建议更改此设置，因为这很脆弱，并且会使您的内容（剧本、角色、集合）不可移植，从而导致持续的混乱和误用。 除非您认为绝对需要，否则不要更改此设置。 我们建议避免重复使用变量名称，而是依赖
combine过滤器以及vars和varnames查找来创建各个变量的合并版本。 根据我们的经验，很少需要这样做，这表明数据结构和剧本中引入了太多复杂性。 对于某些用途，您还可以研究自定义 vars_plugins 以在输入时合并，甚至替换负责解析host_vars/和group_vars/目录的默认host_group_vars。 此设置的大多数用户只对清单范围感兴趣，但该设置本身会影响所有来源，并使调试更加困难。 官方示例存储库中的所有剧本和角色都假定此设置为默认值。 将设置更改为merge会应用于所有变量源，但许多源在内部仍会覆盖变量。 例如，include_vars会在更新 Ansible 之前在内部对变量进行重复数据删除，其中“最后定义的”会覆盖同一文件中之前的定义。 Ansible 项目建议您避免对新项目使用 ``merge``。 Ansible 开发人员打算最终弃用并删除此设置，但由于某些用户非常依赖它，因此保留了该设置。 新项目应避免使用“合并”。- 类型：
字符串
- 默认值：
替换- 选项：
- 替换：
使用变量优先级规则（最高者获胜）的顺序覆盖任何多次定义的变量。
- 合并：
任何字典变量都将与不同变量定义源中的新定义递归合并。
- Ini：
- 部分：
[defaults]
- 键：
hash_behaviour
- 环境：
DEFAULT_HOST_LIST
- 描述：
Ansible 清单源的逗号分隔列表
- 类型：
路径列表
- 默认值：
/etc/ansible/hosts- Ini：
- 部分：
[defaults]
- 键：
清单
- 环境：
DEFAULT_HTTPAPI_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索 HttpApi 插件的路径（以冒号分隔）。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/httpapi:/usr/share/ansible/plugins/httpapi" }}- Ini：
- 部分：
[defaults]
- 键：
httpapi_plugins
- 环境：
DEFAULT_INTERNAL_POLL_INTERVAL
- 描述：
这将设置 Ansible 内部进程相互轮询的时间间隔（以秒为单位）。 较低的值以额外的 CPU 负载为代价提高了大型剧本的性能。 当不需要 UI 响应能力但 CPU 使用率可能是一个问题时，较高的值更适合在自动化场景中使用 Ansible。 默认值对应于 Ansible <= 2.1 中硬编码的值
- 类型：
浮点数
- 默认值：
0.001- 版本添加：
2.2
- Ini：
- 部分：
[defaults]
- 键：
internal_poll_interval
DEFAULT_INVENTORY_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索清单插件的路径（以冒号分隔）。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/inventory:/usr/share/ansible/plugins/inventory" }}- Ini：
- 部分：
[defaults]
- 键：
inventory_plugins
- 环境：
DEFAULT_JINJA2_EXTENSIONS
- 描述：
这是一项特定于开发人员的功能，允许启用其他 Jinja2 扩展。 有关详细信息，请参阅 Jinja2 文档。 如果您不知道这些是什么，您可能不需要更改此设置 :)
- 默认值：
[]- Ini：
- 部分：
[defaults]
- 键：
jinja2_extensions
- 环境：
DEFAULT_JINJA2_NATIVE
- 描述：
此选项在模板操作期间保留变量类型。
- 类型：
布尔值
- 默认值：
False- 版本添加：
2.7
- Ini：
- 部分：
[defaults]
- 键：
jinja2_native
- 环境：
DEFAULT_KEEP_REMOTE_FILES
- 描述：
启用/禁用清理 Ansible 用于在远程执行任务的临时文件。 如果启用此选项，它将禁用
ANSIBLE_PIPELINING。- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
keep_remote_files
- 环境：
DEFAULT_LIBVIRT_LXC_NOSECLABEL
- 描述：
此设置通过将
--noseclabel参数传递给virsh命令来使 libvirt 连接到 LXC 容器。 这是在没有 SELinux 的系统上运行时所必需的。- 类型：
布尔值
- 默认值：
False- 版本添加：
2.1
- Ini：
- 部分：
[selinux]
- 键：
libvirt_lxc_noseclabel
- 环境：
DEFAULT_LOAD_CALLBACK_PLUGINS
- 描述：
控制在运行 /usr/bin/ansible 时是否加载回调插件。 这可用于记录来自命令行的活动、发送通知等。 始终为
ansible-playbook加载回调插件。- 类型：
布尔值
- 默认值：
False- 版本添加：
1.8
- Ini：
- 部分：
[defaults]
- 键：
bin_ansible_callbacks
- 环境：
DEFAULT_LOCAL_TMP
- 描述：
Ansible 在控制器上使用的临时目录。
- 类型：
tmppath
- 默认值：
{{ ANSIBLE_HOME ~ "/tmp" }}- Ini：
- 部分：
[defaults]
- 键：
local_tmp
- 环境：
DEFAULT_LOG_FILTER
- 描述：
要从日志文件中过滤掉的记录器名称列表。
- 类型：
列表
- 默认值：
[]- Ini：
- 部分：
[defaults]
- 键：
log_filter
- 环境：
DEFAULT_LOG_PATH
- 描述：
Ansible 将在控制器上记录到的文件。 未设置时，将禁用日志记录。
- 类型：
路径
- 默认值：
无- Ini：
- 部分：
[defaults]
- 键：
log_path
- 环境：
- 变量：
DEFAULT_LOOKUP_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索查找插件的路径（以冒号分隔）。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/lookup:/usr/share/ansible/plugins/lookup" }}- Ini：
- 部分：
[defaults]
- 键：
lookup_plugins
- 环境：
DEFAULT_MANAGED_STR
- 描述：
设置 ansible_collections.ansible.builtin.template_module 和 ansible_collections.ansible.windows.win_template_module 可用的“ansible_managed”变量的宏。 这仅与这两个模块相关。
- 默认值：
Ansible managed- Ini：
- 部分：
[defaults]
- 键：
ansible_managed
DEFAULT_MODULE_ARGS
- 描述：
如果未指定
-a，则设置要传递给ansibleadhoc 二进制文件的默认参数。- 默认值：
无- Ini：
- 部分：
[defaults]
- 键：
module_args
- 环境：
DEFAULT_MODULE_COMPRESSION
- 描述：
将 Python 模块传输到目标时使用的压缩方案。
- 默认值：
ZIP_DEFLATED- Ini：
- 部分：
[defaults]
- 键：
module_compression
- 变量：
- 名称：
ansible_module_compression
DEFAULT_MODULE_NAME
- 描述：
如果未通过
-m指定，则与ansibleAdHoc 命令一起使用的模块。- 默认值：
命令- Ini：
- 部分：
[defaults]
- 键：
module_name
DEFAULT_MODULE_PATH
- 描述：
Ansible 将在其中搜索模块的路径（以冒号分隔）。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/modules:/usr/share/ansible/plugins/modules" }}- Ini：
- 部分：
[defaults]
- 键：
库
- 环境：
- 变量：
DEFAULT_MODULE_UTILS_PATH
- 描述：
Ansible 将在其中搜索模块实用程序文件的路径（以冒号分隔），这些文件由模块共享。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/module_utils:/usr/share/ansible/plugins/module_utils" }}- Ini：
- 部分：
[defaults]
- 键：
module_utils
- 环境：
DEFAULT_NETCONF_PLUGIN_PATH
- 描述：
Ansible 将在其中搜索 Netconf 插件的路径（以冒号分隔）。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/netconf:/usr/share/ansible/plugins/netconf" }}- Ini：
- 部分：
[defaults]
- 键：
netconf_plugins
- 环境：
DEFAULT_NO_LOG
- 描述：
切换 Ansible 对任务详细信息的显示和记录，主要用于避免安全披露。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
no_log
- 环境：
- 变量：
DEFAULT_NO_TARGET_SYSLOG
- 描述：
当 Ansible 在目标主机上执行任务时，切换是否记录日志到系统日志。在 Windows 主机上，这将禁用较新样式的 PowerShell 模块写入事件日志的功能。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
no_target_syslog
- 环境：
- 变量：
- 名称：
ansible_no_target_syslog :版本新增: 2.10
DEFAULT_NULL_REPRESENTATION
- 描述：
模板应该返回什么作为“空”值。未设置时，将由 Jinja2 决定。
- 类型：
raw
- 默认值：
无- Ini：
- 部分：
[defaults]
- 键：
null_representation
- 环境：
DEFAULT_POLL_INTERVAL
- 描述：
对于 Ansible 中的异步任务（在“异步操作和轮询”中介绍），这是在未提供明确的轮询间隔时，检查这些任务状态的频率。默认值为 15 秒，这是一个折衷方案，可以在频繁检查和在任务可能已完成时提供快速周转之间取得平衡。
- 类型：
整数
- 默认值：
15- Ini：
- 部分：
[defaults]
- 键：
poll_interval
- 环境：
DEFAULT_PRIVATE_KEY_FILE
- 描述：
对于使用证书或密钥文件进行身份验证而不是使用代理或密码的连接，您可以在此处设置默认值，以避免每次调用都重新指定
--private-key。- 类型：
路径
- 默认值：
无- Ini：
- 部分：
[defaults]
- 键：
private_key_file
- 环境：
DEFAULT_PRIVATE_ROLE_VARS
- 描述：
默认情况下，导入的角色会将其变量发布到剧本和其他角色，此设置可以避免这种情况。引入此设置是为了在剧本中多次使用角色时将角色变量重置为默认值。从版本“2.17”开始，M(ansible.builtin.include_roles) 和 M(ansible.builtin.import_roles) 可以通过 C(public) 参数分别覆盖此设置。包含的角色仅在执行时公开其变量，这与在剧本编译时发生的导入角色不同。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
private_role_vars
- 环境：
DEFAULT_REMOTE_PORT
- 描述：
远程连接中使用的端口，为空时将使用连接插件的默认端口。
- 类型：
整数
- 默认值：
无- Ini：
- 部分：
[defaults]
- 键：
remote_port
- 环境：
DEFAULT_REMOTE_USER
- 描述：
设置目标机器的登录用户。为空时，将使用连接插件的默认用户，通常是当前执行 Ansible 的用户。
- Ini：
- 部分：
[defaults]
- 键：
remote_user
- 环境：
DEFAULT_ROLES_PATH
- 描述：
Ansible 搜索角色的以冒号分隔的路径列表。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/roles:/usr/share/ansible/roles:/etc/ansible/roles" }}- Ini：
- 部分：
[defaults]
- 键：
roles_path
- 环境：
DEFAULT_SELINUX_SPECIAL_FS
- 描述：
某些文件系统不支持安全操作和/或返回不一致的错误，此设置使 Ansible“容忍”列表中的那些文件系统，而不会导致致命错误。当文件系统在列表中时，可能会发生数据损坏，并且写入操作并不总是经过验证。
- 类型：
列表
- 默认值：
fuse, nfs, vboxsf, ramfs, 9p, vfat- Ini：
- 部分：
[selinux]
- 键：
special_context_filesystems
- 环境：
- 变量：
ANSIBLE_SELINUX_SPECIAL_FS:版本新增: 2.9
DEFAULT_STDOUT_CALLBACK
- 描述：
设置用于显示 Ansible 输出的主要回调插件。您一次只能使用一个。您可以拥有许多其他回调插件，但只有一个可以负责标准输出。有关可用选项的列表，请参阅回调插件。
- 默认值：
默认- Ini：
- 部分：
[defaults]
- 键：
stdout_callback
- 环境：
DEFAULT_STRATEGY
- 描述：
设置用于剧本的默认策略。
- 默认值：
linear- 版本添加：
2.3
- Ini：
- 部分：
[defaults]
- 键：
strategy
- 环境：
- 变量：
DEFAULT_STRATEGY_PLUGIN_PATH
- 描述：
Ansible 搜索策略插件的以冒号分隔的路径列表。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/strategy:/usr/share/ansible/plugins/strategy" }}- Ini：
- 部分：
[defaults]
- 键：
strategy_plugins
- 环境：
DEFAULT_SU
- 描述：
切换是否对任务使用“su”。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
su
- 环境：
- 变量：
DEFAULT_SYSLOG_FACILITY
- 描述：
当 Ansible 记录日志到远程目标时使用的系统日志工具。
- 默认值：
LOG_USER- Ini：
- 部分：
[defaults]
- 键：
syslog_facility
- 环境：
DEFAULT_TERMINAL_PLUGIN_PATH
- 描述：
Ansible 搜索终端插件的以冒号分隔的路径列表。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/terminal:/usr/share/ansible/plugins/terminal" }}- Ini：
- 部分：
[defaults]
- 键：
terminal_plugins
- 环境：
DEFAULT_TEST_PLUGIN_PATH
- 描述：
Ansible 搜索 Jinja2 测试插件的以冒号分隔的路径列表。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/test:/usr/share/ansible/plugins/test" }}- Ini：
- 部分：
[defaults]
- 键：
test_plugins
- 环境：
DEFAULT_TIMEOUT
- 描述：
这是连接插件使用的默认超时时间。
- 类型：
整数
- 默认值：
10- Ini：
- 部分：
[defaults]
- 键：
timeout
- 环境：
- 变量：
DEFAULT_TRANSPORT
- 描述：
可以是您的 Ansible 安装可用的任何连接插件。还有一个（已弃用）的特殊选项“smart”，它将根据控制器操作系统和 SSH 版本在“ssh”和“paramiko”之间切换。
- 默认值：
ssh- Ini：
- 部分：
[defaults]
- 键：
transport
- 环境：
DEFAULT_UNDEFINED_VAR_BEHAVIOR
- 描述：
如果为 True，则会导致 Ansible 模板在引用可能拼写错误的变量名的步骤失败。否则，任何包含未定义变量的“{{ template_expression }}”都将按原样在模板或 Ansible 操作行中呈现。
- 类型：
布尔值
- 默认值：
True- 版本添加：
1.3
- Ini：
- 部分：
[defaults]
- 键：
error_on_undefined_vars
- 环境：
DEFAULT_VARS_PLUGIN_PATH
- 描述：
Ansible 搜索变量插件的以冒号分隔的路径列表。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/vars:/usr/share/ansible/plugins/vars" }}- Ini：
- 部分：
[defaults]
- 键：
vars_plugins
- 环境：
DEFAULT_VAULT_ENCRYPT_IDENTITY
- 描述：
默认情况下用于加密的 vault_id。如果提供了多个 vault_id，则指定用于加密的 vault_id。
--encrypt-vault-id命令行选项会覆盖配置的值。- Ini：
- 部分：
[defaults]
- 键：
vault_encrypt_identity
- 环境：
DEFAULT_VAULT_ID_MATCH
- 描述：
如果为 true，则使用 vault id 解密保险库时，将仅尝试使用匹配 vault-id 的密码。
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
vault_id_match
- 环境：
DEFAULT_VAULT_IDENTITY
- 描述：
在未提供 vault id 标签的情况下，用于默认 vault id 标签的标签。
- 默认值：
默认- Ini：
- 部分：
[defaults]
- 键：
vault_identity
- 环境：
DEFAULT_VAULT_IDENTITY_LIST
- 描述：
默认情况下要使用的 vault-id 列表。等效于多个
--vault-id参数。Vault-id 按顺序尝试。- 类型：
列表
- 默认值：
[]- Ini：
- 部分：
[defaults]
- 键：
vault_identity_list
- 环境：
DEFAULT_VAULT_PASSWORD_FILE
- 描述：
要使用的保险库密码文件。等效于
--vault-password-file或--vault-id。如果可执行，它将被运行，并且生成的标准输出将用作密码。- 类型：
路径
- 默认值：
无- Ini：
- 部分：
[defaults]
- 键：
vault_password_file
- 环境：
DEFAULT_VERBOSITY
- 描述：
设置默认详细级别，等效于在命令行中传递的
-v的数量。- 类型：
整数
- 默认值：
0- Ini：
- 部分：
[defaults]
- 键：
verbosity
- 环境：
DEPRECATION_WARNINGS
- 描述：
用于控制是否显示弃用警告的开关。
- 类型：
布尔值
- 默认值：
True- Ini：
- 部分：
[defaults]
- 键：
deprecation_warnings
- 环境：
DEVEL_WARNING
- 描述：
用于控制是否显示与运行开发版本相关的警告的开关。
- 类型：
布尔值
- 默认值：
True- Ini：
- 部分：
[defaults]
- 键：
devel_warning
- 环境：
DIFF_ALWAYS
- 描述：
配置开关，用于指示模块在“已更改”状态下显示差异，等效于
--diff。- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[diff]
- 键：
always
- 环境：
DIFF_CONTEXT
- 描述：
显示文件差异时要显示的上下文行数。
- 类型：
整数
- 默认值：
3- Ini：
- 部分：
[diff]
- 键：
context
- 环境：
DISPLAY_ARGS_TO_STDOUT
- 描述：
通常情况下，
ansible-playbook会为每个运行的任务打印一个标题。这些标题将包含任务中 name: 字段的值（如果指定了该字段）。如果未指定，则ansible-playbook将使用任务的操作来帮助您区分当前正在运行的任务。有时，您会运行许多相同的操作，因此您需要更多有关任务的信息，以便将其与其他相同操作的任务区分开来。如果在配置中将此变量设置为 True，则ansible-playbook还将在标题中包含任务的参数。此设置默认为 False，因为您的参数中可能包含敏感值，并且您不希望打印这些值。如果将其设置为 True，则应确保已保护环境的标准输出（没有人可以窥视您的屏幕，并且您没有将标准输出保存到不安全的文件中），或者确保所有 playbook 都已为包含敏感值的任务显式添加了no_log: True参数。有关更多信息，请参阅如何在 playbook 中保存机密数据？。- 类型：
布尔值
- 默认值：
False- 版本添加：
2.1
- Ini：
- 部分：
[defaults]
- 键：
display_args_to_stdout
- 环境：
DISPLAY_SKIPPED_HOSTS
- 描述：
用于控制是否在默认回调中显示任务/主机跳过条目的开关。
- 类型：
布尔值
- 默认值：
True- Ini：
- 部分：
[defaults]
- 键：
display_skipped_hosts
- 环境：
DOC_FRAGMENT_PLUGIN_PATH
- 描述：
Ansible 在其中搜索文档片段插件的路径，以冒号分隔。
- 类型：
路径规范
- 默认值：
{{ ANSIBLE_HOME ~ "/plugins/doc_fragments:/usr/share/ansible/plugins/doc_fragments" }}- Ini：
- 部分：
[defaults]
- 键：
doc_fragment_plugins
- 环境：
DOCSITE_ROOT_URL
- 描述：
用于在警告/错误文本中生成文档 URL 的根文档站点 URL；必须是带有有效方案和尾部斜杠的绝对 URL。
- 默认值：
https://docs.ansible.org.cn/ansible-core/- 版本添加：
2.8
- Ini：
- 部分：
[defaults]
- 键：
docsite_root_url
DUPLICATE_YAML_DICT_KEY
- 描述：
默认情况下，当在 YAML 中遇到重复的字典键时，Ansible 会发出警告。可以通过将此设置调整为 False 来禁用这些警告。
- 类型：
字符串
- 默认值：
警告- 选项：
- error：
发出“致命”错误并停止运行
- warn:
发出警告但继续运行
- ignore：
只是默默地继续
- 版本添加：
2.9
- Ini：
- 部分：
[defaults]
- 键：
duplicate_dict_key
- 环境：
EDITOR
- 描述：
对于 Ansible 需要在编辑器中返回文件的情况，可以选择要使用的应用程序。
- 默认值：
vi- Ini：
- 部分：
[defaults]
- 键：
editor :版本新增: 2.15
- 环境：
- 变量：
- 版本添加：
2.15
- 变量：
ENABLE_TASK_DEBUGGER
- 描述：
是否启用任务调试器，这以前是作为策略插件完成的。现在，所有策略插件都可以继承此行为。默认情况下，当任务在不可达时失败时，调试器将激活。使用 debugger 关键字可以获得更大的灵活性。
- 类型：
布尔值
- 默认值：
False- 版本添加：
2.5
- Ini：
- 部分：
[defaults]
- 键：
enable_task_debugger
- 环境：
ERROR_ON_MISSING_HANDLER
- 描述：
用于允许在通知时将缺少的处理程序变为警告而不是错误的开关。
- 类型：
布尔值
- 默认值：
True- Ini：
- 部分：
[defaults]
- 键：
error_on_missing_handler
- 环境：
FACTS_MODULES
- 描述：
在 Play 的信息收集阶段要运行的模块，使用默认值“smart”将尝试根据连接类型确定要运行的模块。如果添加了自己的模块，但您仍然想使用默认的 Ansible 信息，则需要将“setup”或相应的网络模块添加到列表中（如果添加“smart”，Ansible 也会确定要运行的模块）。这不会影响对“setup”模块的显式调用，但始终会影响“gather_facts”操作（隐式或显式）。
- 类型：
列表
- 默认值：
['smart']- Ini：
- 部分：
[defaults]
- 键：
facts_modules
- 环境：
- 变量：
- 名称：
ansible_facts_modules
GALAXY_CACHE_DIR
- 描述：
存储 Galaxy 服务器缓存响应的目录。这仅由
ansible-galaxy collection install和download命令使用。如果此目录中的缓存文件可供所有人写入，则将忽略这些文件。- 类型：
路径
- 默认值：
{{ ANSIBLE_HOME ~ "/galaxy_cache" }}- 版本添加：
2.11
- Ini：
- 部分：
[galaxy]
- 键：
cache_dir
- 环境：
GALAXY_COLLECTION_SKELETON
- 描述：
用作
ansible-galaxy collection中init操作模板的集合框架目录，与--collection-skeleton相同。- 类型：
路径
- Ini：
- 部分：
[galaxy]
- 键：
collection_skeleton
- 环境：
GALAXY_COLLECTION_SKELETON_IGNORE
- 描述：
Galaxy 集合框架目录中要忽略的文件模式。
- 类型：
列表
- 默认值：
['^.git$', '^.*/.git_keep$']- Ini：
- 部分：
[galaxy]
- 键：
collection_skeleton_ignore
- 环境：
GALAXY_COLLECTIONS_PATH_WARNING
- 描述：
是否
ansible-galaxy collection install应该警告配置的 COLLECTIONS_PATHS 中缺少--collections-path。- 类型：
布尔值
- 默认值：
True- 版本添加：
2.16
- Ini：
- 部分：
[galaxy]
- 键：
collections_path_warning
- 环境：
GALAXY_DISABLE_GPG_VERIFY
- 描述：
在集合安装过程中禁用 GPG 签名验证。
- 类型：
布尔值
- 默认值：
False- 版本添加：
2.13
- Ini：
- 部分：
[galaxy]
- 键：
disable_gpg_verify
- 环境：
GALAXY_DISPLAY_PROGRESS
- 描述：
ansible-galaxy中的某些步骤会显示一个进度轮，这在某些显示器上或将标准输出输出到文件时可能会导致问题。此配置选项控制是否显示进度轮。默认情况下，如果标准输出具有 tty，则显示进度轮。- 类型：
布尔值
- 默认值：
无- 版本添加：
2.10
- Ini：
- 部分：
[galaxy]
- 键：
display_progress
- 环境：
GALAXY_GPG_KEYRING
- 描述：
配置在集合安装和验证期间用于 GPG 签名验证的密钥环。
- 类型：
路径
- 版本添加：
2.13
- Ini：
- 部分：
[galaxy]
- 键：
gpg_keyring
- 环境：
GALAXY_IGNORE_CERTS
- 描述：
如果设置为 yes，则 ansible-galaxy 将不会验证 TLS 证书。这对于针对具有自签名证书的服务器进行测试非常有用。
- 类型：
布尔值
- Ini：
- 部分：
[galaxy]
- 键：
ignore_certs
- 环境：
GALAXY_IGNORE_INVALID_SIGNATURE_STATUS_CODES
- 描述：
在 GPG 签名验证期间要忽略的 GPG 状态代码列表。有关状态代码说明，请参阅 L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes)。如果成功验证集合的签名数量少于 GALAXY_REQUIRED_VALID_SIGNATURE_COUNT，则即使忽略了所有错误代码，签名验证也会失败。
- 类型：
列表
- 选项：
EXPSIG
EXPKEYSIG
REVKEYSIG
BADSIG
ERRSIG
NO_PUBKEY
MISSING_PASSPHRASE
BAD_PASSPHRASE
NODATA
UNEXPECTED
ERROR
FAILURE
BADARMOR
KEYEXPIRED
KEYREVOKED
NO_SECKEY
- Ini：
- 部分：
[galaxy]
- 键：
ignore_signature_status_codes
- 环境：
GALAXY_REQUIRED_VALID_SIGNATURE_COUNT
- 描述：
在安装或验证 Collection 时，GPG 签名验证期间必须成功的签名数量。这应该是一个正整数或 all，表示所有签名都必须成功验证 Collection。在值前面加上 + 表示如果没有找到 Collection 的有效签名，则失败。
- 类型：
字符串
- 默认值：
1- Ini：
- 部分：
[galaxy]
- 键：
required_valid_signature_count
- 环境：
GALAXY_ROLE_SKELETON
- 描述：
角色框架目录，用作
ansible-galaxy/ansible-galaxy role中init操作的模板，与--role-skeleton相同。- 类型：
路径
- Ini：
- 部分：
[galaxy]
- 键：
role_skeleton
- 环境：
GALAXY_ROLE_SKELETON_IGNORE
- 描述：
在 Galaxy 角色或 Collection 框架目录中要忽略的文件模式。
- 类型：
列表
- 默认值：
['^.git$', '^.*/.git_keep$']- Ini：
- 部分：
[galaxy]
- 键：
role_skeleton_ignore
- 环境：
GALAXY_SERVER
- 描述：
当角色未指定完整 URI 时要添加的 URL 前缀，假设它们引用此服务器作为源。
- 默认值：
https://galaxy.ansible.com- Ini：
- 部分：
[galaxy]
- 键：
server
- 环境：
GALAXY_SERVER_LIST
- 描述：
安装 Collection 时要使用的 Galaxy 服务器列表。该值对应于配置 ini 标题
[galaxy_server.{{item}}]，该标题定义了服务器详细信息。有关如何定义 Galaxy 服务器的更多详细信息，请参阅配置 ansible-galaxy 客户端。此列表中服务器的顺序用作解析 Collection 的顺序。设置此配置选项将忽略 GALAXY_SERVER 配置选项。- 类型：
列表
- 版本添加：
2.9
- Ini：
- 部分：
[galaxy]
- 键：
server_list
- 环境：
GALAXY_SERVER_TIMEOUT
- 描述：
Galaxy API 调用的默认超时。未配置特定超时的 Galaxy 服务器将回退到此值。
- 类型：
int
- 默认值：
60- Ini：
- 部分：
[galaxy]
- 键：
server_timeout
- 环境：
GALAXY_TOKEN_PATH
- 描述：
Galaxy 访问令牌文件的本地路径
- 类型：
路径
- 默认值：
{{ ANSIBLE_HOME ~ "/galaxy_token" }}- 版本添加：
2.9
- Ini：
- 部分：
[galaxy]
- 键：
token_path
- 环境：
HOST_KEY_CHECKING
- 描述：
如果要避免 Ansible 用来连接到主机的底层连接插件检查主机密钥，请将其设置为“False”。有关详细信息，请阅读所用特定连接插件的文档。
- 类型：
布尔值
- 默认值：
True- Ini：
- 部分：
[defaults]
- 键：
host_key_checking
- 环境：
HOST_PATTERN_MISMATCH
- 描述：
此设置更改了不匹配主机模式的行为，它允许您强制执行致命错误、警告或只是忽略它。
- 默认值：
警告- 选项：
- error：
发出“致命”错误并停止运行
- warning：
发出警告但继续运行
- ignore：
只是默默地继续
- 版本添加：
2.8
- Ini：
- 部分：
[inventory]
- 键：
host_pattern_mismatch
- 环境：
INJECT_FACTS_AS_VARS
- 描述：
事实在 ansible_facts 变量中可用，此设置还将它们作为自己的变量推送到主命名空间中。与 ansible_facts 字典中从事实名称中删除前缀 ansible_ 不同，这些变量将具有模块返回的确切名称。
- 类型：
布尔值
- 默认值：
True- 版本添加：
2.5
- Ini：
- 部分：
[defaults]
- 键：
inject_facts_as_vars
- 环境：
INTERPRETER_PYTHON
- 描述：
用于在远程目标上执行模块的 Python 解释器的路径，或自动发现模式。支持的发现模式有
auto（默认）、auto_silent、auto_legacy和auto_legacy_silent。所有发现模式都使用查找表来使用包含的系统 Python（在已知包含的發行版上），如果平台特定的默认值不可用，则回退到固定排序的已知 Python 解释器位置列表。回退行为将发出警告，表明应显式设置解释器（因为稍后安装的解释器可能会更改正在使用的解释器）。可以通过设置auto_silent或auto_legacy_silent来禁用此警告行为。auto_legacy的值提供所有相同行为，但为了向后兼容始终默认为/usr/bin/python的旧 Ansible 版本，如果存在，将使用该解释器。- 默认值：
auto- 版本添加：
2.8
- Ini：
- 部分：
[defaults]
- 键：
interpreter_python
- 环境：
- 变量：
- 名称：
ansible_python_interpreter
INTERPRETER_PYTHON_FALLBACK
- 类型：
列表
- 默认值：
['python3.13', 'python3.12', 'python3.11', 'python3.10', 'python3.9', 'python3.8', '/usr/bin/python3', 'python3']- 版本添加：
2.8
- 变量：
- 名称：
ansible_interpreter_python_fallback
INVALID_TASK_ATTRIBUTE_FAILED
- 描述：
如果为“false”，则任务的无效属性将导致警告而不是错误。
- 类型：
布尔值
- 默认值：
True- 版本添加：
2.7
- Ini：
- 部分：
[defaults]
- 键：
invalid_task_attribute_failed
- 环境：
INVENTORY_ANY_UNPARSED_IS_FAILED
- 描述：
如果为“true”，则当任何给定的清单源无法被任何可用的清单插件成功解析时，这是一个致命错误；否则，这种情况只会引起警告。
- 类型：
布尔值
- 默认值：
False- 版本添加：
2.7
- Ini：
- 部分：
[inventory]
- 键：
any_unparsed_is_failed
- 环境：
INVENTORY_CACHE_ENABLED
- 描述：
切换以启用清单缓存。此设置已作为插件选项移至各个清单插件 清单插件。仍然接受现有的配置设置，清单插件从清单配置中添加了其他选项。此消息将在 2.16 中删除。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[inventory]
- 键：
cache
- 环境：
INVENTORY_CACHE_PLUGIN
- 描述：
用于缓存清单的插件。此设置已作为插件选项移至各个清单插件 清单插件。仍然接受现有的配置设置，清单插件从清单和事实缓存配置中添加了其他选项。此消息将在 2.16 中删除。
- Ini：
- 部分：
[inventory]
- 键：
cache_plugin
- 环境：
INVENTORY_CACHE_PLUGIN_CONNECTION
- 描述：
清单缓存连接。此设置已作为插件选项移至各个清单插件 清单插件。仍然接受现有的配置设置，清单插件从清单和事实缓存配置中添加了其他选项。此消息将在 2.16 中删除。
- Ini：
- 部分：
[inventory]
- 键：
cache_connection
- 环境：
INVENTORY_CACHE_PLUGIN_PREFIX
- 描述：
缓存插件的表前缀。此设置已作为插件选项移至各个清单插件 清单插件。仍然接受现有的配置设置，清单插件从清单和事实缓存配置中添加了其他选项。此消息将在 2.16 中删除。
- 默认值：
ansible_inventory_- Ini：
- 部分：
[inventory]
- 键：
cache_prefix
- 环境：
INVENTORY_CACHE_TIMEOUT
- 描述：
清单缓存插件数据的过期超时。此设置已作为插件选项移至各个清单插件 清单插件。仍然接受现有的配置设置，清单插件从清单和事实缓存配置中添加了其他选项。此消息将在 2.16 中删除。
- 默认值：
3600- Ini：
- 部分：
[inventory]
- 键：
cache_timeout
- 环境：
INVENTORY_ENABLED
- 描述：
已启用的清单插件列表，它还确定了它们的使用顺序。
- 类型：
列表
- 默认值：
['host_list', 'script', 'auto', 'yaml', 'ini', 'toml']- Ini：
- 部分：
[inventory]
- 键：
enable_plugins
- 环境：
INVENTORY_EXPORT
- 描述：
控制 ansible-inventory 是准确反映 Ansible 对清单的视图，还是对其进行优化以供导出。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[inventory]
- 键：
export
- 环境：
INVENTORY_IGNORE_EXTS
- 描述：
使用目录作为清单源时要忽略的扩展名列表。
- 类型：
列表
- 默认值：
{{(REJECT_EXTS + ('.orig', '.ini', '.cfg', '.retry'))}}- Ini：
- 部分：
[defaults]
- 键：
inventory_ignore_extensions
- 部分：
[inventory]
- 键：
ignore_extensions
- 环境：
INVENTORY_IGNORE_PATTERNS
- 描述：
使用目录作为清单源时要忽略的模式列表。
- 类型：
列表
- 默认值：
[]- Ini：
- 部分：
[defaults]
- 键：
inventory_ignore_patterns
- 部分：
[inventory]
- 键：
ignore_patterns
- 环境：
INVENTORY_UNPARSED_IS_FAILED
- 描述：
如果为“true”，则如果每个潜在的清单源都无法解析，则这是一个致命错误，否则，这种情况只会引发警告。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[inventory]
- 键：
unparsed_is_failed
- 环境：
INVENTORY_UNPARSED_WARNING
- 描述：
默认情况下，当没有加载任何清单时，Ansible 会发出警告，并说明它将使用隐式的仅限本地主机的清单。可以通过将此设置调整为 False 来禁用这些警告。
- 类型：
布尔值
- 默认值：
True- 版本添加：
2.14
- Ini：
- 部分：
[inventory]
- 键：
inventory_unparsed_warning
- 环境：
LOCALHOST_WARNING
- 描述：
默认情况下，当清单中没有主机时，Ansible 会发出警告。可以通过将此设置调整为 False 来禁用这些警告。
- 类型：
布尔值
- 默认值：
True- 版本添加：
2.6
- Ini：
- 部分：
[defaults]
- 键：
localhost_warning
- 环境：
LOG_VERBOSITY
- 描述：
如果此值高于正常的显示详细程度，则将设置日志详细程度，否则将与其匹配。
- 类型：
int
- 版本添加：
2.17
- Ini：
- 部分：
[defaults]
- 键：
log_verbosity
- 环境：
MAX_FILE_SIZE_FOR_DIFF
- 描述：
要考虑进行差异显示的文件的最大大小。
- 类型：
int
- 默认值：
104448- Ini：
- 部分：
[defaults]
- 键：
max_diff_size
- 环境：
MODULE_IGNORE_EXTS
- 描述：
查找要加载的模块时要忽略的扩展名列表。这是为了拒绝脚本和二进制模块回退扩展。
- 类型：
列表
- 默认值：
{{(REJECT_EXTS + ('.yaml', '.yml', '.ini'))}}- Ini：
- 部分：
[defaults]
- 键：
module_ignore_exts
- 环境：
MODULE_STRICT_UTF8_RESPONSE
- 描述：
启用后，将评估模块响应是否包含非 UTF-8 数据。禁用此选项可能会导致意外行为。只有 ansible-core 应该评估此配置。
- 类型：
布尔值
- 默认值：
True- Ini：
- 部分：
[defaults]
- 键：
module_strict_utf8_response
- 环境：
NETCONF_SSH_CONFIG
- 描述：
此变量用于通过 netconf 连接启用堡垒机/跳转主机。如果设置为 True，则堡垒机/跳转主机的 ssh 设置应该存在于 ~/.ssh/config 文件中，或者可以将其设置为自定义 ssh 配置文件路径以读取堡垒机/跳转主机的设置。
- 默认值：
无- Ini：
- 部分：
[netconf_connection]
- 键：
ssh_config
- 环境：
NETWORK_GROUP_MODULES
- 类型：
列表
- 默认值：
['eos', 'nxos', 'ios', 'iosxr', 'junos', 'enos', 'ce', 'vyos', 'sros', 'dellos9', 'dellos10', 'dellos6', 'asa', 'aruba', 'aireos', 'bigip', 'ironware', 'onyx', 'netconf', 'exos', 'voss', 'slxos']- Ini：
- 部分：
[defaults]
- 键：
network_group_modules
- 环境：
OLD_PLUGIN_CACHE_CLEARING
- 描述：
以前，Ansible 只会在加载新角色时清除一些插件加载缓存，这导致在之前剧本中加载的插件会意外地“粘连”。此设置允许用户返回到该行为。
- 类型：
布尔值
- 默认值：
False- 版本添加：
2.8
- Ini：
- 部分：
[defaults]
- 键：
old_plugin_cache_clear
- 环境：
PAGER
- 描述：
对于 Ansible 需要以分页方式返回输出的情况，可以选择要使用的应用程序。
- 默认值：
less- Ini：
- 部分：
[defaults]
- 键：
pager :版本新增：2.15
- 环境：
- 变量：
- 版本添加：
2.15
- 变量：
PARAMIKO_HOST_KEY_AUTO_ADD
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[paramiko_connection]
- 键：
host_key_auto_add
- 环境：
- 已弃用：
2.20
- 已弃用详细信息：
此选项已移至插件本身
- 已弃用的替代方案:
使用插件本身的选项。
PARAMIKO_LOOK_FOR_KEYS
- 类型：
布尔值
- 默认值：
True- Ini：
- 部分：
[paramiko_connection]
- 键：
look_for_keys
- 环境：
- 已弃用：
2.20
- 已弃用详细信息：
此选项已移至插件本身
- 已弃用的替代方案:
使用插件本身的选项。
PERSISTENT_COMMAND_TIMEOUT
- 描述：
这控制在使持久连接超时之前等待远程设备响应的时间。
- 类型：
int
- 默认值：
30- Ini：
- 部分：
[persistent_connection]
- 键：
command_timeout
- 环境：
PERSISTENT_CONNECT_RETRY_TIMEOUT
- 描述：
这控制持久连接连接到本地域套接字的重试超时。
- 类型：
整数
- 默认值：
15- Ini：
- 部分：
[persistent_connection]
- 键：
connect_retry_timeout
- 环境：
PERSISTENT_CONNECT_TIMEOUT
- 描述：
这控制持久连接在被销毁之前保持空闲的时间。
- 类型：
整数
- 默认值：
30- Ini：
- 部分：
[persistent_connection]
- 键：
connect_timeout
- 环境：
PERSISTENT_CONTROL_PATH_DIR
- 描述：
连接持久性系统要使用的套接字的路径。
- 类型：
路径
- 默认值：
{{ ANSIBLE_HOME ~ "/pc" }}- Ini：
- 部分：
[persistent_connection]
- 键：
control_path_dir
- 环境：
PLAYBOOK_DIR
- 描述：
许多非剧本 CLI 都有一个
--playbook-dir参数；这将设置其默认值。- 类型：
路径
- 版本添加：
2.9
- Ini：
- 部分：
[defaults]
- 键：
playbook_dir
- 环境：
PLAYBOOK_VARS_ROOT
- 描述：
这将设置哪些剧本目录将用作处理 vars 插件的根目录，包括查找 host_vars/group_vars。
- 默认值：
top- 选项：
- top:
遵循使用链中的顶级剧本查找根目录的传统行为。
- bottom:
遵循使用当前剧本查找根目录的 2.4.0 行为。
- all:
从第一个父级到当前剧本进行检查。
- 版本添加：
2.4.1
- Ini：
- 部分：
[defaults]
- 键：
playbook_vars_root
- 环境：
PLUGIN_FILTERS_CFG
- 描述：
用于过滤允许使用系统上安装的哪些插件的配置的路径。有关筛选器文件格式的详细信息，请参阅 拒绝模块。默认值为 /etc/ansible/plugin_filters.yml
- 类型：
路径
- 默认值：
无- 版本添加：
2.5.0
- Ini：
- 部分：
[defaults]
- 键：
plugin_filters_cfg
PYTHON_MODULE_RLIMIT_NOFILE
- 描述：
尝试在执行 Python 模块时将 RLIMIT_NOFILE 软限制设置为指定的值（可以加快 Python 2.x 上子进程的使用。请参阅 https://bugs.python.org/issue11284）。该值将受到现有硬限制的限制。默认值 0 不会尝试调整现有的系统定义限制。
- 默认值：
0- 版本添加：
2.8
- Ini：
- 部分：
[defaults]
- 键：
python_module_rlimit_nofile
- 环境：
- 变量：
- 名称：
ansible_python_module_rlimit_nofile
RETRY_FILES_ENABLED
- 描述：
这控制失败的 Ansible 剧本是否应创建 .retry 文件。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
retry_files_enabled
- 环境：
RETRY_FILES_SAVE_PATH
- 描述：
此选项设置当 playbook 失败且启用了重试文件时 Ansible 保存 .retry 文件的路径。每次运行后，此文件将被所有 play 中失败主机的列表覆盖。
- 类型：
路径
- 默认值：
无- Ini：
- 部分：
[defaults]
- 键：
retry_files_save_path
- 环境：
RUN_VARS_PLUGINS
- 描述：
此设置可用于根据用户清单大小和 play 选择优化 vars_plugin 的使用。
- 类型：
字符串
- 默认值：
demand- 选项：
- demand：
每当任务“需要”vars 时，将运行与清单源相关的 vars_plugins。
- start：
导入清单源后，将运行与清单源相关的 vars_plugins。
- 版本添加：
2.10
- Ini：
- 部分：
[defaults]
- 键：
run_vars_plugins
- 环境：
SHOW_CUSTOM_STATS
- 描述：
这会将通过 set_stats 插件设置的自定义统计信息添加到默认输出中。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
show_custom_stats
- 环境：
STRING_CONVERSION_ACTION
- 描述：
当模块参数值转换为字符串时要采取的操作（这不影响变量）。 对于字符串参数，诸如“1.00”、“[‘a’, ‘b’,]”和“yes”、“y”等值将由 YAML 解析器转换，除非完全用引号引起来。 有效选项为“error”、“warn”和“ignore”。 从 2.8 版本开始，此选项默认为“warn”，但在 2.12 版本中将更改为“error”。
- 类型：
字符串
- 默认值：
警告- 版本添加：
2.8
- Ini：
- 部分：
[defaults]
- 键：
string_conversion_action
- 环境：
- 已弃用：
2.19
- 已弃用详细信息：
此选项不再在 Ansible Core 代码库中使用。
- 已弃用的替代方案:
目前没有替代方案。 需要在当前代码库中实现不同的机制。
STRING_TYPE_FILTERS
- 描述：
此过滤器列表避免了在模板化变量时的“类型转换”。 例如，当您想避免将 JSON 字符串转换为列表或字典时，此选项非常有用。
- 类型：
列表
- 默认值：
['string', 'to_json', 'to_nice_json', 'to_yaml', 'to_nice_yaml', 'ppretty', 'json']- Ini：
- 部分：
[jinja2]
- 键：
dont_type_filters
- 环境：
SYSTEM_WARNINGS
- 描述：
允许禁用与运行 Ansible 本身的系统（而不是受管主机）上的潜在问题相关的警告。 这些警告可能包括有关第三方软件包或应尽可能解决的其他情况的警告。
- 类型：
布尔值
- 默认值：
True- Ini：
- 部分：
[defaults]
- 键：
system_warnings
- 环境：
TARGET_LOG_INFO
- 描述：
要插入到目标日志记录中以进行跟踪的字符串
- 版本添加：
2.17
- Ini：
- 部分：
[defaults]
- 键：
target_log_info
- 环境：
- 变量：
- 名称：
ansible_target_log_info
TASK_DEBUGGER_IGNORE_ERRORS
- 描述：
此选项定义在指定了 ignore_errors=True 时，是否在失败的任务上调用任务调试器。 True 指定调试器将遵循 ignore_errors，False 将不遵循 ignore_errors。
- 类型：
布尔值
- 默认值：
True- 版本添加：
2.7
- Ini：
- 部分：
[defaults]
- 键：
task_debugger_ignore_errors
- 环境：
TASK_TIMEOUT
- 描述：
设置任务操作执行的最长时间（以秒为单位）。 超时独立于模板化或循环运行。 它适用于每次尝试执行任务的操作，并且不会因任务花费的总时间而改变。 当操作执行超过超时时间时，Ansible 会中断该过程。 这被注册为由于外部情况导致的故障，而不是任务故障，以便接收适当的响应和恢复过程。 如果设置为 0（默认值），则表示没有超时。
- 类型：
整数
- 默认值：
0- 版本添加：
2.10
- Ini：
- 部分：
[defaults]
- 键：
task_timeout
- 环境：
TRANSFORM_INVALID_GROUP_CHARS
- 描述：
使 Ansible 转换清单源提供的组名中的无效字符。
- 类型：
字符串
- 默认值：
never- 选项：
- always：
它将用“_”（下划线）替换任何无效字符并警告用户
- never：
它将允许该组名，但会警告该问题
- ignore：
它的作用与“never”相同，但不发出警告
- silently：
它的作用与“always”相同，但不发出警告
- 版本添加：
2.8
- Ini：
- 部分：
[defaults]
- 键：
force_valid_group_names
- 环境：
USE_PERSISTENT_CONNECTIONS
- 描述：
切换是否对连接使用持久性。
- 类型：
布尔值
- 默认值：
False- Ini：
- 部分：
[defaults]
- 键：
use_persistent_connections
- 环境：
VALIDATE_ACTION_GROUP_METADATA
- 描述：
用于禁用验证集合的“metadata”条目以获取 module_defaults 操作组的切换。 当此值为 True 时，包含意外字段或值类型的元数据将产生警告。
- 类型：
布尔值
- 默认值：
True- 版本添加：
2.12
- Ini：
- 部分：
[defaults]
- 键：
validate_action_group_metadata
- 环境：
VARIABLE_PLUGINS_ENABLED
- 描述：
需要它的变量插件的接受列表。
- 类型：
列表
- 默认值：
['host_group_vars']- 版本添加：
2.10
- Ini：
- 部分：
[defaults]
- 键：
vars_plugins_enabled
- 环境：
VARIABLE_PRECEDENCE
- 描述：
允许更改组变量优先级合并顺序。
- 类型：
列表
- 默认值：
['all_inventory', 'groups_inventory', 'all_plugins_inventory', 'all_plugins_play', 'groups_plugins_inventory', 'groups_plugins_play']- 版本添加：
2.4
- Ini：
- 部分：
[defaults]
- 键：
precedence
- 环境：
VAULT_ENCRYPT_SALT
- 描述：
用于保险库加密的盐。 如果未提供，将使用随机盐。
- 默认值：
无- 版本添加：
2.15
- Ini：
- 部分：
[defaults]
- 键：
vault_encrypt_salt
- 环境：
VERBOSE_TO_STDERR
- 描述：
强制“verbose”选项使用 stderr 而不是 stdout
- 类型：
布尔值
- 默认值：
False- 版本添加：
2.8
- Ini：
- 部分：
[defaults]
- 键：
verbose_to_stderr
- 环境：
WIN_ASYNC_STARTUP_TIMEOUT
- 描述：
对于 Ansible 中的异步任务（在“异步操作和轮询”中介绍），这是在 Windows 系统上等待 Ansible 生成的任务连接回所使用的命名管道的时间（以秒为单位）。 默认值为 5 秒。 在速度较慢的系统或负载较重的系统上，此值可能过低。 这不是异步命令可以运行的总时间，而是一个单独的超时时间，用于等待异步命令启动。 只有当任务连接到管道后才会开始计时，因此任务可以使用的总最长时间将延长此处指定的时间。
- 类型：
整数
- 默认值：
5- 版本添加：
2.10
- Ini：
- 部分：
[defaults]
- 键：
win_async_startup_timeout
- 环境：
- 变量：
- 名称：
ansible_win_async_startup_timeout
WORKER_SHUTDOWN_POLL_COUNT
- 描述：
检查任务队列管理器工作进程以验证它们是否已干净退出的最大次数。 超过此限制后，任何仍在运行的工作进程都将被终止。 这仅供内部使用。
- 类型：
整数
- 默认值：
0- 版本添加：
2.10
- 环境：
WORKER_SHUTDOWN_POLL_DELAY
- 描述：
在检查任务队列管理器工作进程以验证它们是否已干净退出时，轮询循环之间休眠的秒数。 这仅供内部使用。
- 类型：
浮点数
- 默认值：
0.1- 版本添加：
2.10
- 环境：
YAML_FILENAME_EXTENSIONS
- 描述：
在查找应该是 YAML 或 JSON 或其加密版本的“变量”文件时，请检查所有这些扩展名。 这会影响 vars_files、include_vars、清单和 vars 插件等。
- 类型：
列表
- 默认值：
['.yml', '.yaml', '.json']- Ini：
- 部分：
[defaults]
- 键：
yaml_valid_extensions
- 环境：
环境变量
有关配置集合中插件的其他环境变量，请参阅所有集合环境变量索引。
- ANSIBLE_CONFIG
覆盖默认的 Ansible 配置文件
- ANSIBLE_HOME
控制器上 Ansible 配置文件的默认根路径。
另请参阅ANSIBLE_HOME
- ANSIBLE_CONNECTION_PATH
指定在何处查找 ansible-connection 脚本。在搜索 $PATH 之前，将检查此位置。如果为空，Ansible 将从与 Ansible 脚本相同的目录开始。
- ANSIBLE_COW_SELECTION
这允许您为横幅选择特定的 cowsay 模板，或使用“随机”循环浏览它们。
- ANSIBLE_COW_ACCEPTLIST
接受一个“安全”的 cowsay 模板列表，如果要启用所有已安装的模板，请将其设置为空列表。
- 版本添加：
2.11
- ANSIBLE_FORCE_COLOR
即使在没有 TTY 运行或“nocolor”设置 为 True 时，此选项也会强制使用颜色模式。
- ANSIBLE_NOCOLOR
此设置允许禁止对输出进行着色，着色用于更好地指示失败和状态信息。
另请参阅ANSIBLE_NOCOLOR
- NO_COLOR
此设置允许禁止对输出进行着色，着色用于更好地指示失败和状态信息。
另请参阅ANSIBLE_NOCOLOR
- 版本添加：
2.11
- ANSIBLE_NOCOWS
如果您安装了 cowsay 但想避免“cows”（为什么？？？？），请使用此选项。
另请参阅ANSIBLE_NOCOWS
- ANSIBLE_COW_PATH
指定自定义 cowsay 路径或换入您选择的 cowsay 实现。
另请参阅ANSIBLE_COW_PATH
- ANSIBLE_PIPELINING
这是一个全局选项，每个连接插件都可以通过具有更具体的选项或根本不支持流水线来覆盖它。如果连接插件支持流水线，则可以通过执行许多 Ansible 模块而无需实际文件传输，从而减少在远程服务器上执行模块所需网络操作的数量。启用后，可以显著提高性能。但这与权限提升 (become) 冲突。例如，当使用“sudo:”操作时，您必须首先在所有受管主机的 /etc/sudoers 中禁用“requiretty”，这就是默认禁用它的原因。如果启用了
ANSIBLE_KEEP_REMOTE_FILES，则此设置将被禁用。
- ANSIBLE_ANY_ERRORS_FATAL
设置 any_errors_fatal 关键字的默认值，如果为 True，则任务失败将被视为致命错误。
另请参阅ANY_ERRORS_FATAL
- ANSIBLE_BECOME_ALLOW_SAME_USER
如果
False``（默认）， 则如果远程用户与 become 用户相同，Ansible 将跳过使用 become，因为这通常是一个冗余操作。换句话说，root sudo 到 root。如果 ``True，则强制 Ansible 使用 become 插件，因为在某些情况下需要这样做。
- ANSIBLE_BECOME_PASSWORD_FILE
用于 become 插件的密码文件。
--become-password-file。如果可执行，它将被运行，并且生成的 stdout 将用作密码。
- ANSIBLE_AGNOSTIC_BECOME_PROMPT
显示一个不可知的 become 提示，而不是显示一个包含命令行提供的 become 方法的提示。
- ANSIBLE_CACHE_PLUGIN
选择要使用的缓存插件，默认的“内存”是短暂的。
另请参阅CACHE_PLUGIN
- ANSIBLE_CACHE_PLUGIN_CONNECTION
定义缓存插件的连接或路径信息。
- ANSIBLE_CACHE_PLUGIN_PREFIX
用于缓存插件文件/表的。前缀。
- ANSIBLE_CACHE_PLUGIN_TIMEOUT
缓存插件数据的过期超时。
- ANSIBLE_COLLECTIONS_SCAN_SYS_PATH
一个布尔值，用于启用或禁用扫描 sys.path 以查找已安装的 collection。
- ANSIBLE_COLLECTIONS_PATHS
Ansible 将在其中搜索 collection 内容的路径，以冒号分隔。Collection 必须位于嵌套的*子目录*中，而不能直接位于这些目录中。例如，如果
COLLECTIONS_PATHS包含'{{ ANSIBLE_HOME ~ "/collections" }}'，并且您想将my.collection添加到该目录，则必须将其保存为'{{ ANSIBLE_HOME} ~ "/collections/ansible_collections/my/collection" }}'。- 已弃用：
2.19
- 已弃用详细信息：
不符合变量命名标准，请改用单数形式 ANSIBLE_COLLECTIONS_PATH
- ANSIBLE_COLLECTIONS_PATH
Ansible 将在其中搜索 collection 内容的路径，以冒号分隔。Collection 必须位于嵌套的*子目录*中，而不能直接位于这些目录中。例如，如果
COLLECTIONS_PATHS包含'{{ ANSIBLE_HOME ~ "/collections" }}'，并且您想将my.collection添加到该目录，则必须将其保存为'{{ ANSIBLE_HOME} ~ "/collections/ansible_collections/my/collection" }}'。- 版本添加：
2.10
- ANSIBLE_COLLECTIONS_ON_ANSIBLE_VERSION_MISMATCH
当加载的 collection 不支持正在运行的 Ansible 版本时（使用 collection 元数据键 requires_ansible）。
- ANSIBLE_COLOR_CHANGED
定义用于“已更改”任务状态的颜色。
另请参阅COLOR_CHANGED
- ANSIBLE_COLOR_CONSOLE_PROMPT
定义用于 ansible-console 的默认颜色。
- ANSIBLE_COLOR_DEBUG
定义发出调试消息时使用的颜色。
另请参阅COLOR_DEBUG
- ANSIBLE_COLOR_DEPRECATE
定义发出弃用消息时使用的颜色。
另请参阅COLOR_DEPRECATE
- ANSIBLE_COLOR_DIFF_ADD
定义在差异中显示添加的行时使用的颜色。
另请参阅COLOR_DIFF_ADD
- ANSIBLE_COLOR_DIFF_LINES
定义显示差异时使用的颜色。
另请参阅COLOR_DIFF_LINES
- ANSIBLE_COLOR_DIFF_REMOVE
定义在差异中显示删除的行时使用的颜色。
- ANSIBLE_COLOR_ERROR
定义发出错误消息时使用的颜色。
另请参阅COLOR_ERROR
- ANSIBLE_COLOR_HIGHLIGHT
定义用于高亮的顏色。
另请参阅COLOR_HIGHLIGHT
- ANSIBLE_COLOR_INCLUDED
定义显示“已包含”任务状态时使用的颜色。
另请参阅COLOR_INCLUDED
- ANSIBLE_COLOR_SKIP
定义显示“已跳过”任务状态时使用的颜色。
另请参阅COLOR_SKIP
- ANSIBLE_COLOR_UNREACHABLE
定义“不可达”状态时使用的颜色。
- ANSIBLE_COLOR_VERBOSE
定义发出详细消息时使用的颜色。换句话说，就是那些用“-v”显示的消息。
另请参阅COLOR_VERBOSE
- ANSIBLE_COLOR_WARN
定义发出警告消息时使用的颜色。
另请参阅COLOR_WARN
- ANSIBLE_COLOR_DOC_MODULE
定义在 ansible-doc 输出中发出模块名称时使用的颜色。
另请参阅COLOR_DOC_MODULE
- ANSIBLE_COLOR_DOC_REFERENCE
定义在 ansible-doc 输出中发出交叉引用时使用的颜色。
- ANSIBLE_COLOR_DOC_LINK
定义在 ansible-doc 输出中发出链接时使用的颜色。
另请参阅COLOR_DOC_LINK
- ANSIBLE_COLOR_DOC_DEPRECATED
定义在 ansible-doc 输出中发出已弃用值时使用的颜色。
- ANSIBLE_COLOR_DOC_CONSTANT
定义在 ansible-doc 输出中发出常量时使用的颜色。
- ANSIBLE_COLOR_DOC_PLUGIN
定义在 ansible-doc 输出中发出插件名称时使用的颜色。
- ANSIBLE_CONNECTION_PASSWORD_FILE
用于连接插件的密码文件。
--connection-password-file。
- _ANSIBLE_COVERAGE_REMOTE_OUTPUT
设置远程主机上生成覆盖率报告的输出目录。目前仅用于 PowerShell 模块的远程覆盖率。这仅供内部使用。
- _ANSIBLE_COVERAGE_REMOTE_PATH_FILTER
在远程主机上执行时，Ansible 控制器上要运行覆盖率的文件路径列表。只有匹配路径通配符的文件才会收集其覆盖率。可以指定多个路径通配符，并用
:分隔。目前仅用于 PowerShell 模块的远程覆盖率。这仅供内部使用。
- ANSIBLE_ACTION_WARNINGS
默认情况下，Ansible 在从任务操作（模块或操作插件）接收到警告时会发出警告。可以通过将此设置调整为 False 来禁用这些警告。
- ANSIBLE_LOCALHOST_WARNING
默认情况下，当清单中没有主机时，Ansible 会发出警告。可以通过将此设置调整为 False 来禁用这些警告。
- ANSIBLE_LOG_VERBOSITY
如果此值高于正常的显示详细程度，则将设置日志详细程度，否则将与其匹配。
- ANSIBLE_INVENTORY_UNPARSED_WARNING
默认情况下，当未加载任何清单时，Ansible 会发出警告，并说明它将使用隐式仅限本地主机的清单。可以通过将此设置调整为 False 来禁用这些警告。
- ANSIBLE_DOC_FRAGMENT_PLUGINS
Ansible 在其中搜索文档片段插件的路径，以冒号分隔。
- ANSIBLE_ACTION_PLUGINS
Ansible 将在其中搜索操作插件的以冒号分隔的路径。
- ANSIBLE_ASK_PASS
这控制 Ansible playbook 是否应提示输入登录密码。如果使用 SSH 密钥进行身份验证，则您可能不需要更改此设置。
- ANSIBLE_ASK_VAULT_PASS
这控制 Ansible playbook 是否应提示输入保管库密码。
- ANSIBLE_BECOME
切换权限提升的使用，允许您在登录后“成为”另一个用户。
- ANSIBLE_BECOME_ASK_PASS
切换以提示输入权限提升密码。
- ANSIBLE_BECOME_METHOD
启用 become 时要使用的权限提升方法。
- ANSIBLE_BECOME_EXE
用于权限提升的可执行文件，否则 Ansible 将依赖于 PATH。
- ANSIBLE_BECOME_FLAGS
传递给权限提升可执行文件的标志。
- ANSIBLE_BECOME_PLUGINS
Ansible 将在其中搜索 Become 插件的冒号分隔路径。
- ANSIBLE_BECOME_USER
使用权限提升时，您的登录/远程用户“成为”的用户，大多数系统在未指定用户时将使用“root”。
- ANSIBLE_CACHE_PLUGINS
Ansible 将在其中搜索缓存插件的以冒号分隔的路径。
- ANSIBLE_CALLBACK_PLUGINS
Ansible 将在其中搜索回调插件的以冒号分隔的路径。
- ANSIBLE_CALLBACKS_ENABLED
已启用的回调列表，并非所有回调都需要启用，但 Ansible 附带的许多回调都需要启用，因为我们不希望默认情况下激活它们。
- 版本添加：
2.11
- ANSIBLE_CLICONF_PLUGINS
Ansible 将在其中搜索 Cliconf 插件的以冒号分隔的路径。
- ANSIBLE_CONNECTION_PLUGINS
Ansible 将在其中搜索连接插件的以冒号分隔的路径。
- ANSIBLE_DEBUG
在 Ansible 中切换调试输出。这将非常详细，并且可能会妨碍多处理。尽管已启用 no_log 设置，但调试输出也可能包含机密信息，这意味着调试模式不应在生产环境中使用。
- ANSIBLE_EXECUTABLE
这指示用于生成 shell 的命令，这是 Ansible 在目标上执行所需的操作。当 shell 使用受到限制时，用户可能需要在极少数情况下更改此设置，但在大多数情况下，可以保留原样。
- ANSIBLE_FILTER_PLUGINS
Ansible 将在其中搜索 Jinja2 过滤器插件的以冒号分隔的路径。
- ANSIBLE_FORCE_HANDLERS
此选项控制即使主机上发生故障，通知处理程序是否仍在该主机上运行。如果为 false，则如果主机上发生故障，处理程序将不会运行。这也可以按剧本设置或在命令行上设置。有关更多详细信息，请参阅处理程序和故障。
- ANSIBLE_FORKS
Ansible 用于在目标主机上执行任务的最大分支数。
- ANSIBLE_GATHERING
此设置控制事实收集（关于远程系统发现的事实）的默认策略。此选项对那些希望节省事实收集时间的人很有用。“smart”和“explicit”都将使用缓存插件。
- ANSIBLE_HASH_BEHAVIOUR
此设置控制如何在 Ansible 中处理字典变量（也称为哈希、映射、关联数组）的重复定义。这不影响值为标量（整数、字符串）或数组的变量。**警告**，不建议更改此设置，因为这很脆弱，并且会使您的内容（剧本、角色、集合）不可移植，导致持续的混乱和误用。除非您认为绝对需要，否则不要更改此设置。我们建议避免重复使用变量名，并依靠
combine过滤器以及vars和varnames查找来创建各个变量的合并版本。根据我们的经验，很少需要这样做，并且表明数据结构和剧本中引入了过多的复杂性。对于某些用途，您还可以研究自定义 vars_plugins 以在输入时合并，甚至替换负责解析host_vars/和group_vars/目录的默认host_group_vars。此设置的大多数用户只对清单范围感兴趣，但该设置本身会影响所有来源，并使调试更加困难。官方示例存储库中的所有剧本和角色都假定此设置的默认值。将设置更改为merge将应用于所有变量来源，但许多来源在内部仍将覆盖变量。例如，include_vars将在更新 Ansible 之前在内部对变量进行重复数据删除，其中“最后定义的”将覆盖同一文件中以前的定义。Ansible 项目建议您**避免对新项目使用 ``merge``。** Ansible 开发人员的目的是最终弃用和删除此设置，但由于某些用户确实严重依赖它，因此将保留该设置。新项目应**避免使用“merge”**。
- ANSIBLE_INVENTORY
Ansible 清单源的逗号分隔列表
- ANSIBLE_HTTPAPI_PLUGINS
Ansible 将在其中搜索 HttpApi 插件的路径（以冒号分隔）。
- ANSIBLE_INVENTORY_PLUGINS
Ansible 将在其中搜索清单插件的路径（以冒号分隔）。
- ANSIBLE_JINJA2_EXTENSIONS
这是一个特定于开发人员的功能，允许启用额外的 Jinja2 扩展。有关详细信息，请参阅 Jinja2 文档。如果您不知道这些是什么，您可能不需要更改此设置 :)
- ANSIBLE_JINJA2_NATIVE
此选项在模板操作期间保留变量类型。
- ANSIBLE_KEEP_REMOTE_FILES
启用/禁用清理 Ansible 用于在远程执行任务的临时文件。如果启用此选项，它将禁用
ANSIBLE_PIPELINING。
- ANSIBLE_LIBVIRT_LXC_NOSECLABEL
此设置通过将
--noseclabel参数传递给virsh命令来使 libvirt 连接到 LXC 容器。 这是在没有 SELinux 的系统上运行时所必需的。
- ANSIBLE_LOAD_CALLBACK_PLUGINS
控制在运行 /usr/bin/ansible 时是否加载回调插件。 这可用于记录来自命令行的活动、发送通知等。 始终为
ansible-playbook加载回调插件。
- ANSIBLE_LOCAL_TEMP
Ansible 在控制器上使用的临时目录。
另请参阅 DEFAULT_LOCAL_TMP
- ANSIBLE_LOG_PATH
Ansible 将在控制器上记录日志的文件。未设置时，日志记录将被禁用。
另请参阅 DEFAULT_LOG_PATH
- ANSIBLE_LOG_FILTER
要从日志文件中过滤掉的记录器名称列表。
另请参阅 DEFAULT_LOG_FILTER
- ANSIBLE_LOOKUP_PLUGINS
Ansible 将在其中搜索查找插件的路径（以冒号分隔）。
- ANSIBLE_MODULE_ARGS
如果未指定
-a，则设置要传递给ansibleadhoc 二进制文件的默认参数。另请参阅 DEFAULT_MODULE_ARGS
- ANSIBLE_LIBRARY
Ansible 将在其中搜索模块的路径（以冒号分隔）。
另请参阅 DEFAULT_MODULE_PATH
- ANSIBLE_MODULE_UTILS
Ansible 将在其中搜索模块实用程序文件的路径（以冒号分隔），这些文件由模块共享。
- ANSIBLE_NETCONF_PLUGINS
Ansible 将在其中搜索 Netconf 插件的路径（以冒号分隔）。
- ANSIBLE_NO_LOG
切换 Ansible 对任务详细信息的显示和记录，主要用于避免安全披露。
另请参阅 DEFAULT_NO_LOG
- ANSIBLE_NO_TARGET_SYSLOG
当 Ansible 在目标主机上执行任务时，切换是否记录日志到系统日志。在 Windows 主机上，这将禁用较新样式的 PowerShell 模块写入事件日志的功能。
- ANSIBLE_NULL_REPRESENTATION
模板应该返回什么作为“空”值。未设置时，将由 Jinja2 决定。
- ANSIBLE_POLL_INTERVAL
对于 Ansible 中的异步任务（在“异步操作和轮询”中介绍），这是在未提供明确的轮询间隔时，检查这些任务状态的频率。默认值为 15 秒，这是一个折衷方案，可以在频繁检查和在任务可能已完成时提供快速周转之间取得平衡。
- ANSIBLE_PRIVATE_KEY_FILE
对于使用证书或密钥文件进行身份验证而不是使用代理或密码的连接，您可以在此处设置默认值，以避免每次调用都重新指定
--private-key。
- ANSIBLE_PRIVATE_ROLE_VARS
默认情况下，导入的角色会将其变量发布到剧本和其他角色，此设置可以避免这种情况。引入此设置是为了在剧本中多次使用角色时将角色变量重置为默认值。从版本“2.17”开始，M(ansible.builtin.include_roles) 和 M(ansible.builtin.import_roles) 可以分别通过 C(public) 参数覆盖此设置。包含的角色仅在执行时公开其变量，这与在剧本编译时发生的导入角色不同。
- ANSIBLE_REMOTE_PORT
远程连接中使用的端口，为空时将使用连接插件的默认端口。
另请参阅 DEFAULT_REMOTE_PORT
- ANSIBLE_REMOTE_USER
设置目标机器的登录用户。为空白时，它使用连接插件的默认值，通常是当前正在执行 Ansible 的用户。
另请参阅 DEFAULT_REMOTE_USER
- ANSIBLE_ROLES_PATH
Ansible 搜索角色的以冒号分隔的路径列表。
另请参阅 DEFAULT_ROLES_PATH
- ANSIBLE_SELINUX_SPECIAL_FS
某些文件系统不支持安全操作和/或返回不一致的错误，此设置使 Ansible“容忍”列表中的那些文件系统，而不会导致致命错误。当文件系统在列表中时，可能会发生数据损坏，并且写入操作并不总是经过验证。
另请参阅 DEFAULT_SELINUX_SPECIAL_FS
- 版本添加：
2.9
- ANSIBLE_STDOUT_CALLBACK
设置用于显示 Ansible 输出的主回调。您一次只能拥有一个回调。您可以拥有许多其他回调，但只有一个可以负责标准输出。有关可用选项的列表，请参阅 回调插件。
- ANSIBLE_ENABLE_TASK_DEBUGGER
是否启用任务调试器，这以前是作为策略插件完成的。现在所有策略插件都可以继承此行为。默认情况下，当任务在不可达时失败时，调试器将被激活。使用调试器关键字可以获得更大的灵活性。
另请参阅 ENABLE_TASK_DEBUGGER
- ANSIBLE_TASK_DEBUGGER_IGNORE_ERRORS
此选项定义在指定 ignore_errors=True 时，是否在失败的任务上调用任务调试器。True 指定调试器将遵守 ignore_errors，而 False 将不遵守 ignore_errors。
- ANSIBLE_STRATEGY
设置用于剧本的默认策略。
另请参阅 DEFAULT_STRATEGY
- ANSIBLE_STRATEGY_PLUGINS
Ansible 搜索策略插件的以冒号分隔的路径列表。
- ANSIBLE_SU
切换是否对任务使用“su”。
另请参阅 DEFAULT_SU
- ANSIBLE_SYSLOG_FACILITY
当 Ansible 记录日志到远程目标时使用的系统日志工具。
- ANSIBLE_TERMINAL_PLUGINS
Ansible 搜索终端插件的以冒号分隔的路径列表。
- ANSIBLE_TEST_PLUGINS
Ansible 搜索 Jinja2 测试插件的以冒号分隔的路径列表。
- ANSIBLE_TIMEOUT
这是连接插件使用的默认超时时间。
另请参阅 DEFAULT_TIMEOUT
- ANSIBLE_TRANSPORT
可以是您的 Ansible 安装可用的任何连接插件。还有一个（已弃用）特殊的“智能”选项，它将根据控制器操作系统和 ssh 版本在“ssh”和“paramiko”之间切换。
另请参阅 DEFAULT_TRANSPORT
- ANSIBLE_ERROR_ON_UNDEFINED_VARS
如果为 True，则会导致 Ansible 模板化步骤失败，这些步骤引用了可能拼写错误的变量名。否则，任何包含未定义变量的“{{ template_expression }}”都将在模板或 Ansible 操作行中按原样呈现。
- ANSIBLE_VARS_PLUGINS
Ansible 搜索变量插件的以冒号分隔的路径列表。
- ANSIBLE_VAULT_ID_MATCH
如果为 true，则使用 vault id 解密保险库时，将仅尝试使用匹配 vault-id 的密码。
- ANSIBLE_VAULT_IDENTITY
在未提供 vault id 标签的情况下，用于默认 vault id 标签的标签。
- ANSIBLE_VAULT_ENCRYPT_SALT
用于保险库加密的盐。 如果未提供，将使用随机盐。
另请参阅 VAULT_ENCRYPT_SALT
- ANSIBLE_VAULT_ENCRYPT_IDENTITY
默认情况下用于加密的 vault_id。如果提供了多个 vault_id，则指定用于加密的 vault_id。
--encrypt-vault-id命令行选项会覆盖配置的值。
- ANSIBLE_VAULT_IDENTITY_LIST
默认情况下要使用的 vault-id 列表。等效于多个
--vault-id参数。Vault-id 按顺序尝试。
- ANSIBLE_VAULT_PASSWORD_FILE
要使用的保险库密码文件。等效于
--vault-password-file或--vault-id。如果可执行，它将被运行，并将生成的标准输出用作密码。
- ANSIBLE_VERBOSITY
设置默认详细级别，等效于在命令行中传递的
-v的数量。另请参阅 DEFAULT_VERBOSITY
- ANSIBLE_DEPRECATION_WARNINGS
用于控制是否显示弃用警告的开关。
另请参阅 DEPRECATION_WARNINGS
- ANSIBLE_DEVEL_WARNING
用于控制是否显示与运行开发版本相关的警告的开关。
另请参阅 DEVEL_WARNING
- ANSIBLE_DIFF_ALWAYS
配置开关，用于指示模块在“已更改”状态下显示差异，等效于
--diff。另请参阅 DIFF_ALWAYS
- ANSIBLE_DIFF_CONTEXT
显示文件差异时要显示的上下文行数。
另请参阅 DIFF_CONTEXT
- ANSIBLE_DISPLAY_ARGS_TO_STDOUT
通常，
ansible-playbook会为每个运行的任务打印一个标题。如果您指定了，这些标题将包含任务中的 name: 字段。如果您没有指定，则ansible-playbook会使用任务的操作来帮助您判断当前正在运行哪个任务。有时您会运行许多相同的操作，因此您需要更多有关任务的信息，以便将其与其他相同操作的任务区分开来。如果在配置中将此变量设置为 True，则ansible-playbook还将在标题中包含任务的参数。此设置默认为 False，因为您的参数中可能包含敏感值，并且您不希望打印这些值。如果将其设置为 True，则应确保已保护环境的标准输出（没有人可以在您的屏幕上偷看，并且您没有将标准输出保存到不安全的文件中），或者确保所有 playbook 都已在包含敏感值的任务中显式添加了no_log: True参数。有关更多信息，请参阅 如何在 playbook 中保留机密数据？。
- ANSIBLE_DISPLAY_SKIPPED_HOSTS
用于控制是否在默认回调中显示任务/主机跳过条目的开关。
- ANSIBLE_DUPLICATE_YAML_DICT_KEY
默认情况下，当在 YAML 中遇到重复的字典键时，Ansible 将发出警告。可以通过将此设置调整为 False 来消除这些警告。
- ANSIBLE_ERROR_ON_MISSING_HANDLER
用于允许在通知时将缺少的处理程序变为警告而不是错误的开关。
- ANSIBLE_FACTS_MODULES
在剧本的信息收集阶段运行哪些模块，使用默认值“smart”将尝试根据连接类型确定它。如果添加您自己的模块但您仍然想使用默认的 Ansible 信息，则需要将“setup”或相应的网络模块添加到列表中（如果添加“smart”，Ansible 也会确定它）。这不会影响对“setup”模块的显式调用，但始终会影响“gather_facts”操作（隐式或显式）。
另请参阅 FACTS_MODULES
- ANSIBLE_GALAXY_IGNORE
如果设置为 yes，则 ansible-galaxy 将不会验证 TLS 证书。这对于针对具有自签名证书的服务器进行测试非常有用。
另请参阅 GALAXY_IGNORE_CERTS
- ANSIBLE_GALAXY_SERVER_TIMEOUT
Galaxy API 调用的默认超时。未配置特定超时的 Galaxy 服务器将回退到此值。
- ANSIBLE_GALAXY_ROLE_SKELETON
角色框架目录，用作
ansible-galaxy/ansible-galaxy role中init操作的模板，与--role-skeleton相同。另请参阅 GALAXY_ROLE_SKELETON
- ANSIBLE_GALAXY_ROLE_SKELETON_IGNORE
在 Galaxy 角色或 Collection 框架目录中要忽略的文件模式。
- ANSIBLE_GALAXY_COLLECTION_SKELETON
用作
ansible-galaxy collection中init操作模板的集合框架目录，与--collection-skeleton相同。
- ANSIBLE_GALAXY_COLLECTION_SKELETON_IGNORE
Galaxy 集合框架目录中要忽略的文件模式。
- ANSIBLE_GALAXY_COLLECTIONS_PATH_WARNING
是否
ansible-galaxy collection install应该警告配置的 COLLECTIONS_PATHS 中缺少--collections-path。
- ANSIBLE_GALAXY_SERVER
当角色未指定完整 URI 时要添加的 URL 前缀，假设它们引用此服务器作为源。
另请参阅 GALAXY_SERVER
- ANSIBLE_GALAXY_SERVER_LIST
安装集合时要使用的 Galaxy 服务器列表。该值对应于配置 ini 标头
[galaxy_server.{{item}}]，该标头定义了服务器详细信息。有关如何定义 Galaxy 服务器的更多详细信息，请参阅 配置 ansible-galaxy 客户端。此列表中服务器的顺序用作解析集合的顺序。设置此配置选项将忽略 GALAXY_SERVER 配置选项。另请参阅 GALAXY_SERVER_LIST
- ANSIBLE_GALAXY_TOKEN_PATH
Galaxy 访问令牌文件的本地路径
另请参阅 GALAXY_TOKEN_PATH
- ANSIBLE_GALAXY_DISPLAY_PROGRESS
ansible-galaxy中的某些步骤会显示一个进度轮，这在某些显示器上或将标准输出输出到文件时可能会导致问题。此配置选项控制是否显示进度轮。默认设置是在标准输出具有 tty 时显示进度轮。
- ANSIBLE_GALAXY_CACHE_DIR
存储 Galaxy 服务器缓存响应的目录。这仅由
ansible-galaxy collection install和download命令使用。如果此目录内的缓存文件可供所有人写入，则将忽略它们。另请参阅 GALAXY_CACHE_DIR
- ANSIBLE_GALAXY_DISABLE_GPG_VERIFY
在集合安装过程中禁用 GPG 签名验证。
- ANSIBLE_GALAXY_GPG_KEYRING
配置在集合安装和验证期间用于 GPG 签名验证的密钥环。
另请参阅 GALAXY_GPG_KEYRING
- ANSIBLE_GALAXY_IGNORE_SIGNATURE_STATUS_CODES
在 GPG 签名验证期间要忽略的 GPG 状态代码列表。有关状态代码说明，请参阅 L(https://github.com/gpg/gnupg/blob/master/doc/DETAILS#general-status-codes)。如果成功验证集合的签名少于 GALAXY_REQUIRED_VALID_SIGNATURE_COUNT，则即使忽略所有错误代码，签名验证也将失败。
- ANSIBLE_GALAXY_REQUIRED_VALID_SIGNATURE_COUNT
在安装或验证集合期间，GPG 签名验证期间必须成功的签名数量。这应该是一个正整数或全部，表示所有签名都必须成功验证集合。在值前面添加 + 表示如果没有找到集合的有效签名，则失败。
- ANSIBLE_HOST_KEY_CHECKING
如果要避免 Ansible 用来连接到主机的底层连接插件检查主机密钥，请将其设置为“False”。有关详细信息，请阅读所用特定连接插件的文档。
- ANSIBLE_HOST_PATTERN_MISMATCH
此设置更改了不匹配主机模式的行为，它允许您强制执行致命错误、警告或只是忽略它。
- ANSIBLE_PYTHON_INTERPRETER
用于在远程目标上执行模块的 Python 解释器的路径，或自动发现模式。支持的发现模式有
auto（默认）、auto_silent、auto_legacy和auto_legacy_silent。所有发现模式都使用查找表来使用包含的系统 Python（在已知包含的發行版上），如果平台特定的默认值不可用，则回退到固定排序的已知 Python 解释器位置列表。回退行为将发出警告，表明应显式设置解释器（因为稍后安装的解释器可能会更改正在使用的解释器）。可以通过设置auto_silent或auto_legacy_silent来禁用此警告行为。auto_legacy的值提供所有相同行为，但为了向后兼容始终默认为/usr/bin/python的旧 Ansible 版本，如果存在，将使用该解释器。
- ANSIBLE_TRANSFORM_INVALID_GROUP_CHARS
使 Ansible 转换清单源提供的组名中的无效字符。
- ANSIBLE_INVALID_TASK_ATTRIBUTE_FAILED
如果为“false”，则任务的无效属性将导致警告而不是错误。
- ANSIBLE_INVENTORY_ANY_UNPARSED_IS_FAILED
如果为“true”，则当任何给定的清单源无法被任何可用的清单插件成功解析时，这是一个致命错误；否则，这种情况只会引起警告。
- ANSIBLE_INVENTORY_CACHE
切换以启用清单缓存。此设置已作为插件选项移至各个清单插件 清单插件。仍然接受现有的配置设置，清单插件会从清单配置中添加其他选项。此消息将在 2.16 中删除。
- ANSIBLE_INVENTORY_CACHE_PLUGIN
用于缓存清单的插件。此设置已作为插件选项移至各个清单插件 清单插件。仍然接受现有的配置设置，清单插件会从清单和事实缓存配置中添加其他选项。此消息将在 2.16 中删除。
- ANSIBLE_INVENTORY_CACHE_CONNECTION
清单缓存连接。此设置已作为插件选项移至各个清单插件 清单插件。仍然接受现有的配置设置，清单插件会从清单和事实缓存配置中添加其他选项。此消息将在 2.16 中删除。
- ANSIBLE_INVENTORY_CACHE_PLUGIN_PREFIX
缓存插件的表前缀。此设置已作为插件选项移至各个清单插件 清单插件。仍然接受现有的配置设置，清单插件会从清单和事实缓存配置中添加其他选项。此消息将在 2.16 中删除。
- ANSIBLE_INVENTORY_CACHE_TIMEOUT
清单缓存插件数据的到期超时。此设置已作为插件选项移至各个清单插件 清单插件。仍然接受现有的配置设置，清单插件会从清单和事实缓存配置中添加其他选项。此消息将在 2.16 中删除。
- ANSIBLE_INVENTORY_ENABLED
已启用的清单插件列表，它还确定了它们的使用顺序。
- ANSIBLE_INVENTORY_EXPORT
控制 ansible-inventory 是准确反映 Ansible 对清单的视图，还是对其进行优化以供导出。
- ANSIBLE_INVENTORY_IGNORE
使用目录作为清单源时要忽略的扩展名列表。
- ANSIBLE_INVENTORY_IGNORE_REGEX
使用目录作为清单源时要忽略的模式列表。
- ANSIBLE_INVENTORY_UNPARSED_FAILED
如果为“true”，则如果每个潜在的清单源都无法解析，则这是一个致命错误，否则，这种情况只会引发警告。
- ANSIBLE_MAX_DIFF_SIZE
要考虑进行差异显示的文件的最大大小。
- ANSIBLE_NETWORK_GROUP_MODULES
- ANSIBLE_INJECT_FACT_VARS
事实在 ansible_facts 变量中可用，此设置也会将它们作为自己的变量推送到主命名空间中。与 ansible_facts 字典（其中从事实名称中删除了前缀 ansible_）不同，这些变量将具有模块返回的确切名称。
- ANSIBLE_MODULE_IGNORE_EXTS
查找要加载的模块时要忽略的扩展名列表。这是为了拒绝脚本和二进制模块后备扩展名。
- ANSIBLE_MODULE_STRICT_UTF8_RESPONSE
启用后，将评估模块响应是否包含非 UTF-8 数据。禁用此选项可能会导致意外行为。只有 ansible-core 应该评估此配置。
- ANSIBLE_OLD_PLUGIN_CACHE_CLEAR
以前，Ansible 只会在加载新角色时清除一些插件加载缓存，这导致在之前剧本中加载的插件会意外地“粘连”。此设置允许用户返回到该行为。
- ANSIBLE_PARAMIKO_HOST_KEY_AUTO_ADD
- ANSIBLE_PARAMIKO_LOOK_FOR_KEYS
- ANSIBLE_PERSISTENT_CONTROL_PATH_DIR
连接持久性系统要使用的套接字的路径。
- ANSIBLE_PERSISTENT_CONNECT_TIMEOUT
这控制持久连接在被销毁之前保持空闲的时间。
- ANSIBLE_PERSISTENT_CONNECT_RETRY_TIMEOUT
这控制持久连接连接到本地域套接字的重试超时。
- ANSIBLE_PERSISTENT_COMMAND_TIMEOUT
这控制在使持久连接超时之前等待远程设备响应的时间。
- ANSIBLE_PLAYBOOK_DIR
许多非剧本 CLI 都有一个
--playbook-dir参数；这将设置其默认值。另见 PLAYBOOK_DIR
- ANSIBLE_PLAYBOOK_VARS_ROOT
这将设置哪些剧本目录将用作处理 vars 插件的根目录，包括查找 host_vars/group_vars。
- ANSIBLE_PYTHON_MODULE_RLIMIT_NOFILE
尝试在执行 Python 模块时将 RLIMIT_NOFILE 软限制设置为指定的值（可以加快 Python 2.x 上子进程的使用。请参阅 https://bugs.python.org/issue11284）。该值将受到现有硬限制的限制。默认值 0 不会尝试调整现有的系统定义限制。
- ANSIBLE_RETRY_FILES_ENABLED
这控制失败的 Ansible 剧本是否应创建 .retry 文件。
- ANSIBLE_RETRY_FILES_SAVE_PATH
这将设置在剧本失败且启用了重试文件时，Ansible 保存 .retry 文件的路径。每次运行后，此文件都将使用所有剧本中失败的主机列表覆盖。
- ANSIBLE_RUN_VARS_PLUGINS
此设置可用于根据用户清单大小和 play 选择优化 vars_plugin 的使用。
- ANSIBLE_SHOW_CUSTOM_STATS
这会将通过 set_stats 插件设置的自定义统计信息添加到默认输出中。
- ANSIBLE_STRING_TYPE_FILTERS
此过滤器列表避免在模板化变量时进行“类型转换”。例如，当您想避免将 JSON 字符串转换为列表或字典时，这很有用。
另请参阅 STRING_TYPE_FILTERS
- ANSIBLE_SYSTEM_WARNINGS
允许禁用与运行 Ansible 本身的系统（而不是受管主机）上的潜在问题相关的警告。这些警告可能包括有关第三方软件包或应尽可能解决的其他情况的警告。
另请参阅 SYSTEM_WARNINGS
- ANSIBLE_TARGET_LOG_INFO
要插入到目标日志记录中以进行跟踪的字符串
另请参阅 TARGET_LOG_INFO
- ANSIBLE_TASK_TIMEOUT
设置任务操作执行的最长时间（以秒为单位）。超时独立于模板化或循环运行。它适用于执行任务操作的每次尝试，并且不受任务总耗时的影响。当操作执行超过超时时间时，Ansible 会中断该过程。这被注册为由于外部环境导致的失败，而不是任务失败，以便接收适当的响应和恢复过程。如果设置为 0（默认值），则表示没有超时。
另请参阅 TASK_TIMEOUT
- ANSIBLE_WORKER_SHUTDOWN_POLL_COUNT
检查任务队列管理器工作进程以验证它们是否已完全退出的最大次数。达到此限制后，任何仍在运行的工作进程都将被终止。这仅供内部使用。
- ANSIBLE_WORKER_SHUTDOWN_POLL_DELAY
在检查任务队列管理器工作进程以验证它们是否已完全退出时，轮询循环之间休眠的秒数。这仅供内部使用。
- ANSIBLE_USE_PERSISTENT_CONNECTIONS
切换是否对连接使用持久性。
- ANSIBLE_VARS_ENABLED
需要它的变量插件的接受列表。
- ANSIBLE_PRECEDENCE
允许更改组变量优先级合并顺序。
另请参阅 VARIABLE_PRECEDENCE
- ANSIBLE_WIN_ASYNC_STARTUP_TIMEOUT
对于 Ansible 中的异步任务（在异步操作和轮询中介绍），这是等待 Ansible 生成的任务连接回 Windows 系统上使用的命名管道的时间（以秒为单位）。默认值为 5 秒。在速度较慢的系统或负载较重的系统上，此值可能过低。这不是异步命令可以运行的总时间，而是一个单独的超时时间，用于等待异步命令启动。只有当任务连接到管道后，才会开始根据其 async_timeout 对其计时，因此任务可以花费的总最长时间将延长此处指定的时间。
- ANSIBLE_YAML_FILENAME_EXT
在查找应该是 YAML 或 JSON 或其加密版本的“变量”文件时，请检查所有这些扩展名。这会影响 vars_files、include_vars、inventory 和 vars 插件等。
- ANSIBLE_NETCONF_SSH_CONFIG
此变量用于通过 netconf 连接启用堡垒机/跳转主机。如果设置为 True，则堡垒机/跳转主机的 ssh 设置应该存在于 ~/.ssh/config 文件中，或者可以将其设置为自定义 ssh 配置文件路径以读取堡垒机/跳转主机的设置。
另请参阅 NETCONF_SSH_CONFIG
- ANSIBLE_STRING_CONVERSION_ACTION
将模块参数值转换为字符串时要采取的操作（这不影响变量）。对于字符串参数，诸如“1.00”、“[‘a’, ‘b’,]”和“yes”、“y”等值将由 YAML 解析器转换，除非使用完全引号。有效选项为“error”、“warn”和“ignore”。自 2.8 版本以来，此选项默认为“warn”，但在 2.12 版本中将更改为“error”。
- ANSIBLE_VALIDATE_ACTION_GROUP_METADATA
用于禁用验证集合的“metadata”条目以获取 module_defaults 操作组的切换。 当此值为 True 时，包含意外字段或值类型的元数据将产生警告。
- ANSIBLE_VERBOSE_TO_STDERR
强制“verbose”选项使用 stderr 而不是 stdout
另请参阅 VERBOSE_TO_STDERR