Ansible 2.6 移植指南 

本节讨论 Ansible 2.5 和 Ansible 2.6 之间的行为更改。

旨在帮助您更新 Playbook、插件和 Ansible 基础设施的其他部分，使其与此版本的 Ansible 一起使用。

我们建议您阅读此页面以及 Ansible 2.6 的更新日志，以了解您可能需要进行的更新。

本文档是关于移植的集合的一部分。完整的移植指南列表可以在移植指南中找到。

Playbook 

已弃用的任务选项 always_run 已被删除，请改用 check_mode: no。

已弃用 

在 nxos_igmp_interface 模块中，oif_prefix 和 oif_source 属性已弃用。请改用带有前缀和源的字典的 ois_ps 参数。

模块 

此处详细介绍了常用模块的重大更改

已移除的模块 

以下模块不再存在

弃用通知 

以下模块将在 Ansible 2.10 中删除。请相应地更新您的 Playbook。

k8s_raw 请改用 k8s。
openshift_raw 请改用 k8s。
openshift_scale 请改用 k8s_scale。

值得注意的模块更改 

win_chocolatey 的 upgrade 模块选项已被删除；请改用 state: latest。
win_feature 的 reboot 模块选项已被删除；请改用 win_reboot 操作插件。
win_iis_webapppool 模块不再接受 attributes 模块选项的字符串；请改用自由格式的字典值。
win_package 的 name 模块选项已被删除；它在任何地方都不使用，应该直接从你的 Playbook 中删除。
win_regedit 模块不再自动将 hive 路径 HCCC 更正为 HKCC；请使用 HKCC，因为这是正确的 hive 路径。
file – 管理文件和文件属性现在，当指定 src 时，如果状态不是 hard 或 link，则会发出弃用警告，因为它只应该在这些情况下有用。这可能会对那些依赖 src 和其他状态之间的错误交互将文件放置到子目录中的人产生影响。例如
```
$ ansible localhost -m file -a 'path=/var/lib src=/tmp/ state=directory'
```
将创建一个名为 /tmp/lib 的目录。而不是上面的，只需拼出整个目标路径，如下所示
```
$ ansible localhost -m file -a 'path=/tmp/lib state=directory'
```
k8s_raw 和 openshift_raw 模块已被别名为新的 k8s 模块。
k8s 模块支持所有 Kubernetes 资源，包括来自自定义资源定义和聚合 API 服务器的资源。这包括所有 OpenShift 资源。
k8s 模块不接受子键已使用蛇形命名法的资源。这是 k8s_raw 和 openshift_raw 模块建议使用的一种解决方法。
k8s 模块可能不接受已更改 api_version 以匹配 Kubernetes Python 客户端中缩短版本的资源。您现在应该为资源指定正确的完整 Kubernetes api_version。
如果使用 src 参数传递，k8s 模块现在可以处理多文档 YAML 文件。它会将每个文档作为单独的资源处理。使用 resource_definition 参数内联提供的资源仍然必须是单个文档。
k8s 模块不会像 openshift_raw 模块那样自动将 Project 创建请求更改为 ProjectRequest 创建请求。现在您必须显式指定 ProjectRequest 类型。
k8s 模块不会自动从 Ansible 返回值（以及扩展的日志）中删除密钥。为了防止记录任务中的密钥值，请在任务块上指定 no_log 参数。
k8s_scale 模块现在支持可扩展的 OpenShift 对象，例如 DeploymentConfig。
当使用空字符串作为正则表达式时，lineinfile 模块已更改为显示警告。由于空正则表达式匹配文件中的每一行，它将替换文件中的最后一行，而不是插入。如果这是期望的行为，请使用 '^'，它将匹配每一行，并且不会触发警告。
Openstack 模块不再使用 shade 库。而是使用 openstacksdk。由于 openstacksdk 应该已经作为 shade 的依赖项存在，因此不需要其他操作。

插件 

弃用通知 

以下模块将在 Ansible 2.10 中删除。请相应地更新您的 Playbook。

openshift 请改用 k8s。

值得注意的插件更改 

k8s 查找插件现在支持所有 Kubernetes 资源，包括来自自定义资源定义和聚合 API 服务器的资源。这包括所有 OpenShift 资源。
k8s 查找插件可能不接受已更改 api_version 以匹配 Kubernetes Python 客户端中缩短版本的资源。您现在应该为资源指定正确的完整 Kubernetes api_version。
k8s 查找插件将不再从 Ansible 返回值（以及扩展日志）中删除密钥。为了防止任务中的密钥值被记录，请在任务块上指定 no_log 参数。

移植自定义脚本 

没有显著的变化。

网络 

没有显著的变化。

动态清单脚本 

contrib/inventory/openstack.py 已重命名为 contrib/inventory/openstack_inventory.py。如果您已将 openstack.py 用作 OpenStack 动态清单文件的名称，请将其更改为 openstack_inventory.py。否则，文件名将与来自 openstacksdk 的导入冲突。