常见问题解答
以下是一些常见问题及其答案。
所有模块都去哪儿了？
2019 年 7 月，我们宣布集合将成为 Ansible 内容交付的未来。集合是一种 Ansible 内容的分发格式，可以包括 playbook、角色、模块和插件。在 Ansible 2.9 中，我们添加了对集合的支持。在 Ansible 2.10 中，我们 从主 ansible/ansible 存储库中提取了大多数模块，并将它们放在 集合中。集合可能由 Ansible 团队、Ansible 社区或 Ansible 合作伙伴维护。ansible/ansible 存储库现在包含基本特性和功能的代码，例如将模块代码复制到受管节点。此代码也称为 ansible-core（在 2.10 版本中曾短暂称为 ansible-base）。
要了解有关使用集合的更多信息，请参阅 使用 Ansible 集合。
要了解有关开发集合的更多信息，请参阅 开发集合。
要了解有关为现有集合做出贡献的更多信息，请参阅各个集合存储库的指南，或参阅 为 Ansible 维护的集合做出贡献，以向 Ansible 维护的集合之一做出贡献。
这个特定的模块去哪儿了？
如果您正在搜索特定模块，可以查看 runtime.yml 文件，其中列出了我们从主 ansible/ansible 存储库中提取的每个模块的第一个目的地。从那时起，一些模块再次移动。您还可以在 Ansible Galaxy 上搜索或在我们的 聊天频道之一中提问。
如何加快在慢速磁盘系统上运行 Ansible 的速度？
在磁盘速度较慢的系统（如 Raspberry PI）上，Ansible 可能会感觉迟缓。请参阅 如果 libyaml 不可用，Ansible 可能会运行缓慢，了解如何改进此问题的提示。
如何为任务或整个 Play 设置 PATH 或任何其他环境变量？
可以使用 environment 关键字设置环境变量。它可以在任务或 play 中的其他级别使用。
shell:
cmd: date
environment:
LANG=fr_FR.UTF-8
hosts: servers
environment:
PATH: "{{ ansible_env.PATH }}:/thingy/bin"
SOME: value
注意
从 2.0.1 开始，gather_facts 中的 setup 任务也继承了 play 的 environment 指令，如果在 play 级别设置此项，您可能需要使用 |default 过滤器来避免错误。
如何处理需要不同的用户帐户或端口登录的不同机器？
在清单文件中设置清单变量是最简单的方法。
例如，假设这些主机具有不同的用户名和端口
[webservers]
asdf.example.com ansible_port=5000 ansible_user=alice
jkl.example.com ansible_port=5001 ansible_user=bob
如果您愿意，还可以指定要使用的连接类型
[testcluster]
localhost ansible_connection=local
/path/to/chroot1 ansible_connection=chroot
foo.example.com ansible_connection=paramiko
您可能还希望将这些保存在组变量中，或者将其放在 group_vars/<groupname> 文件中。有关如何组织变量的更多信息，请参阅文档的其余部分。
如何让 Ansible 重用连接、启用 Kerberized SSH，或者让 Ansible 注意我本地的 SSH 配置文件？
在配置文件中将默认连接类型切换为 ssh，或者使用 -c ssh 使用 Native OpenSSH 进行连接，而不是使用 python paramiko 库。在 Ansible 1.2.1 及更高版本中，如果 OpenSSH 的版本足够新，可以支持 ControlPersist 选项，则默认使用 ssh。
Paramiko 非常适合入门，但 OpenSSH 类型提供了许多高级选项。如果您使用此连接类型，您将希望从一台足够新的机器上运行 Ansible，以支持 ControlPersist。您仍然可以管理较旧的客户端。如果您使用的是 RHEL 6、CentOS 6、SLES 10 或 SLES 11，则 OpenSSH 的版本仍然有点旧，因此即使您正在管理较旧的节点，也请考虑从 Fedora 或 openSUSE 客户端进行管理，或者只是使用 paramiko。
我们保留 paramiko 作为默认值，因为如果您首先在这些企业操作系统上安装 Ansible，它会为新用户提供更好的体验。
如何配置跳板机来访问我无法直接访问的服务器？
您可以在 ansible_ssh_common_args 清单变量中设置 ProxyCommand。连接到相关主机时，此变量中指定的任何参数都将添加到 sftp/scp/ssh 命令行中。考虑以下清单组
[gatewayed]
foo ansible_host=192.0.2.1
bar ansible_host=192.0.2.2
您可以创建 group_vars/gatewayed.yml，其内容如下
ansible_ssh_common_args: '-o ProxyCommand="ssh -W %h:%p -q [email protected]"'
当尝试连接到组 gatewayed 中的任何主机时，Ansible 会将这些参数附加到命令行。(这些参数是在 ansible.cfg 中的任何 ssh_args 之外使用的，因此您无需在 ansible_ssh_common_args 中重复全局的 ControlPersist 设置。)
请注意，ssh -W 仅在 OpenSSH 5.4 或更高版本中可用。对于旧版本，必须在堡垒机主机上执行 nc %h:%p 或某些等效命令。
在早期版本的 Ansible 中，需要在 ~/.ssh/config 中为一个或多个主机配置合适的 ProxyCommand，或者通过在 ansible.cfg 中设置 ssh_args 来全局配置。
如何让 Ansible 及时注意到已失效的目标？
您可以在 SSH 连接插件中使用 ssh_args 参数添加 -o ServerAliveInterval=NumberOfSeconds。 如果没有此选项，SSH 以及 Ansible 将会等到 TCP 连接超时。另一种解决方案是将 ServerAliveInterval 添加到您的全局 SSH 配置中。 ServerAliveInterval 的合适值由您决定；请记住，ServerAliveCountMax=3 是 SSH 的默认值，因此您设置的任何值在 SSH 会话终止之前都会乘以三。
如何加快 Ansible 在云提供商（EC2、openstack 等）服务器上的运行速度？
不要尝试从笔记本电脑管理云提供商的一组机器。而是先连接到此云提供商内部的管理节点，然后从那里运行 Ansible。
如果远程计算机上 /usr/bin/python 没有 Python 解释器，我该如何处理？
虽然您可以使用任何语言编写 Ansible 模块，但大多数 Ansible 模块都是用 Python 编写的，包括让 Ansible 工作的核心模块。
默认情况下，Ansible 假定可以在您的远程系统上找到 /usr/bin/python，该 Python 必须是 Python2 (2.6 或更高版本) 或 Python3 (3.5 或更高版本)。
在任何主机上设置 inventory 变量 ansible_python_interpreter 将告诉 Ansible 自动将 Python 解释器替换为该值。因此，如果系统上的 /usr/bin/python 未指向兼容的 Python 解释器，则可以指向系统上的任何 Python。
某些平台可能默认只安装了 Python 3。如果它没有安装为 /usr/bin/python，您将需要通过 ansible_python_interpreter 配置解释器的路径。虽然大多数核心模块都可以在 Python 3 上运行，但可能有一些特殊的模块无法运行，或者您可能会在边缘情况下遇到错误。作为临时解决方法，您可以在受管主机上安装 Python 2 并配置 Ansible 通过 ansible_python_interpreter 使用该 Python。如果模块文档中没有提及该模块需要 Python 2，您也可以在我们的 错误跟踪器上报告错误，以便可以在未来的版本中修复不兼容性问题。
不要替换 Python 模块的 shebang 行。Ansible 将在部署时自动为您执行此操作。
此外，这适用于任何解释器，例如 ruby：ansible_ruby_interpreter，perl：ansible_perl_interpreter，依此类推，因此您可以将此用于以任何脚本语言编写的自定义模块并控制解释器位置。
请记住，如果您在模块 shebang 行中放置 env（#!/usr/bin/env <other>），则它将无法正常工作，并将被评估为一个字符串（包括 env 和 <other> 之间的空格）。既不打算也不支持参数。
在 Ansible 安装期间，如何处理 Ansible 软件包依赖项所需的软件包依赖项？
安装 Ansible 时，有时可能会遇到诸如 No package ‘libffi’ found 或 fatal error: Python.h: No such file or directory 之类的错误。这些错误通常是由缺少 Ansible 所需软件包的依赖项软件包引起的。例如，libffi 软件包是 pynacl 和 paramiko 的依赖项（Ansible -> paramiko -> pynacl -> libffi）。
为了解决这些类型的依赖项问题，您可能需要使用 OS 原生软件包管理器（例如 yum、dnf 或 apt）或如软件包安装指南中所述，安装所需的软件包。
有关此类依赖项及其安装方法，请参阅相应软件包的文档。
常见平台问题
红帽支持哪些客户平台？
很多！有关明确的列表，请参阅此知识库文章。
在 virtualenv 中运行
您可以非常简单地将 Ansible 安装到控制节点上的 virtualenv 中
$ virtualenv ansible
$ source ./ansible/bin/activate
$ pip install ansible
如果您想在 Python 3 而不是 Python 2 下运行，您可能需要稍微更改一下
$ virtualenv -p python3 ansible
$ source ./ansible/bin/activate
$ pip install ansible
如果您需要使用 pip 无法提供的任何库（例如，在启用了 SELinux 的 Red Hat Enterprise Linux 或 Fedora 等系统上的 SELinux Python 绑定），则需要将它们安装到 virtualenv 中。有两种方法
创建 virtualenv 时，指定
--system-site-packages以使用系统中 Python 中安装的任何库$ virtualenv ansible --system-site-packages
手动从系统复制这些文件。例如，对于 SELinux 绑定，您可能会这样做
$ virtualenv ansible --system-site-packages $ cp -r -v /usr/lib64/python3.*/site-packages/selinux/ ./py3-ansible/lib64/python3.*/site-packages/ $ cp -v /usr/lib64/python3.*/site-packages/*selinux*.so ./py3-ansible/lib64/python3.*/site-packages/
在 macOS 上作为控制节点运行
在将 macOS 作为控制节点机器的系统上执行 Ansible 时，可能会遇到以下错误
错误
+[__NSCFConstantString initialize] may have been in progress in another thread when fork() was called. We cannot safely call it or ignore it in the fork() child process. Crashing instead. Set a breakpoint on objc_initializeAfterForkError to debug. ERROR! A worker was found in a dead state
通常，建议的解决方法是在您的 shell 中设置以下环境变量
$ export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES
在 macOS 上作为目标运行
通过 SSH 管理 macOS Monterey 12、macOS Ventura 13 或更高版本的系统时，可能会发生以下错误
错误
“eDSPermissionError” DS Error: -14120 (eDSPermissionError)
这很好地表明未启用“允许远程用户完全磁盘访问权限”。
另请参阅
有关更多详细信息，请查看 Apple 官方用户指南文章。
在 BSD 上运行
另请参阅
在 Solaris 上运行
默认情况下，Solaris 10 及更早版本运行非 POSIX shell，该 shell 不能正确扩展 Ansible 使用的默认 tmp 目录 (~/.ansible/tmp)。如果您在 Solaris 计算机上看到模块失败，这很可能是问题所在。有几种解决方法
您可以将
remote_tmp设置为使用您正在使用的 shell 正确扩展的路径（请参阅插件文档中的 C shell、fish shell 和 Powershell）。例如，在 Ansible 配置文件中，您可以设置remote_tmp=$HOME/.ansible/tmp
在 Ansible 2.5 及更高版本中，您还可以在 inventory 中按主机设置，如下所示
solaris1 ansible_remote_tmp=$HOME/.ansible/tmp
您可以将 ansible_shell_executable 设置为 POSIX 兼容 shell 的路径。例如，许多 Solaris 主机在
/usr/xpg4/bin/sh中都有一个 POSIX shell，因此您可以在 inventory 中这样设置solaris1 ansible_shell_executable=/usr/xpg4/bin/sh
（如果安装了 bash、ksh 和 zsh，它们也应该与 POSIX 兼容）。
在 z/OS 上运行
尝试在 z/OS 上作为目标执行 Ansible 时，可能会遇到一些常见错误。
适用于 z/OS 的 python 2.7.6 版本不能与 Ansible 一起使用，因为它在内部将字符串表示为 EBCDIC。
为了解决此限制，请下载并安装更高版本的适用于 z/OS 的 python (2.7.13 或 3.6.1)，它在内部将字符串表示为 ASCII。已验证 2.7.13 版本可以正常工作。
当 /etc/ansible/ansible.cfg 中的
pipelining = False时，Ansible 模块通过 sftp 以二进制模式传输，但是 Python 的执行失败，并显示以下错误错误
SyntaxError: Non-UTF-8 code starting with '\x83' in file /a/user1/.ansible/tmp/ansible-tmp-1548232945.35-274513842609025/AnsiballZ_stat.py on line 1, but no encoding declared; see https://pythonlang.cn/dev/peps/pep-0263/ for details
要解决此问题，请在 /etc/ansible/ansible.cfg 中设置
pipelining = True。在目标主机上的默认位置
/usr/bin/python中找不到 Python 解释器。错误
/usr/bin/python: EDC5129I No such file or directory
要解决此问题，请在您的 inventory 中设置 Python 安装的路径，如下所示
zos1 ansible_python_interpreter=/usr/lpp/python/python-2017-04-12-py27/python27/bin/python
Python 启动失败，并显示
The module libpython2.7.so was not found.错误
EE3501S The module libpython2.7.so was not found.
在 z/OS 上，您必须从 gnu bash 执行 python。如果 gnu bash 安装在
/usr/lpp/bash，您可以通过指定ansible_shell_executable来在您的清单中修复此问题。zos1 ansible_shell_executable=/usr/lpp/bash/bin/bash
在 fakeroot 下运行
由于 fakeroot 默认情况下不会创建一个完整且符合 POSIX 标准的系统，因此会出现一些问题。已知它不会正确展开 Ansible 使用的默认临时目录（~/.ansible/tmp）。如果您看到模块失败，这很可能是问题所在。简单的解决方法是将 remote_tmp 设置为可以正确展开的路径（请参阅您正在使用的 shell 插件的文档了解具体信息）。
例如，在 ansible 配置文件中（或通过环境变量）您可以设置
remote_tmp=$HOME/.ansible/tmp
使内容可重用/可重新分发的最佳方式是什么？
如果您尚未这样做，请阅读剧本文档中有关“角色”的所有内容。这可以帮助您使剧本内容自包含，并且可以很好地与 Git 子模块等功能配合使用，以便与他人共享内容。
如果其中一些插件类型对您来说很陌生，请参阅 API 文档，了解有关 Ansible 扩展方式的更多详细信息。
配置文件位于何处，我可以在其中配置什么？
请参阅 配置 Ansible。
如何禁用 cowsay？
如果安装了 cowsay，Ansible 会在运行剧本时尽力让您的一天更快乐。如果您决定在没有奶牛的专业环境中工作，您可以卸载 cowsay，在 ansible.cfg 中设置 nocows=1，或设置 ANSIBLE_NOCOWS 环境变量
export ANSIBLE_NOCOWS=1
如何查看所有 ansible_ 变量的列表？
Ansible 默认会收集有关受管机器的“事实”，这些事实可以在剧本和模板中访问。要查看有关机器的所有可用事实的列表，您可以将 setup 模块作为临时操作运行
ansible -m setup hostname
这将打印出特定主机的所有可用事实的字典。您可能需要将输出管道传输到分页器。这不包括清单变量或内部“魔法”变量。如果您需要的不只是“事实”，请参阅下一个问题。
如何查看为我的主机定义的所有清单变量？
通过运行以下命令，您可以查看主机的清单变量
ansible-inventory --list --yaml
如何查看特定于我的主机的所有变量？
要查看所有特定于主机的变量，其中可能包括事实和其他来源
ansible -m debug -a "var=hostvars['hostname']" localhost
除非您使用事实缓存，否则通常需要先使用收集事实的剧本，以便在上面的任务中包含事实。
如何在模板中循环访问组中的主机列表？
一个非常常见的模式是在主机组内迭代主机列表，可能是为了使用服务器列表填充模板配置文件。为此，您只需访问模板中的“$groups”字典，如下所示
{% for host in groups['db_servers'] %}
{{ host }}
{% endfor %}
如果您需要访问有关这些主机的事实，例如每个主机名的 IP 地址，您需要确保事实已填充。例如，请确保您有一个与 db_servers 对话的剧本
- hosts: db_servers
tasks:
- debug: msg="doesn't matter what you do, just that they were talked to previously."
然后，您可以在模板中使用事实，如下所示
{% for host in groups['db_servers'] %}
{{ hostvars[host]['ansible_eth0']['ipv4']['address'] }}
{% endfor %}
如何以编程方式访问变量名？
可能会出现一个示例，我们需要获取任意接口的 ipv4 地址，其中要使用的接口可以通过角色参数或其他输入提供。变量名可以通过使用“~”将字符串添加到一起来构建，如下所示
{{ hostvars[inventory_hostname]['ansible_' ~ which_interface]['ipv4']['address'] }}
通过 hostvars 是必要的技巧，因为它是一个包含整个变量命名空间的字典。inventory_hostname 是一个魔法变量，它指示您在主机循环中循环的当前主机。
在上面的示例中，如果您的接口名称包含破折号，则必须将其替换为下划线
{{ hostvars[inventory_hostname]['ansible_' ~ which_interface | replace('_', '-') ]['ipv4']['address'] }}
另请参阅 dynamic_variables。
如何访问组变量？
从技术上讲，您不能，Ansible 实际上不直接使用组。组是主机选择的标签和批量分配变量的一种方式，它们不是一等实体，Ansible 只关心主机和任务。
也就是说，您可以通过选择属于该组的主机来访问变量，有关示例，请参阅下面的 first_host_in_a_group。
如何访问组中第一台主机的变量？
如果我们需要 webservers 组中第一台 Web 服务器的 IP 地址怎么办？好吧，我们也可以做到这一点。请注意，如果我们使用动态清单，哪个主机是“第一”可能不一致，因此除非您的清单是静态且可预测的，否则您不会想要这样做。（如果您使用 AWX 或 Red Hat Ansible Automation Platform，它将使用数据库顺序，因此即使您使用基于云的清单脚本，这也不是问题）。
无论如何，这里有一个技巧
{{ hostvars[groups['webservers'][0]]['ansible_eth0']['ipv4']['address'] }}
请注意，我们如何提取 webservers 组中第一台机器的主机名。如果您在模板中执行此操作，则可以使用 Jinja2 的“#set”指令来简化此操作，或者在剧本中，您也可以使用 set_fact
- set_fact: headnode={{ groups['webservers'][0] }}
- debug: msg={{ hostvars[headnode].ansible_eth0.ipv4.address }}
请注意，我们如何将括号语法互换为点 - 这可以在任何地方完成。
如何将文件递归复制到目标主机？
copy 模块有一个 recursive 参数。但是，如果您想对大量文件执行更高效的操作，请查看 synchronize 模块。synchronize 模块包装了 rsync。请参阅模块索引以获取有关这两个模块的信息。
如何访问 shell 环境变量？
在控制节点机器上： 要访问控制节点中现有的变量，请使用 env 查找插件。例如，要访问管理计算机上 HOME 环境变量的值
---
# ...
vars:
local_home: "{{ lookup('env','HOME') }}"
在目标机器上： 环境变量可通过 ansible_env 变量中的事实获得
{{ ansible_env.HOME }}
如果您需要为 TASK 执行设置环境变量，请参阅 设置远程环境 中的 高级剧本 部分。有多种方法可以在目标计算机上设置环境变量。您可以使用 template、replace 或 lineinfile 模块将环境变量引入到文件中。要编辑的确切文件因您的操作系统、发行版和本地配置而异。
如何为用户模块生成加密密码？
Ansible 临时命令是最简单的选择
ansible all -i localhost, -m debug -a "msg={{ 'mypassword' | password_hash('sha512', 'mysecretsalt') }}"
大多数 Linux 系统上提供的 mkpasswd 实用程序也是一个不错的选择
mkpasswd --method=sha-512
如果您的系统上未安装此实用程序（例如，您使用的是 macOS），您仍然可以使用 Python 轻松生成这些密码。首先，请确保已安装 Passlib 密码哈希库
pip install passlib
准备好库后，可以按如下方式生成 SHA512 密码值
python -c "from passlib.hash import sha512_crypt; import getpass; print(sha512_crypt.using(rounds=5000).hash(getpass.getpass()))"
使用集成的 哈希和加密字符串和密码 来生成密码的哈希版本。您不应将纯文本密码放入您的剧本或 host_vars 中；而是使用 使用加密的变量和文件 来加密敏感数据。
在 OpenBSD 中，基本系统中提供了一个类似的选项，称为 encrypt (1)
Ansible 允许变量使用点表示法和数组表示法。我应该使用哪种表示法？
点表示法来自 Jinja，适用于没有特殊字符的变量。如果您的变量包含点 (.)、冒号 (:) 或破折号 (-)，如果键以两个下划线开头和结尾，或者如果键使用任何已知的公共属性，则使用数组表示法更安全。有关已知公共属性的列表，请参阅 使用变量。
item[0]['checksum:md5']
item['section']['2.1']
item['region']['Mid-Atlantic']
It is {{ temperature['Celsius']['-3'] }} outside.
此外，数组表示法允许动态变量组合，请参阅 dynamic_variables。
“点表示法”的另一个问题是，某些键可能会导致问题，因为它们与 Python 字典的属性和方法冲突。
当
item是字典时，语法不正确的示例
item.update
此变体导致语法错误，因为 update() 是字典的 Python 方法。
语法正确的示例
item['update']
何时从变量批量设置任务参数是不安全的？
您可以从字典类型的变量设置任务的所有参数。这种技术在某些动态执行场景中可能很有用。但是，它引入了安全风险。我们不建议这样做，因此当您执行类似操作时，Ansible 会发出警告
#...
vars:
usermod_args:
name: testuser
state: present
update_password: always
tasks:
- user: '{{ usermod_args }}'
这个特定的例子是安全的。但是，构建这样的任务是有风险的，因为传递给 usermod_args 的参数和值可能会被受损目标机器上 host facts 中的恶意值覆盖。为了降低这种风险
在优先级高于
host facts的级别设置批量变量，优先级顺序请参考 变量优先级：我应该把变量放在哪里？（上面的例子是安全的，因为 play 变量的优先级高于 facts）禁用 INJECT_FACTS_AS_VARS 配置设置，以防止事实值与变量冲突（这也会禁用原始警告）
我可以获得 Ansible 的培训吗？
是的！请查看我们的 服务页面，了解我们的服务和培训产品信息。如有更多详情，请发送电子邮件至 info@ansible.com。
我们还定期提供免费的在线培训课程。请查看我们的 网络研讨会页面，了解即将举行的网络研讨会的更多信息。
是否有 Web 界面 / REST API / GUI？
是的！开源 Web 界面是 Ansible AWX。受支持的 Red Hat 产品使 Ansible 更加强大和易于使用，即 Red Hat Ansible Automation Platform。
如何在我的 playbook 中保留秘密数据？
如果您想在 Ansible 内容中保留秘密数据，同时仍然公开共享或将其保存在源代码控制中，请参阅 使用加密变量和文件。
如果您有一个任务，您不希望在使用 -v（详细）模式时显示结果或给定的命令，则以下任务或 playbook 属性可能很有用
- name: secret task
shell: /usr/bin/do_something --value={{ secret_value }}
no_log: True
这可以用于保留详细输出，但隐藏敏感信息，防止其他人看到输出。
no_log 属性也可以应用于整个 play
- hosts: all
no_log: True
尽管这会使 play 难以调试。建议只在 playbook 完成后将此应用于单个任务。请注意，使用 no_log 属性不会阻止在通过 ANSIBLE_DEBUG 环境变量调试 Ansible 本身时显示数据。
我应该何时使用 {{ }}？以及如何插值变量或动态变量名？
一个坚定的规则是“始终使用 {{ }}，除非在 when: 中”。条件语句始终通过 Jinja2 运行以解析表达式，因此 when:、failed_when: 和 changed_when: 始终被模板化，您应该避免添加 {{ }}。
在大多数其他情况下，您应该始终使用括号，即使以前您可以在不指定的情况下使用变量（例如 loop 或 with_ 子句），因为这使得难以区分未定义的变量和字符串。
另一个规则是“大括号不能堆叠”。我们经常看到这种情况
{{ somevar_{{other_var}} }}
上面的方法无法按预期工作，如果您需要使用动态变量，请使用以下适当的方法
{{ hostvars[inventory_hostname]['somevar_' ~ other_var] }}
对于“非主机变量”，您可以使用 vars lookup 插件
{{ lookup('vars', 'somevar_' ~ other_var) }}
要确定关键字是否需要 {{ }} 甚至支持模板化，请使用 ansible-doc -t keyword <name>，这将返回有关关键字的文档，包括一个 template 字段，其值为 explicit（需要 {{ }}），implicit（假设 {{ }}，因此不需要）或 static（不支持模板化，所有字符都将按字面解释）
当我委托任务时，如何获取原始的 ansible_host？
正如文档所述，连接变量取自 delegate_to 主机，因此 ansible_host 被覆盖，但您仍然可以通过 hostvars 访问原始值
original_host: "{{ hostvars[inventory_hostname]['ansible_host'] }}"
这适用于所有被覆盖的连接变量，例如 ansible_user、ansible_port 等。
当获取文件时，如何修复“protocol error: file name does not match request”错误？
自从 OpenSSH 的 7.9p1 版本发布以来，SCP 客户端中存在一个 错误，当使用 SCP 作为文件传输机制时，该错误可能会在 Ansible 控制节点上触发此错误
错误
failed to transfer file to /tmp/ansible/file.txtrnprotocol error: file name does not match request
在这些版本中，SCP 尝试验证要获取的文件的路径是否与请求的路径匹配。如果远程文件名需要在其路径中使用引号来转义空格或非 ASCII 字符，则验证将失败。要避免此错误
- 请确保您正在使用 SFTP，它是安全、速度和可靠性的最佳传输方法。请检查您是否正在执行以下操作之一
依赖默认设置，即
smart——如果ssh_transfer_method未在任何地方显式设置，则此方法有效在您的控制节点上设置一个环境变量：
export ANSIBLE_SSH_TRANSFER_METHOD=smart运行 Ansible 时传递一个环境变量：
ANSIBLE_SSH_TRANSFER_METHOD=smart ansible-playbook修改您的
ansible.cfg文件：将ssh_transfer_method=smart添加到[ssh_connection]部分。smart设置尝试使用sftp进行传输，然后回退到scp，最后回退到dd。如果您希望在 SFTP 不可用时传输失败，请将ssh_transfer_method=sftp添加到[ssh_connection]部分。
注意
如果您在使用 -T 时看到 invalid argument 错误，则表示您的 SCP 客户端没有执行文件名验证，并且不会触发此错误。
Ansible 是否支持多因素身份验证 2FA/MFA/生物识别/指纹/USB 密钥/OTP/…？
不，Ansible 的设计目的是针对多个目标执行多项任务，最大限度地减少用户交互。与大多数自动化工具一样，它与旨在处理人机交互的交互式安全系统不兼容。大多数此类系统每个目标都需要二次提示，这会阻止扩展到数千个目标。它们也往往具有非常短的过期时间，因此需要频繁重新授权，这对于许多主机和/或长任务集来说也是一个问题。
在这样的环境中，我们建议围绕 Ansible 的执行进行安全设置，但仍然允许它使用不需要此类措施的“自动化用户”。通过 AWX 或Red Hat Ansible 自动化平台，管理员可以设置对清单的 RBAC 访问，以及管理凭据和作业执行。
“validate”选项不足以满足我的需求，我该怎么办？
许多创建或更新文件的 Ansible 模块都有一个 validate 选项，允许您在验证命令失败时中止更新。这会使用 Ansible 在进行最终更新之前创建的临时文件。在许多情况下，这不起作用，因为特定应用程序的验证工具需要特定的名称、多个文件或此简单功能中不存在的其他因素。
对于这些情况，您必须自己处理验证和恢复。以下是如何使用 block/rescue 和备份（大多数基于文件的模块也支持）执行此操作的简单示例
- name: maintain config and backout if validation after change fails
block:
- name: do the actual update, works with copy, lineinfile and any action that allows for `backup`.
template: src=template.j2 dest=/x/y/z backup=yes moreoptions=stuff
register: updated
- name: run validation, this will change a lot as needed. We assume it returns an error when not passing, use `failed_when` if otherwise.
shell: run_validation_commmand
become: true
become_user: requiredbyapp
environment:
WEIRD_REQUIREMENT: 1
when: updated is changed
rescue:
- name: restore backup file to original, in the hope the previous configuration was working.
copy:
remote_src: true
dest: /x/y/z
src: "{{ updated['backup_file'] }}"
when: updated is changed
always:
- name: We choose to always delete backup, but could copy or move, or only delete in rescue.
file:
path: "{{ updated['backup_file'] }}"
state: absent
when: updated is changed
为什么 regex_search 过滤器返回 None 而不是空字符串？
在 jinja2 2.10 版本之前，Jinja 只能返回字符串，但在某些情况下，Ansible 需要 Python 对象。Ansible 使用 safe_eval，并且仅通过此函数发送看起来像某些类型的 Python 对象的字符串。对于未找到匹配项的 regex_search，结果 (None) 将转换为字符串 “None”，这在非原生 jinja2 中没有用处。
以下单个模板化操作的示例显示了此行为
{{ 'ansible' | regex_search('foobar') }}
此示例不会导致 Python None，因此 Ansible 历史上将其转换为 "" （空字符串）。
原生 jinja2 功能实际上允许我们返回完整的 Python 对象，这些对象始终表示为到处都是 Python 对象，因此使用 regex_search 的单个模板化操作的结果可能会导致 Python None。
注意
当 regex_search 用作中间结果，然后与 jinja2 none 测试进行比较时，不需要原生 jinja2 功能。
{{ 'ansible' | regex_search('foobar') is none }}
如何提交文档更改？
Ansible 的文档保存在主项目 Git 存储库中，有关贡献的完整说明可以在文档 README 中找到，可在 GitHub 上查看。谢谢！
ansible.legacy 和 ansible.builtin 集合之间有什么区别？
两者都不是真正的集合。它们是由核心引擎虚拟构建的（合成集合）。
ansible.builtin 集合仅指随 ansible-core 提供的插件。
ansible.legacy 集合是 ansible.builtin 的超集（您可以通过 ansible.legacy 引用来自 builtin 的插件）。您还可以在 配置的路径和相邻目录 中添加“自定义”插件，并能够覆盖具有相同名称的内置插件。
此外，当您不指定 FQCN 时，默认情况下会得到 ansible.legacy。所以这个
- shell: echo hi
实际上等同于
- ansible.legacy.shell: echo hi
但是，如果您不覆盖 shell 模块，您也可以将其写为 ansible.builtin.shell，因为 legacy 将解析为 builtin 集合。
我在这里没有看到我的问题
如果您没有找到问题的答案，请咨询社区！请访问Ansible 通信指南了解详情。
另请参阅
- 使用剧本
剧本简介
- Ansible 技巧和窍门
剧本的技巧和窍门
- 通信
有问题？需要帮助？想分享您的想法？请访问 Ansible 通信指南