Ansible 2.6 移植指南 

本节讨论 Ansible 2.5 和 Ansible 2.6 之间的行为变化。

旨在帮助您更新您的剧本、插件以及 Ansible 基础架构的其他部分，以便它们能够与此版本的 Ansible 兼容。

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

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

剧本 

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

已弃用 

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

模块 

此处详细介绍了常用模块中的主要更改

已移除的模块 

以下模块不再存在

弃用通知 

以下模块将在 Ansible 2.10 中移除。请相应更新您的剧本。

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 模块选项已移除；此选项未使用，应从您的剧本中删除。
win_regedit 模块不再自动将蜂巢路径 HCCC 校正为 HKCC；请使用 HKCC，因为这是正确的蜂巢路径。
file_module 在 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 模块不接受子键已使用 snake_case 命名方式的资源。这是一种针对 k8s_raw 和 openshift_raw 模块建议使用的变通方法。
k8s 模块可能不接受已更改 api_version 以匹配 Kubernetes Python 客户端中缩短版本的资源。您现在应该为资源指定正确的完整 Kubernetes api_version。
k8s 模块现在可以处理多文档 YAML 文件（如果它们与 src 参数一起传递）。它会将每个文档作为单独的资源进行处理。使用 resource_definition 参数内联提供的资源仍然必须是单个文档。
k8s 模块不会自动将 Project 创建请求更改为 ProjectRequest 创建请求，就像 openshift_raw 模块那样。您现在必须显式指定 ProjectRequest 类型。
k8s 模块不会自动从 Ansible 返回值（以及日志）中删除密钥。为了防止任务中的密钥值被记录，请在任务块上指定 no_log 参数。
k8s_scale 模块现在支持可缩放的 OpenShift 对象，例如 DeploymentConfig。
lineinfile 模块已更改，当使用空字符串作为正则表达式时会显示警告。由于空正则表达式匹配文件中的每一行，它将替换文件的最后一行而不是插入。如果这是所需的行为，请使用'^'，它将匹配每一行并且不会触发警告。
OpenStack 模块不再使用shade 库。而是使用openstacksdk。由于openstacksdk 应该已经作为shade 的依赖项存在，因此不需要额外的操作。

插件 

弃用通知 

以下模块将在 Ansible 2.10 中移除。请相应更新您的剧本。

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 的导入冲突。