Python 3 支持

Ansible 2.5 及更高版本支持 Python 3。在 2.5 之前，使用 Python 3 被认为是技术预览。本主题讨论如何设置您的控制节点和受管机器以使用 Python 3。

在控制节点端

使用 Python 3 版本的 pip 安装 /usr/bin/ansible 是在 Python 3 下运行 /usr/bin/ansible 的最简单方法。这将使默认的 /usr/bin/ansible 使用 Python3 运行

$ pip3 install ansible
$ ansible --version | grep "python version"
  python version = 3.10.5 (main, Jun 9 2022, 00:00:00) [GCC 12.1.1 20220507 (Red Hat 12.1.1-1)] (/usr/bin/python)

如果您正在运行 Ansible 从克隆运行 devel 分支并且希望使用 Python 3 进行源代码检出，请通过 python3 运行您的命令。例如

$ source ./hacking/env-setup
$ python3 $(which ansible) localhost -m ping
$ python3 $(which ansible-playbook) sample-playbook.yml

注意

各个 Linux 发行版软件包可能针对 Python2 或 Python3 进行打包。从发行版软件包运行时，您只能使用 Ansible 与其安装的 Python 版本一起使用。有时，发行版将提供一种针对多个 Python 版本安装的方法（通过单独的软件包或通过安装后运行的一些命令）。您需要检查您的发行版以查看这种情况是否适用于您的情况。

使用命令和剧本在受管机器上使用 Python 3

Ansible 将自动检测并在许多附带它的平台上使用 Python 3。要明确配置 Python 3 解释器，请在组或主机级别将 ansible_python_interpreter 清单变量设置为 Python 3 解释器的位置，例如 /usr/bin/python3。默认解释器路径也可以在 ansible.cfg 中设置。

另请参见

解释器发现了解更多信息。

# Example inventory that makes an alias for localhost that uses Python3
localhost-py3 ansible_host=localhost ansible_connection=local ansible_python_interpreter=/usr/bin/python3

# Example of setting a group of hosts to use Python3
[py3_hosts]
ubuntu16
fedora27

[py3_hosts:vars]
ansible_python_interpreter=/usr/bin/python3

另请参见

如何构建您的清单了解更多信息。

运行您的命令或剧本

$ ansible localhost-py3 -m ping
$ ansible-playbook sample-playbook.yml

请注意，您还可以使用 -e 命令行选项在运行命令时手动设置 python 解释器。如果您想测试特定模块或剧本在 Python 3 下是否存在任何错误，这将很有用。例如

$ ansible localhost -m ping -e 'ansible_python_interpreter=/usr/bin/python3'
$ ansible-playbook sample-playbook.yml -e 'ansible_python_interpreter=/usr/bin/python3'

如果发现不兼容性，该怎么办

我们已经花费了几个版本来解决错误并添加新的测试，以便 Ansible 的核心功能集可以在 Python 2 和 Python 3 下运行。但是，错误仍然可能存在于边缘情况下，并且许多与 Ansible 一起提供的模块由社区维护，并非所有这些模块都可能移植。

如果您在 Python 3 下运行时发现错误，您可以在 Ansible 的 GitHub 项目上提交错误报告。请务必在错误报告中提及 Python3，以便合适的人员查看它。

如果您想修复代码并在 github 上提交拉取请求，您可以参考 Ansible 和 Python 3，了解有关如何在 Ansible 代码库中修复常见 Python3 兼容性问题的更多信息。