常见问题解答

这里有一些常见问题及其答案。

所有模块都去哪里了？

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 运行速度可能会变慢，了解如何改进此问题的提示。

如何为任务或整个 playbook 设置 PATH 或任何其他环境变量？

可以使用 environment 关键字设置环境变量。它可以在 playbook 中的任务或其他级别使用。

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 任务也继承了 playbook 的 environment 指令，如果在 playbook 级别设置此指令，则可能需要使用 |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 使用原生 OpenSSH 进行连接，而不是 python paramiko 库。在 Ansible 1.2.1 及更高版本中，如果 OpenSSH 足够新以支持 ControlPersist 作为选项，则默认情况下将使用 ssh。

Paramiko 非常适合入门，但 OpenSSH 类型提供了许多高级选项。如果您使用此连接类型，则需要从支持 ControlPersist 的足够新的机器运行 Ansible。您仍然可以管理较旧的客户端。如果您使用的是 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]"'

当 Ansible 尝试连接到组 gatewayed 中的任何主机时，它会将这些参数附加到命令行。（这些参数会附加到 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 模块（包括使 Ansible 工作的核心模块）都是用 Python 编写的。

默认情况下，Ansible 假设它可以在远程系统上找到 /usr/bin/python，该解释器为 Python2 版本 2.6 或更高版本，或 Python3 版本 3.5 或更高版本。

在任何主机上设置清单变量 ansible_python_interpreter 将告诉 Ansible 自动将 Python 解释器替换为此值。因此，如果系统上的 /usr/bin/python 没有指向兼容的 Python 解释器，您可以指向系统上任何您想要的 Python。

某些平台可能默认只安装了 Python 3。如果它没有安装在 /usr/bin/python，则需要通过 ansible_python_interpreter 配置解释器的路径。尽管大多数核心模块都可以与 Python 3 一起使用，但可能有一些特殊用途的模块无法使用，或者您可能会在极端情况下遇到错误。作为临时解决方法，您可以在受管主机上安装 Python 2，并通过 ansible_python_interpreter 配置 Ansible 使用该 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 时，有时您可能会遇到诸如找不到包“libffi” 或致命错误：Python.h：没有这样的文件或目录之类的错误。这些错误通常是由缺少的包引起的，这些包是 Ansible 所需包的依赖项。例如，libffi 包是 pynacl 和 paramiko 的依赖项（Ansible -> paramiko -> pynacl -> libffi）。

为了解决这些依赖性问题，您可能需要使用操作系统自带的包管理器（例如 yum、dnf 或 apt）安装所需的包，或者如包安装指南中所述。

请参阅各个包的文档，了解此类依赖项及其安装方法。

常见平台问题

Red Hat 支持哪些客户平台？

很多！有关确切列表，请参阅此知识库文章。

在 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] 在调用 fork() 时可能正在另一个线程中进行。我们无法安全地调用它或在 fork() 子进程中忽略它。改为崩溃。在 objc_initializeAfterForkError 上设置断点以进行调试。错误！发现一个工作进程处于死机状态。

通常，推荐的解决方法是在 shell 中设置以下环境变量：

$ export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES

在 macOS 上作为目标运行

通过 SSH 管理具有 macOS Monterey 12、macOS Ventura 13 或更高版本的系统时，可能会发生以下错误：

错误

“eDSPermissionError” DS 错误：-14120 (eDSPermissionError)

这很好地表明尚未启用“允许远程用户完全访问磁盘”。

另请参阅

有关更多详细信息，请查看 Apple 官方用户指南文章。

在 BSD 上运行

另请参阅

使用 Ansible 管理 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 及更高版本中，您也可以在清单中按主机设置它，如下所示：
```
solaris1 ansible_remote_tmp=$HOME/.ansible/tmp
```
您可以将 ansible_shell_executable 设置为 POSIX 兼容 shell 的路径。例如，许多 Solaris 主机在 /usr/xpg4/bin/sh 位置有一个 POSIX shell，因此您可以在清单中这样设置：
```
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: 文件 /a/user1/.ansible/tmp/ansible-tmp-1548232945.35-274513842609025/AnsiballZ_stat.py 第 1 行中以 '\x83' 开头的非 UTF-8 代码，但未声明编码；有关详细信息，请参阅 https://pythonlang.cn/dev/peps/pep-0263/

要修复它，请在 /etc/ansible/ansible.cfg 中将 pipelining = True。
在目标主机上，在默认位置 /usr/bin/python 找不到 Python 解释器。

错误

/usr/bin/python：EDC5129I 没有这样的文件或目录

要解决此问题，请在您的清单中设置 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 未找到模块 libpython2.7.so。

在 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默认情况下会收集被管理机器的“facts”（事实信息），这些facts可以在剧本和模板中访问。要查看关于一台机器的所有可用facts的列表，您可以运行setup模块作为临时操作。

ansible -m setup hostname

这将打印出该特定主机所有可用facts的字典。您可能需要将输出传递给分页器。这并不包括清单变量或内部“魔术”变量。如果您需要的不只是“facts”，请参见下一个问题。

如何查看为我的主机定义的所有清单变量？

通过运行以下命令，您可以查看主机的清单变量。

ansible-inventory --list --yaml

如何查看我的主机特有的所有变量？

要查看所有主机特定变量，其中可能包括facts和其他来源。

ansible -m debug -a "var=hostvars['hostname']" localhost

除非您使用fact缓存，否则通常需要先使用收集facts的play，才能在上面的任务中包含facts。

如何在模板内循环遍历组中的主机列表？

一个常见的模式是在主机组内迭代主机列表，例如使用服务器列表填充模板配置文件。为此，您可以像这样访问模板中的“$groups”字典：

{% for host in groups['db_servers'] %}
    {{ host }}
{% endfor %}

如果您需要访问这些主机的facts，例如每个主机名的IP地址，则需要确保已填充facts。例如，确保您有一个与db_servers通信的play。

- hosts:  db_servers
  tasks:
    - debug: msg="doesn't matter what you do, just that they were talked to previously."

然后，您可以像这样在模板中使用facts：

{% 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模块具有递归参数。但是，如果您想对大量文件执行更高效的操作，请查看synchronize模块。synchronize模块包装了rsync。有关这两个模块的信息，请参阅模块索引。

如何访问shell环境变量？

**在控制节点机器上：** 使用env查找插件访问控制节点的现有变量。例如，要访问管理机器上HOME环境变量的值：

---
# ...
  vars:
     local_home: "{{ lookup('env','HOME') }}"

**在目标机器上：** 环境变量可通过ansible_env变量中的facts获得。

{{ ansible_env.HOME }}

如果您需要设置用于任务执行的环境变量，请参阅设置远程环境（位于高级剧本部分）。有几种方法可以在目标机器上设置环境变量。您可以使用template、replace或lineinfile模块将环境变量添加到文件中。要编辑的确切文件取决于您的操作系统、发行版和本地配置。

如何为user模块生成加密密码？

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 变量优先于事实）。
禁用INJECT_FACTS_AS_VARS配置设置，以防止事实值与变量冲突（这也将禁用原始警告）。

我可以参加 Ansible 培训吗？

是的！请访问我们的服务页面，了解我们的服务和培训产品信息。发送电子邮件至info@ansible.com 获取更多详细信息。

我们还会定期提供免费的基于 Web 的培训课程。请访问我们的网络研讨会页面，了解更多关于即将举行的网络研讨会的信息。

是否有 Web 界面/REST API/GUI？

是的！开源 Web 界面是 Ansible AWX。使 Ansible 更加强大和易于使用的受支持的 Red Hat 产品是Red Hat Ansible Automation Platform。

如何在我的剧本中保留秘密数据？

如果您想在 Ansible 内容中保留秘密数据，并且仍然公开共享它或将内容保存在源代码管理中，请参见使用加密变量和文件。

如果您有一个任务，在使用 -v（详细）模式时，您不想显示其结果或命令，则以下任务或剧本属性可能很有用。

- 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>，这将返回关键字的文档，包括一个具有值explicit（需要{{ }}）、implicit（假设{{ }}，因此不需要）或static（不支持模板化，所有字符都将按字面解释）的template字段。

当我委派任务时，如何获取原始 ansible_host？

如文档所述，连接变量取自delegate_to主机，因此ansible_host被覆盖，但您仍然可以通过hostvars访问原始主机。

original_host: "{{ hostvars[inventory_hostname]['ansible_host'] }}"

这适用于所有被覆盖的连接变量，例如ansible_user、ansible_port等等。

获取文件时如何修复“协议错误：文件名与请求不匹配”？

自从 OpenSSH 发布7.9p1版本以来，SCP 客户端中存在一个bug，当使用 SCP 作为文件传输机制时，它可能会在 Ansible 控制节点上触发此错误。

错误

无法将文件传输到 /tmp/ansible/file.txtrnprotocol error: file name does not match request

在这些版本中，SCP 尝试验证要获取的文件路径是否与请求的路径匹配。如果远程文件名需要引号来转义其路径中的空格或非 ASCII 字符，则验证将失败。为避免此错误

确保您使用的是 SFTP，它是安全、速度和可靠性的最佳传输方法。检查您是否正在执行以下操作之一：
- 依赖于默认设置，即smart——如果ssh_transfer_method未在任何地方显式设置，则此方法有效。
- 在清单中设置主机变量或组变量：ansible_ssh_transfer_method: smart
- 在控制节点上设置环境变量：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]部分。
如果必须使用 SCP，请设置-T参数以告诉 SCP 客户端忽略路径验证。您可以通过以下三种方式之一执行此操作：
- 设置主机变量或组变量：ansible_scp_extra_args=-T，
- 导出或传递环境变量：ANSIBLE_SCP_EXTRA_ARGS=-T
- 修改您的ansible.cfg文件：将scp_extra_args=-T添加到[ssh_connection]部分。

注意

如果在使用-T时看到invalid argument错误，则您的 SCP 客户端没有执行文件名验证，并且不会触发此错误。

Ansible 是否支持多因素身份验证 2FA/MFA/生物识别/指纹/USB 密钥/OTP/…？

不，Ansible 旨在对多个目标执行多个任务，从而最大限度地减少用户交互。与大多数自动化工具一样，它与旨在处理人工交互的交互式安全系统不兼容。大多数这些系统需要每个目标的二次提示，这会阻止扩展到数千个目标。它们还往往具有非常短的到期期限，因此需要频繁重新授权，这在许多主机和/或长时间的任务中也是一个问题。

在这样的环境中，我们建议确保 Ansible 的执行安全，但仍然允许它使用不需要此类措施的“自动化用户”。使用 AWX 或Red Hat Ansible Automation Platform，管理员可以设置对清单的 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

如何提交文档更改？

Ansible 的文档保存在主项目 Git 存储库中，完整的贡献说明可以在 GitHub 上查看的 docs README 中找到 GitHub 查看。谢谢！

`ansible.legacy`和`ansible.builtin`集合有什么区别？

两者都不是真正的集合。它们是由核心引擎虚拟构建的（合成集合）。

ansible.builtin集合仅指与ansible-core一起提供的插件。

ansible.legacy集合是ansible.builtin的超集（您可以通过ansible.legacy引用内置插件）。您还可以将“自定义”插件添加到配置的路径和相邻目录中，并能够覆盖具有相同名称的内置插件。

此外，当您未指定 FQCN 时，ansible.legacy是您默认获得的。

- shell: echo hi

实际上等同于

- ansible.legacy.shell: echo hi

但是，如果您不覆盖shell模块，您也可以将其写成ansible.builtin.shell，因为 legacy 将解析为内置集合。

我没有在这里看到我的问题

如果您没有找到问题的答案，请咨询社区！访问Ansible 通信指南了解更多详情。

另请参阅

使用剧本: 剧本简介
Ansible 提示和技巧: 剧本技巧
沟通: 有问题？需要帮助？想分享您的想法？请访问 Ansible 通信指南

常见问题解答

所有模块都去哪里了？

这个特定模块去哪里了？

如何在磁盘速度慢的系统上加快 Ansible 的速度？

如何为任务或整个 playbook 设置 PATH 或任何其他环境变量？

如何处理不同的机器需要不同的用户帐户或端口才能登录？

如何让 Ansible 重用连接、启用 Kerberized SSH 或让 Ansible 注意我的本地 SSH 配置文件？

如何配置跳板主机以访问我无法直接访问的服务器？

如何让 Ansible 及时发现失效的目标？

如何加快 Ansible 对云提供商（EC2、OpenStack 等）服务器的运行速度？

如何在远程机器上处理 /usr/bin/python 位置没有 Python 解释器的情况？

如何在 Ansible 安装期间处理 Ansible 包依赖项所需的包依赖项？

常见平台问题

Red Hat 支持哪些客户平台？

在 virtualenv 中运行

在 macOS 上作为控制节点运行

在 macOS 上作为目标运行

在 BSD 上运行

在 Solaris 上运行

在 z/OS 上运行

在 fakeroot 下运行

如何才能最好地使内容可重用/可再分发？

配置文件在哪里，以及我可以在其中配置什么？

如何禁用cowsay？

如何查看所有ansible_变量的列表？

如何查看为我的主机定义的所有清单变量？

如何查看我的主机特有的所有变量？

如何在模板内循环遍历组中的主机列表？

如何以编程方式访问变量名？

如何访问组变量？

如何访问组中第一个主机的变量？

如何将文件递归地复制到目标主机？

如何访问shell环境变量？

如何为user模块生成加密密码？

Ansible允许对变量使用点表示法和数组表示法。我应该使用哪种表示法？

何时从变量批量设置任务参数不安全？

我可以参加 Ansible 培训吗？

是否有 Web 界面/REST API/GUI？

如何在我的剧本中保留秘密数据？

我应该何时使用 {{ }}？另外，如何插入变量或动态变量名？

当我委派任务时，如何获取原始 ansible_host？

获取文件时如何修复“协议错误：文件名与请求不匹配”？

Ansible 是否支持多因素身份验证 2FA/MFA/生物识别/指纹/USB 密钥/OTP/…？

“validate”选项不足以满足我的需求，我该怎么办？

为什么regex_search过滤器返回None而不是空字符串？

如何提交文档更改？

ansible.legacy和ansible.builtin集合有什么区别？

我没有在这里看到我的问题

为什么`regex_search`过滤器返回None而不是空字符串？

`ansible.legacy`和`ansible.builtin`集合有什么区别？