Ansible 7 移植指南

Ansible 7 基于 Ansible-core 2.14。

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

Playbook

  • 现在，变量是延迟求值的；仅在实际使用时才求值。例如，在 ansible-core 2.14 中，表达式 {{ defined_variable or undefined_variable }} 如果 or 的第一部分求值为 True，则不会因为 undefined_variable 而失败，因为它不需要求值第二部分。一个需要注意的特殊行为变化是以下使用 undefined 测试的任务。在 2.14 版本之前，这将导致访问字典中未定义的值时发生致命错误。在 2.14 中，断言通过，因为该字典通过其未定义的值之一被评估为未定义。

- assert:
    that:
      - some_defined_dict_with_undefined_values is undefined
  vars:
    dict_value: 1
    some_defined_dict_with_undefined_values:
      key1: value1
      key2: '{{ dict_value }}'
      key3: '{{ undefined_dict_value }}'

命令行

  • 此版本对控制器节点上的 Python 3.9 有硬性要求。

  • 启动时，会检查文件系统编码和区域设置，以验证它们是否为 UTF-8。如果不是，则该进程将退出并报告错误的编码。如果您之前使用 C 或 POSIX 区域设置，则可以使用 C.UTF-8。如果您之前使用诸如 en_US.ISO-8859-1 之类的区域设置，则可以使用 en_US.UTF-8。为简单起见，使用 LC_ALL 环境变量导出适当的区域设置可能是最简单的。修改系统区域设置的另一种方法是在 UTF-8 模式下运行 Python；有关更多信息，请参见Python 文档。

已弃用

无明显变化

模块

无明显变化

已移除模块

以下模块不再存在

  • 无明显变化

弃用通知

无明显变化

值得注意的模块变更

无明显变化

插件

无明显变化

移植自定义脚本

无明显变化

网络

无明显变化

v7.7.0 移植指南

重大变更

cloudscale_ch.cloud

  • 将最低要求的 Ansible 版本提升至 2.13.0

fortinet.fortimanager

  • 支持 6.2、6.4、7.0、7.2 和 7.4 中的所有 FortiManager 版本。139 个新模块。

  • 支持基于令牌的身份验证。

fortinet.fortios

  • 改进某些模块中的no_log功能；

  • 改进fortios_router_static中seq_num的文档和示例；

  • 改进所有模块中member_path的文档；

  • 支持新的 FOS 版本。

已移除特性

community.ciscosmb

  • 删除对 Python 2.6 和 2.7 的测试

  • 删除对 ansible 2.9 的测试

已弃用特性

community.ciscosmb

  • 对 Python 2.6 和 2.7 的支持

  • 对 ansible 2.9 的支持

microsoft.ad

  • 弃用对 Server 2012 和 Server 2012 R2 的支持。这些操作系统版本正接近微软的生命周期结束状态，并且在 Ansible 中使用它们的支持即将结束。

purestorage.fusion

  • fusion_api_client - ‘app_id’ 和 ‘key_file’ 参数已被弃用，转而使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并且将在 2.0.0 版本中删除，FUSION_APP_ID 和 FUSION_HOST 环境变量已被弃用，转而使用 FUSION_ISSUER_ID 和 FUSION_HOST，并且将在 2.0.0 版本中删除

  • fusion_array - ‘app_id’ 和 ‘key_file’ 参数已被弃用，转而使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并且将在 2.0.0 版本中删除，FUSION_APP_ID 和 FUSION_HOST 环境变量已被弃用，转而使用 FUSION_ISSUER_ID 和 FUSION_HOST，并且将在 2.0.0 版本中删除

  • fusion_az - ‘app_id’ 和 ‘key_file’ 参数已被弃用，转而使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并且将在 2.0.0 版本中删除，FUSION_APP_ID 和 FUSION_HOST 环境变量已被弃用，转而使用 FUSION_ISSUER_ID 和 FUSION_HOST，并且将在 2.0.0 版本中删除

  • fusion_hap - ‘app_id’ 和 ‘key_file’ 参数已被弃用，转而使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并且将在 2.0.0 版本中删除，FUSION_APP_ID 和 FUSION_HOST 环境变量已被弃用，转而使用 FUSION_ISSUER_ID 和 FUSION_HOST，并且将在 2.0.0 版本中删除

  • fusion_hap - 参数 nqn、wwns、host_password、host_user、target_password` 和 `target_user 已被弃用

  • fusion_hw - FUSION_APP_ID 和 FUSION_HOST 环境变量已被弃用，转而使用 FUSION_ISSUER_ID 和 FUSION_HOST，并且将在 2.0.0 版本中删除

  • fusion_info - ‘app_id’ 和 ‘key_file’ 参数已被弃用，转而使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并且将在 2.0.0 版本中删除，FUSION_APP_ID 和 FUSION_HOST 环境变量已被弃用，转而使用 FUSION_ISSUER_ID 和 FUSION_HOST，并且将在 2.0.0 版本中删除

  • fusion_info - ‘hosts’ 子集已被弃用，转而使用 ‘host_access_policies’，并且将在 2.0.0 版本中删除

  • fusion_info - ‘interfaces’ 子集已被弃用，转而使用 ‘network_interfaces’，并且将在 2.0.0 版本中删除

  • fusion_info - ‘zones’ 子集已被弃用，转而使用 ‘availability_zones’，并且将在 2.0.0 版本中删除

  • fusion_ni - ‘app_id’ 和 ‘key_file’ 参数已被弃用，转而使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并且将在 2.0.0 版本中删除，FUSION_APP_ID 和 FUSION_HOST 环境变量已被弃用，转而使用 FUSION_ISSUER_ID 和 FUSION_HOST，并且将在 2.0.0 版本中删除

  • fusion_nig - ‘app_id’ 和 ‘key_file’ 参数已被弃用，转而使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并且将在 2.0.0 版本中删除，FUSION_APP_ID 和 FUSION_HOST 环境变量已被弃用，转而使用 FUSION_ISSUER_ID 和 FUSION_HOST，并且将在 2.0.0 版本中删除

  • fusion_pg - ‘app_id’ 和 ‘key_file’ 参数已弃用，建议使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并将在 2.0.0 版本中移除。FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

  • fusion_pp - ‘app_id’ 和 ‘key_file’ 参数已弃用，建议使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并将在 2.0.0 版本中移除。FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

  • fusion_ra - ‘app_id’ 和 ‘key_file’ 参数已弃用，建议使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并将在 2.0.0 版本中移除。FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

  • fusion_region - ‘app_id’ 和 ‘key_file’ 参数已弃用，建议使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并将在 2.0.0 版本中移除。FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

  • fusion_sc - ‘app_id’ 和 ‘key_file’ 参数已弃用，建议使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并将在 2.0.0 版本中移除。FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

  • fusion_se - ‘app_id’ 和 ‘key_file’ 参数已弃用，建议使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并将在 2.0.0 版本中移除。FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

  • fusion_se - endpoint_type 参数现已弃用，并将在 2.0.0 版本中移除。

  • fusion_ss - ‘app_id’ 和 ‘key_file’ 参数已弃用，建议使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并将在 2.0.0 版本中移除。FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

  • fusion_tenant - ‘app_id’ 和 ‘key_file’ 参数已弃用，建议使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并将在 2.0.0 版本中移除。FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

  • fusion_tn - FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

  • fusion_ts - ‘app_id’ 和 ‘key_file’ 参数已弃用，建议使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并将在 2.0.0 版本中移除。FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

  • fusion_volume - ‘app_id’ 和 ‘key_file’ 参数已弃用，建议使用 ‘issuer_id’ 和 ‘private_key_file’ 参数，并将在 2.0.0 版本中移除。FUSION_APP_ID 和 FUSION_HOST 环境变量已弃用，建议使用 FUSION_ISSUER_ID 和 FUSION_HOST，并将在 2.0.0 版本中移除。

v7.6.0 移植指南

已知问题

community.docker

重大更改

community.postgresql

infoblox.nios_modules

  • 添加了网格主候选功能 #152

  • 添加了将成员分配给网络和范围的功能 #152

  • 添加了具有创建、更新和删除功能的 NIOS 范围模块 #152

  • 修复了使用 Ansible 插件无法更新/删除 EA 的问题 #180

  • 修复了 A 记录的 IPV4 地址的静态和动态分配问题 #182

  • 修复了更新 NIOS 成员主机名的问题 #176

  • 将默认 WAPI 版本更新为 2.9 #176

已弃用功能

community.crypto

v7.5.0 移植指南

已添加的集合

  • microsoft.ad (版本 1.0.0)

已弃用功能

cisco.ios

  • ios_bgp_address_family - 弃用 redistribute.ospf.match.external，改用 redistribute.ospf.match.externals，后者启用 OSPF 类型 E1 和 E2 路由的属性

  • ios_bgp_address_family - 弃用 redistribute.ospf.match.nssa_external，改用 redistribute.ospf.match.nssa_externals，后者启用 OSPF 类型 N1 和 N2 路由的属性

  • ios_bgp_address_family - 弃用 redistribute.ospf.match.type_1，改用 redistribute.ospf.match.nssa_externals.type_1

  • ios_bgp_address_family - 弃用 redistribute.ospf.match.type_2，改用 redistribute.ospf.match.nssa_externals.type_2

v7.4.0 移植指南

重大更改

Ansible-core

  • ansible-test - 当在 ansible-test 管理的主机环境中运行时，依赖于特定文件权限的集成测试可能需要进行更改。需要 755 或 644 之外的权限的测试可能需要更新，以便在测试运行期间设置必要的权限。

重大更改

community.hrobot

community.vmware

fortinet.fortios

  • 为每个模块添加成员操作的注释。

  • 更新 fortios.py 以获得更高的性能；

  • 支持临时会话密钥和登录前/后横幅；

  • 更新关于如何在问答中使用成员操作的示例。

purestorage.fusion

  • 资源属性的修补已与底层 Python SDK 保持一致

  • fusion_volume - 已修复并重新组织，参数已更改

已弃用功能

amazon.aws

  • 已弃用通过混合使用环境变量和参数传递配置文件和安全令牌的支持，并且将在 6.0.0 版本中移除此支持。在 6.0.0 版本之后，无论使用何种机制传递，都只能传递配置文件或安全令牌之一。要显式阻止来自环境变量的参数，请将空字符串作为参数值传递。最初在 1.2.0 版本中已弃用同时传递配置文件和安全令牌的支持，但仅在 5.0.0 版本中部分实现（https://github.com/ansible-collections/amazon.aws/pull/1355）。

community.aws

community.hashi_vault

purestorage.fusion

  • fusion_hw - 硬件模块正在被删除，因为 Pure Storage Fusion 从未支持过更改硬件类型。

  • fusion_info - nigs 子集已被弃用，推荐使用 network_interface_groups，并且将在 1.7.0 版本中删除。

  • fusion_info - placements 子集已被弃用，推荐使用 placement_groups，并且将在 1.7.0 版本中删除。

  • fusion_pg - placement_engine 选项已弃用，因为 Fusion API 不再支持此参数。它将在 2.0.0 版本中删除。

  • fusion_se - 参数 ‘addresses’、‘gateway’ 和 ‘network_interface_groups’ 已被弃用，推荐使用 ‘iscsi’，并且将在 2.0.0 版本中删除。

  • fusion_tn - 租户网络正在被存储端点 `fusion_se` 和网络接口组 `fusion_nig` 取代。

v7.3.0 的移植指南

重大更改

hetzner.hcloud

  • inventory 插件 - 现在需要 Python v3.5+。

主要更改

kubernetes.core

已弃用功能

community.general

v7.2.0 的移植指南

新增集合

  • dellemc.powerflex (版本 1.5.0)

  • dellemc.unity (版本 1.5.0)

已知问题

Ansible-core

  • ansible-test - 某些容器主机和容器组合可能需要额外的配置。更多详细信息请参考测试文档。

  • ansible-test - 带有 VOLUME 指令的自定义容器可能无法启动，而以前容器可以正确启动。删除 VOLUME 指令以解决此问题。具有此情况的容器将导致 ansible-test 发出警告。

  • ansible-test - 具有 Podman 网络问题的系统可能无法运行容器，而以前该问题未被报告。更正网络问题以继续将 ansible-test 与 Podman 一起使用。

  • ansible-test - 在具有 SELinux 的系统上使用 Docker 可能需要将 SELinux 设置为允许模式。Podman 应该可以在强制模式下使用 SELinux。

cisco.meraki

  • meraki_network - 更新了 local_status_page_enabled 和 remote_status_page_enabled 的文档，因为这些不再起作用。

重大更改

community.general

  • ModuleHelper 模块实用程序 - 当模块设置名为 msg、exception、output、vars 或 changed 的输出变量时，实际输出将仅在它们与 ModuleHelper 本身生成的输出变量冲突时，才使用 _ （下划线符号）作为这些名称的前缀，这种情况仅在处理异常时发生。请注意，此重大更改不需要新的主要版本，因为在此版本之前，由于 一个错误，无法将此类变量添加到输出中（https://github.com/ansible-collections/community.general/pull/5765）。

主要更改

Ansible-core

  • ansible-test - 现在支持 WSL2 上的 Docker Desktop（需要额外的配置）。

  • ansible-test - 现在在具有 cgroup v2 统一的宿主机上支持 Docker 和 Podman。以前仅支持 cgroup v1 和 cgroup v2 混合。

  • ansible-test - Podman 现在可以在没有 systemd 的容器主机上工作。以前仅某些容器可以工作，而其他容器需要 rootfull 或 rootless Podman，但两者都无法工作。有些容器根本无法工作。

  • ansible-test - 现在支持 WSL2 上的 Podman。

  • ansible-test - 当容器主机上需要额外的 cgroup 设置时，将自动检测到这一点。错误消息中将提供有关如何配置主机的说明。

ansible.windows

  • 将此集合支持的最低 Ansible 版本设置为 Ansible 2.12

chocolatey.chocolatey

  • win_chocolatey - 允许用户选择用于引导 Chocolatey 安装的 TLS 版本。

已弃用功能

chocolatey.chocolatey

  • win_chocolatey - 弃用并行安装。

cisco.ios

  • ios_bgp_address_family - 弃用 neighbors.address/tag/ipv6_adddress，改用 neighbor_address，以便为 facts 渲染启用通用属性

  • ios_bgp_address_family - 弃用 neighbors.password，改用 password_options，以便允许加密和密码

  • ios_bgp_address_family - 弃用 slow_peer，改用 slow_peer_options，以便支持字典属性

community.dns

community.general

community.hashi_vault

v7.1.0 版本的移植指南

新增集合

  • grafana.grafana (版本 1.1.0)

已知问题

community.routeros

  • api_modify - 当 queue tree 中条目的限制被定义为人类可读的格式（例如 25M）时，配置将在 ROS 中正确设置，但即使没有进行任何更改，模块也会在每次运行时指示该项已更改。这是由 ROS API 引起的，它返回的数字是以字节为单位的，例如 25000000（这与 CLI 行为不一致）。为了缓解这种情况，限制必须以字节为单位定义（这些限制仍然会以人类可读的格式显示在 ROS CLI 中）（https://github.com/ansible-collections/community.routeros/pull/131）。

  • api_modify, api_info - routing ospf area、routing ospf area range、routing ospf instance、routing ospf interface-template 路径由于 ROS6 和 ROS7 之间的重大更改而未完全为 ROS6 实现（https://github.com/ansible-collections/community.routeros/pull/131）。

重大更改

cisco.meraki

  • meraki_mr_l7_firewall - 新模块

  • meraki_webhook_payload_template - 新模块

community.zabbix

  • 所有模块都将放弃使用 zabbix-api，而改用 httpapi ansible.netcommon 插件。为了向后兼容，我们将支持 zabbix-api，直到下一个主要版本。有关如何迁移的更多信息，请参阅我们的 README.md 文件

  • zabbix_agent 和 zabbix_proxy 角色都将放弃使用 zabbix-api，而改用 httpapi ansible.netcommon 插件。为了向后兼容，我们将支持 zabbix-api，直到下一个主要版本。有关如何迁移的更多信息，请参阅我们的 README.md 文件

containers.podman

  • 新的 become 插件 - podman_unshare

  • Podman 生成 systemd 模块

fortinet.fortios

  • 支持 FortiOS v7.0.6、v7.0.7、v7.0.8、v7.2.1、v7.2.2。

已弃用的功能

community.general

  • sap 模块 sapcar_extract、sap_task_list_execute 和 hana_query 将在 community.general 7.0.0 中从此集合中移除，并替换为重定向到 community.sap_libs 的重定向。如果您想继续使用这些模块，请确保同时安装 community.sap_libs（它是 Ansible 包的一部分）（https://github.com/ansible-collections/community.general/pull/5614）。

v7.0.0 版本的移植指南

新增集合

  • ibm.spectrum_virtualize (版本 1.10.0)

  • inspur.ispim (版本 1.2.0)

  • lowlydba.sqlserver (版本 1.0.4)

  • purestorage.fusion (版本 1.1.1)

  • vultr.cloud (版本 1.3.1)

已知问题

community.routeros

  • community.routeros.command 模块声称支持检查模式。由于它无法判断执行的命令是否修改了状态，因此这种行为是不正确的。由于这可能会破坏现有的 playbook，我们不会在 community.routeros 3.0.0 之前更改此行为。

dellemc.openmanage

  • idrac_user - 问题(192043) 该模块可能会报错，并显示消息 无法执行导入或导出操作，因为存在待处理的属性更改或配置作业正在进行中。请等待作业完成并再次运行该任务。

  • ome_application_alerts_smtp - 问题(212310) - 如果 destination_address 的字符数超过 255 个，则该模块不会提供正确的错误消息。

  • ome_application_alerts_syslog - 问题(215374) - 如果 destination_address 的字符数超过 255 个，则该模块不会提供正确的错误消息。

  • ome_device_local_access_configuration - 问题(215035) - 如果为参数 timeout_limit 提供了不受支持的值，则该模块会报告 已成功更新本地访问设置。但是，此值实际上并未在 OpenManage Enterprise Modular 上应用。

  • ome_device_local_access_configuration - 问题(217865) - 如果为参数 user_defined 和 lcd_language 提供了不受支持的值，则该模块不会显示正确的错误消息。

  • ome_device_network_services - 问题(212681) - 如果为参数 port_number、community_name、max_sessions、max_auth_retries 和 idle_timeout 提供了不受支持的值，则该模块不会提供正确的错误消息。

  • ome_device_power_settings - 问题(212679) - 如果为参数 power_cap 提供的值不在 0 到 32767 的支持范围内，则该模块会显示以下消息：由于PowerCap不存在或不适用于资源URI，因此无法完成请求。

  • ome_device_quick_deploy - 问题(216352) - 如果为 ipv6_prefix_length 和 vlan_id 参数提供了不受支持的值，则该模块不会显示正确的错误消息。

  • ome_smart_fabric_uplink - 问题(186024) - 该模块不允许创建多个同名的上行链路，即使 OpenManage Enterprise Modular 支持这样做。如果使用与现有上行链路相同的名称创建上行链路，则会修改现有上行链路。

netapp.ontap

  • na_ontap_snapshot - 添加了文档，说明如何为 expiry_time 使用 UTC 格式。

重大更改

  • Ansible 7 要求控制器上的 Python 版本为 3.9，与 ansible-core 2.14 相同。

Ansible-core

  • 允许延迟计算 Jinja2 表达式（https://github.com/ansible/ansible/issues/56017）

  • 默认的 ansible-galaxy 角色骨架不再包含 .travis.yml 文件。您可以配置 ansible-galaxy 使用包含 .travis.yml 文件的自定义角色骨架，以继续使用 Galaxy 与 Travis CI 的集成。

  • ansible - 在启动时，会检查文件系统编码和区域设置以验证它们是否为 UTF-8。如果不是，则该进程将退出并显示报告错误编码的错误信息。

  • ansible - 将 CLI 工具和控制器代码的最低 Python 要求提高到 Python 3.9

  • ansible-test - 在启动时，会检查文件系统编码以验证是否为 UTF-8。如果不是，进程将退出并报告错误的编码。

  • ansible-test - 在启动时，区域设置会被配置为 en_US.UTF-8，并回退到 C.UTF-8。如果这两个编码都不可用，进程将退出并报错。如果使用了回退，则会显示警告。在以前的版本中，总是请求 en_US.UTF-8 区域设置。但是，没有执行启动检查来验证是否已成功配置区域设置。

  • ansible-test validate-modules - 在验证模块中删除了 missing-python-doc 错误代码，对于缺少 PowerShell 模块文档，改用 missing-documentation。

  • 策略插件 - 使 ignore_unreachable 增加 ignored 和 ok 计数器，而不是 skipped 和 unreachable。（https://github.com/ansible/ansible/issues/77690）

amazon.aws

check_point.mgmt

  • cp_mgmt_access_role - ‘machines’ 参数现在接受单个 str，并添加了一个新的 dict 类型参数 ‘machines_list’。‘users’ 参数现在接受单个 str，并添加了一个新的 dict 类型参数 ‘users_list’。

  • cp_mgmt_access_rule - ‘vpn’ 参数现在接受单个 str，并添加了一个新的 dict 类型参数 ‘vpn_list’。‘position_by_rule’ 参数已更改为 ‘relative_position’，支持在节上方/下方定位（而不仅仅是规则）。‘relative_position’ 参数还具有 ‘top’ 和 ‘bottom’ 子选项，允许分别将规则定位在节的顶部和底部。添加了一个新的参数 ‘search_entire_rulebase’，以允许相对定位不受限制（以前限制为 50 条规则）。

  • cp_mgmt_administrator - ‘permissions_profile’ 参数现在接受单个 str，并添加了一个新的 dict 类型参数 ‘permissions_profile_list’。

  • cp_mgmt_publish - ‘uid’ 参数已删除。

community.aws

  • 以 aws: 开头的标签在清除标签时不会被删除，这些标签由 Amazon 保留，可能无法更新或删除（https://github.com/ansible-collections/amazon.aws/issues/817）。

  • acm_certificate - 之前已弃用的默认值 purge_tags=False 已更新为 purge_tags=True (https://github.com/ansible-collections/community.aws/pull/1343)。

  • autoscaling_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.autoscaling_group。

  • autoscaling_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.autoscaling_group_info。

  • aws_secret - 当未设置 tags 参数时，不再删除标签。要删除所有标签，请设置 tags={} (https://github.com/ansible-collections/community.aws/issues/1146)。

  • cloudfront_distribution - 之前已弃用的默认值 purge_tags=False 已更新为 purge_tags=True (https://github.com/ansible-collections/community.aws/pull/1343)。

  • cloudtrail - 该模块已迁移到 amazon.aws 集合。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudtrail。

  • cloudwatch_metric_alarm - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudwatch_metric_alarm。

  • cloudwatchevent_rule - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudwatchevent_rule。

  • cloudwatchlogs_log_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudwatchlogs_log_group。

  • cloudwatchlogs_log_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudwatchlogs_log_group_info。

  • cloudwatchlogs_log_group_metric_filter - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudwatchlogs_log_group_metric_filter。

  • community.aws 集合 - 已放弃对 ansible-core < 2.11 的支持 (https://github.com/ansible-collections/community.aws/pull/1541)。

  • community.aws 集合 - community.aws 集合现在已放弃对原始 boto AWS SDK 的支持和任何要求，现在使用 boto3/botocore AWS SDK (https://github.com/ansible-collections/community.aws/pull/898)。

  • community.aws 集合 - community.aws 集合已放弃对 botocore<1.21.0 和 boto3<1.18.0 的支持。大多数模块将继续使用旧版本的 AWS SDK，但是不保证与旧版本 SDK 的兼容性，也不会进行测试。当使用旧版本的 SDK 时，Ansible 会发出警告 (https://github.com/ansible-collections/community.aws/pull/1362)。

  • community.aws 集合 - profile 参数现在与 aws_access_key、aws_secret_key 和 security_token 参数互斥 (https://github.com/ansible-collections/amazon.aws/pull/834)。

  • ec2_eip - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_eip。

  • ec2_eip_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_eip_info。

  • ec2_vpc_route_table - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_route_table。

  • ec2_vpc_route_table_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_route_table_info。

  • ec2_vpc_vpn - 之前已弃用的默认值 purge_tags=False 已更新为 purge_tags=True (https://github.com/ansible-collections/community.aws/pull/1343)。

  • elb_application_lb - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.elb_application_lb。

  • elb_application_lb_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.elb_application_lb_info。

  • elb_instance - 已删除 ec2_elbs 事实，已将 updated_elbs 添加到返回值中，并包含相同的信息 (https://github.com/ansible-collections/community.aws/pull/1173)。

  • elb_network_lb - state 的默认值已从 absent 更改为 present (https://github.com/ansible-collections/community.aws/pull/1167)。

  • execute_lambda - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.execute_lambda。

  • iam_policy - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_policy。

  • iam_policy_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_policy_info。

  • iam_server_certificate - 已删除将文件名传递给 cert、chain_cert 和 key 参数的操作。我们建议使用查找插件来读取文件，请参阅文档中的示例 (https://github.com/ansible-collections/community.aws/pull/1265)。

  • iam_server_certificate - dup_ok 参数的默认值已更改为 true。要保留原始行为，请将 dup_ok 参数显式设置为 false (https://github.com/ansible-collections/community.aws/pull/1265)。

  • iam_user - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_user。

  • iam_user_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_user_info。

  • kms_key - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.kms_key。

  • kms_key - 之前已弃用使用 policy_mode 和 policy_grant_types 管理 KMS IAM 策略，现在已被删除，建议使用 policy 选项 (https://github.com/ansible-collections/community.aws/pull/1344)。

  • kms_key - 之前已弃用的默认值 purge_tags=False 已更新为 purge_tags=True (https://github.com/ansible-collections/community.aws/pull/1343)。

  • kms_key_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.kms_key_info。

  • lambda - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda。

  • lambda_alias - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda_alias。

  • lambda_event - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda_event。

  • lambda_execute - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda_execute。

  • lambda_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda_info。

  • lambda_policy - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda_policy。

  • rds_cluster - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_cluster。

  • rds_cluster_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_cluster_info。

  • rds_cluster_snapshot - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_cluster_snapshot。

  • rds_instance - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_instance。

  • rds_instance_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_instance_info。

  • rds_instance_snapshot - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_instance_snapshot。

  • rds_option_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_option_group。

  • rds_option_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_option_group_info。

  • rds_param_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_param_group。

  • rds_param_group - 之前已弃用的默认值 purge_tags=False 已更新为 purge_tags=True (https://github.com/ansible-collections/community.aws/pull/1343)。

  • rds_snapshot_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_snapshot_info。

  • rds_subnet_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_subnet_group。

  • route53 - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.route53。

  • route53_health_check - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.route53_health_check。

  • route53_health_check - 之前已弃用的默认值 purge_tags=False 已更新为 purge_tags=True (https://github.com/ansible-collections/community.aws/pull/1343)。

  • route53_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.route53_info。

  • route53_zone - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.route53_zone。

  • route53_zone - 之前已弃用的默认值 purge_tags=False 已更新为 purge_tags=True (https://github.com/ansible-collections/community.aws/pull/1343)。

  • script_inventory_ec2 - ec2.py 清单脚本已移动到新的存储库。该脚本现在可以从 https://github.com/ansible-community/contrib-scripts/blob/main/inventory/ec2.py 下载，并且已从此集合中删除。我们建议从该脚本迁移到 amazon.aws.ec2 清单插件。( https://github.com/ansible-collections/community.aws/pull/898)

  • sqs_queue - 之前已弃用的默认值 purge_tags=False 已更新为 purge_tags=True (https://github.com/ansible-collections/community.aws/pull/1343)。

community.docker

community.general

community.hashi_vault

community.vmware

  • 移除了对 ansible-core 版本 < 2.13.0 的支持。

  • vmware_dvs_portgroup - 向 in_traffic_shaping 参数添加了一个新的子选项 inherited。这意味着您可以不定义该参数来保持设置不变，但如果您想在 PG 级别覆盖它，则必须将设置定义为非 inherited (https://github.com/ansible-collections/community.vmware/pull/1483)。

  • vmware_dvs_portgroup - 向 out_traffic_shaping 参数添加了一个新的子选项 inherited。这意味着您可以不定义该参数来保持设置不变，但如果您想在 PG 级别覆盖它，则必须将设置定义为非 inherited (https://github.com/ansible-collections/community.vmware/pull/1483)。

  • vmware_dvs_portgroup - 将 net_flow 的类型更改为字符串，以允许将其隐式设置为 inherited 或保持值不变。这意味着您可以不定义该参数来保持设置不变，但虽然 true 或 no 仍然有效，但 True 或 Off（大写）将不起作用 (https://github.com/ansible-collections/community.vmware/pull/1483)。

  • vmware_dvs_portgroup - 移除对 vSphere API 低于 6.7 的支持。

  • vmware_dvs_portgroup - 移除 network_policy 的默认值，并添加一个新的子选项 inherited。这意味着您可以不定义该参数来保持设置不变，但如果您想在 PG 级别覆盖它，则必须将设置定义为非 inherited (https://github.com/ansible-collections/community.vmware/pull/1483)。

  • vmware_dvs_portgroup_info - 移除对 vSphere API 低于 6.7 的支持。

  • vmware_dvswitch - 移除对 vSphere API 低于 6.7 的支持。

  • vmware_dvswitch_uplink_pg - 移除对 vSphere API 低于 6.7 的支持。

  • vmware_guest_boot_manager - 移除 secure_boot_enabled 参数的默认值 (https://github.com/ansible-collections/community.vmware/issues/1461)。

  • vmware_vm_config_option - 结果中的字典项名称从以空格连接的字符串更改为以下划线连接的字符串，例如，Guest fullname 更改为 guest_fullname (https://github.com/ansible-collections/community.vmware/issues/1268)。

  • vmware_vspan_session - 移除对 vSphere API 低于 6.7 的支持。

dellemc.enterprise_sonic

  • bgp_af - 将 route_advertise_list 字典添加到 argspec，以替换此集合 1.x 分支上用于 SONiC 3.x 映像的已删除的、过时的 advertise_prefix 属性。此更改对应于 BGP AF REST API 的 SONiC 4.0 OC YANG REST 合规性更改。它允许指定与每个路由通告前缀结合使用的路由映射 (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/63)。

  • bgp_af - 从 argspec 和配置代码中删除过时的 'advertise_prefix' 属性。此更改以及随后使用新的路由通告列表参数结构进行的共同要求替换，需要在以前用于配置 SONiC 3.x 映像的路由通告前缀的 playbook 中进行相应的更改。( https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/60)

  • bgp_neighbors - 将先前定义的独立 “bfd” 属性替换为包含多个属性的 bfd 字典。此更改对应于修订后的 SONiC 4.x OC YANG 兼容 REST API 实现。先前使用 SONiC 3.x 映像的 bfd 属性的 playbook 必须修改为在 SONiC 4.0 映像上使用，以使用 bfd 属性 argspec 结构的新定义 (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/72)。

  • bgp_neighbors - 对于 BGP 对等组，将先前定义的独立 “bfd” 属性替换为包含多个属性的 bfd 字典。此更改对应于修订后的 SONiC 4.x OC YANG 兼容 REST API 实现。先前使用 SONiC 3.x 映像的 bfd 属性的 playbook 必须修改为在 SONiC 4.0 映像上使用，以使用 bfd 属性 argspec 结构的新定义 (https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/81)。

重大更改

Ansible-core

  • 将处理程序处理移动到新的 PlayIterator 阶段，以使用配置的策略 (https://github.com/ansible/ansible/issues/65067)

  • ansible - 在启动时，会检查文件系统编码和区域设置以验证它们是否为 UTF-8。如果不是，则该进程将退出并显示报告错误编码的错误信息。

  • ansible - 将 CLI 工具和控制器代码的最低 Python 要求提高到 Python 3.9

  • ansible-test - 在启动时，会检查文件系统编码以验证是否为 UTF-8。如果不是，进程将退出并报告错误的编码。

  • ansible-test - 在启动时，区域设置会被配置为 en_US.UTF-8，并回退到 C.UTF-8。如果这两个编码都不可用，进程将退出并报错。如果使用了回退，则会显示警告。在以前的版本中，总是请求 en_US.UTF-8 区域设置。但是，没有执行启动检查来验证是否已成功配置区域设置。

amazon.aws

  • amazon.aws 集合 - amazon.aws 集合已停止支持 botocore<1.20.0 和 boto3<1.17.0。大多数模块将继续使用旧版本的 AWS SDK，但是不保证与旧版本的 SDK 兼容，也不会进行测试。使用旧版本的 SDK 时，Ansible 将发出警告 (https://github.com/ansible-collections/amazon.aws/pull/574)。

  • autoscaling_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.autoscaling_group。

  • autoscaling_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.autoscaling_group_info。

  • cloudtrail - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.cloudtrail。

  • cloudwatch_metric_alarm - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudwatch_metric_alarm。

  • cloudwatchevent_rule - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudwatchevent_rule。

  • cloudwatchlogs_log_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudwatchlogs_log_group。

  • cloudwatchlogs_log_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudwatchlogs_log_group_info。

  • cloudwatchlogs_log_group_metric_filter - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.cloudwatchlogs_log_group_metric_filter。

  • ec2_eip - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_eip。

  • ec2_eip_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_eip_info。

  • elb_application_lb - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.elb_application_lb。

  • elb_application_lb_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.elb_application_lb_info。

  • execute_lambda - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.execute_lambda。

  • iam_policy - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_policy。

  • iam_policy_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_policy_info。

  • iam_user - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_user。

  • iam_user_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_user_info。

  • kms_key - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.kms_key。

  • kms_key_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.kms_key_info。

  • lambda - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda。

  • lambda_alias - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda_alias。

  • lambda_event - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda_event。

  • lambda_execute - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda_execute。

  • lambda_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda_info。

  • lambda_policy - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.lambda_policy。

  • rds_cluster - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_cluster。

  • rds_cluster_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_cluster_info。

  • rds_cluster_snapshot - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_cluster_snapshot。

  • rds_instance - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_instance。

  • rds_instance_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_instance_info。

  • rds_instance_snapshot - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_instance_snapshot。

  • rds_option_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_option_group。

  • rds_option_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_option_group_info。

  • rds_param_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_param_group。

  • rds_snapshot_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_snapshot_info。

  • rds_subnet_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.rds_subnet_group。

  • route53 - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.route53。

  • route53_health_check - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.route53_health_check。

  • route53_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.route53_info。

  • route53_zone - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.route53_zone。

arista.eos

  • 删除以下 EOS 已弃用的模块

  • 在此集合中的任何模块上，使用 connection: local 和 provider 选项不再有效。

  • eos_interface

  • eos_l2_interface

  • eos_l3_interface

  • eos_linkagg

  • eos_static_route

  • eos_vlan

check_point.mgmt

  • plugins/httpapi/checkpoint - 支持带有新变量“ansible_cloud_mgmt_id”的 Smart-1 Cloud

chocolatey.chocolatey

  • win_chocolatey - 添加了 bootstrap_script 选项，允许用户将脚本 URL 定位到客户端上安装 Chocolatey。

  • win_chocolatey_facts - 将过时软件包列表添加到返回的数据中。

cisco.asa

  • 请使用以下连接类型之一 - network_cli、httpapi 或 netconf。

  • 这包括以下模块

  • 此版本放弃了对 connection: local 和 provider 字典的支持。

  • 此版本删除了所有已达到生命周期结束的已弃用插件。

  • 在此集合中的任何模块上，使用 connection: local 和 provider 选项不再有效。

  • asa_acl

  • asa_og

cisco.ios

  • 此集合的唯一有效连接类型是 network_cli。

  • 此版本放弃了对 connection: local 和 provider 字典的支持。

cisco.iosxr

  • 此集合的唯一有效连接类型是 network_cli 和 netconf。

  • 此版本放弃了对 connection: local 和 provider 字典的支持。

cisco.nxos

  • 请使用以下连接类型之一 - network_cli、httpapi 或 netconf。

  • 此版本放弃了对 connection: local 和 provider 字典的支持。

community.aws

  • community.aws 集合 - amazon.aws 集合已停止支持 botocore<1.20.0 和 boto3<1.17.0。大多数模块将继续使用旧版本的 AWS SDK，但是不保证与旧版本的 SDK 兼容，也不会进行测试。使用旧版本的 SDK 时，Ansible 将发出警告 (https://github.com/ansible-collections/community.aws/pull/956)。

community.docker

community.general

  • 集合的内部结构已针对模块和操作插件进行了更改。它们不再位于按主题排序的目录层次结构中，而是现在全部位于一个单独的（扁平）目录中。这不会对用户产生影响假设他们没有使用内部 FQCN。这些仍然可以工作，但会导致弃用警告。它们从未得到官方支持，因此保留重定向是一种礼貌，并且这不被标记为重大更改。请注意，例如，Ansible VScode 插件开始推荐这些内部名称。如果您遵循了它的建议，现在必须改回短名称以避免弃用警告，以及将来可能会出现的错误，因为这些重定向将在 community.general 9.0.0 中删除 (https://github.com/ansible-collections/community.general/pull/5461)。

  • newrelic_deployment - 删除了 New Relic v1 API，增加了对 v2 API 的支持 (https://github.com/ansible-collections/community.general/pull/5341)。

community.mysql

  • mysql_db - pipefail 参数的默认值将在 community.mysql 4.0.0 中更改为 true。如果您的目标机器不使用 bash 作为默认解释器，请显式地将 pipefail 设置为 false。但是，我们强烈建议将 bash 设置为默认值，并将 pipefail=true，因为它会保护您免受您不知道的损坏的转储 (https://github.com/ansible-collections/community.mysql/issues/407)。

community.network

  • community.network 集合不再支持 Ansible 2.9 和 ansible-base 2.10。虽然我们不会采取任何积极措施来阻止使用，但我们将删除兼容性代码和其他兼容性措施，这些措施实际上会阻止将此集合中的大多数内容与 Ansible 2.9 一起使用，并将此集合中的某些内容与 ansible-base 2.10 一起使用。Ansible 2.9 和 ansible-base 2.10 都很快将结束生命周期，如果您仍在使用它们，应尽快考虑升级到 ansible-core 2.11 或更高版本 (https://github.com/ansible-collections/community.network/pull/426)。

  • 集合的内部结构已针对模块和操作插件进行了更改。它们不再位于按主题排序的目录层次结构中，而是现在全部位于一个单独的（扁平）目录中。这不会对用户产生影响假设他们没有使用内部 FQCN。这些仍然可以工作，但会导致弃用警告。它们从未得到官方支持，因此保留重定向是一种礼貌，并且这不被标记为重大更改。请注意，例如，Ansible VScode 插件开始推荐这些内部名称。如果您遵循了它的建议，现在必须改回短名称以避免弃用警告，以及将来可能会出现的错误，因为这些重定向将在 community.network 8.0.0 中删除 (https://github.com/ansible-collections/community.network/pull/482)。

community.postgresql

dellemc.enterprise_sonic

dellemc.openmanage

  • 添加了用于创建执行环境的集合元数据。

  • 重构了 Markdown (MD) 文件和内容，以提高可读性。

  • 以下模块已弃用 share 参数：idrac_network、idrac_timezone_ntp、dellemc_configure_idrac_eventing、dellemc_configure_idrac_services、dellemc_idrac_lc_attributes、dellemc_system_lockdown_mode。

  • idrac_bios - 此模块已增强，支持清除待处理的 BIOS 属性、将 BIOS 重置为默认设置以及使用 Redfish 配置 BIOS 属性。

  • idrac_boot - 支持在 iDRAC 上配置引导设置。

  • idrac_redfish_storage_controller - 此模块已增强，支持 LockVirtualDisk 操作。

  • idrac_virtual_media - 此模块允许配置远程文件共享设置。

  • ome_device_group - 此模块已增强，支持从静态设备组中删除设备。

  • ome_devices - 支持在 OpenManage Enterprise 上执行特定于设备的操作。

fortinet.fortimanager

  • 修复了 ansible 2.9.x 和 ansible-base 2.10.x 的兼容性问题。

  • 修复了许多 Ansible 健全性测试警告和错误。

  • 支持 FortiManager Schema 7.2.0，新增 98 个模块

  • 支持 Ansible 变更日志。

fortinet.fortios

  • 支持 check_mode 中的 Diff 功能。

  • 支持 Fortios 7.2.0。

infoblox.nios_modules

  • 额外的安全层功能，在 playbook 中使用 cert 和 key 参数，通过证书和密钥 *.pem 文件绝对路径进行身份验证 #154

  • 修复了由于 Ansible 模块 nios 网络删除网络时模板属性导致的问题 #147

  • 更新 TXT 记录的 text 字段 #128

  • 对于在 old_name 中使用虚拟名称（系统中不存在）的对象，使用 old_name 和 new_name 进行更新操作将不会在系统中创建新对象。将抛出一个错误，说明该对象在系统中不存在 #129

junipernetworks.junos

  • 在此集合中的任何模块上，使用 connection: local 和 provider 选项不再有效。

vyos.vyos

  • 在此集合中的任何模块上，使用 connection: local 和 provider 选项不再有效。

已删除的集合

  • servicenow.servicenow（之前包含的版本：1.0.6）

已删除的功能

Ansible-core

amazon.aws

ansible.netcommon

  • napalm - 删除未使用的连接插件。

  • net_banner - 请改用 <network_os>_banner。

  • net_interface - 请改用 <network_os>_interfaces。

  • net_l2_interface - 请改用 <network_os>_l2_interfaces。

  • net_l3_interface - 请改用 <network_os>_l3_interfaces。

  • net_linkagg - 请改用 <network_os>_lag_interfaces。

  • net_lldp - 请改用 <network_os>_lldp_global。

  • net_lldp_interface - 请改用 <network_os>_lldp_interfaces。

  • net_logging - 请改用 <network_os>_logging_global。

  • net_static_route - 请改用 <network_os>_static_routes。

  • net_system - 请改用 <network_os>_system。

  • net_user - 请改用 <network_os>_user。

  • net_vlan - 请改用 <network_os>_vlans。

  • net_vrf - 请改用 <network_os>_vrf。

cisco.ios

  • ios_interface - 请改用 ios_interfaces。

  • ios_l2_interface - 请改用 ios_l2_interfaces。

  • ios_l3_interface - 请改用 ios_l3_interfaces。

  • ios_static_route - 请改用 ios_static_routes。

  • ios_vlan - 请改用 ios_vlans。

cisco.iosxr

  • iosxr_interface - 请改用 iosxr_interfaces。

cisco.nxos

  • 此版本删除了以下已达到生命周期终止的已弃用插件。

  • nxos_acl

  • nxos_acl_interface

  • nxos_interface

  • nxos_interface_ospf

  • nxos_l2_interface

  • nxos_l3_interface

  • nxos_linkagg

  • nxos_lldp

  • nxos_ospf

  • nxos_ospf_vrf

  • nxos_smu

  • nxos_static_route

  • nxos_vlan

community.aws

community.azure

community.docker

community.general

community.network

community.vmware

junipernetworks.junos

  • 移除以下已弃用的 Junos 模块。

  • junos_interface

  • junos_l2_interface

  • junos_l3_interface

  • junos_linkagg

  • junos_lldp

  • junos_lldp_interface

  • junos_static_route

  • junos_vlan

vyos.vyos

  • vyos_interface - 请改用 vyos_interfaces。

  • vyos_l3_interface - 请改用 vyos_l3_interfaces。

  • vyos_linkagg - 请改用 vyos_lag_interfaces。

  • vyos_lldp - 请改用 vyos_lldp_global。

  • vyos_lldp_interface - 请改用 vyos_lldp_interfaces。

  • vyos_static_route - 请改用 vyos_static_routes。

已弃用的功能

Ansible-core

  • 弃用查找插件返回任意数据的能力。查找插件必须返回列表，否则将在 2.18 中报错。( https://github.com/ansible/ansible/issues/77788 )

  • 加密 - 弃用使用 Python crypt 模块，因为它即将从 Python 3.13 中删除

  • PlayContext.verbosity 已弃用，将在 2.18 中移除。请使用 ansible.utils.display.Display().verbosity 作为唯一真实来源。

  • DEFAULT_FACT_PATH、DEFAULT_GATHER_SUBSET 和 DEFAULT_GATHER_TIMEOUT 已弃用，将在 2.18 中移除。请改用 module_defaults 关键字。

  • PlayIterator - 弃用 cache_block_tasks 和 get_original_task，它们是无操作且未使用的。

  • Templar - 弃用未使用的 shared_loader_obj 选项。将直接使用 ansible.plugins.loader。

  • listify_lookup_plugin_terms，弃用未使用的 'loader/dataloader' 参数。

  • vars 插件 - 使用类属性 REQUIRES_WHITELIST 来确定是否运行 ansible.legacy vars 插件已弃用，请改为设置 REQUIRES_ENABLED。

amazon.aws

cisco.ios

  • 已弃用 ios_linkagg_module，推荐使用 ios_lag_interfaces。

cisco.mso

  • mso_schema_template_contract_filter 的 contract_filter_type 属性已被弃用。该值现在从 filter_type 推断得出。

community.aws

  • aws_acm - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True。

  • aws_codebuild - tags 参数当前使用非标准格式，已被弃用。在 6.0.0 版本中，此参数将接受简单的键/值对字典，而不是当前使用的字典列表。建议迁移到使用 resource_tags 参数，该参数已经接受简单的字典格式 ( https://github.com/ansible-collections/community.aws/pull/1221 )。

  • aws_glue_connection - connection_parameters 返回键已被弃用，将在 2024-06-01 之后的版本中移除，它将被 raw_connection_parameters 键替换 ( https://github.com/ansible-collections/community.aws/pull/518 )。

  • aws_kms - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True。

  • cloudfront_distribution - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True。

  • community.aws 集合 - 由于 AWS SDK 宣布停止支持 Python 3.7 以下版本 ( https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/ )，此集合对 Python 3.7 以下版本的支持已被弃用，将在 2023-05-31 之后的版本中移除 ( https://github.com/ansible-collections/community.aws/pull/1361 )。

  • ec2_vpc_vpn - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True。

  • iam_policy - policies 返回值已重命名为 policy_names，将在 2024-08-01 之后的版本中移除，目前两个值都会返回 ( https://github.com/ansible-collections/community.aws/pull/1375 )。

  • lambda_info - function 返回键返回一个字典的字典，已被弃用。在 2025-01-01 之后的版本中，此键将被移除，取而代之的是 functions，它返回一个字典列表 ( https://github.com/ansible-collections/community.aws/pull/1239 )。

  • rds_param_group - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True。

  • route53_health_check - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True。

  • route53_info - DelegationSets、CheckerIpRanges 和 HealthCheck 的 CamelCase 返回值已被弃用，在未来的版本中，必须使用 snake_case 返回值 delegation_sets、checker_ip_ranges 和 health_check 代替 ( https://github.com/ansible-collections/community.aws/pull/1322 )。

  • route53_info - HostedZones、ResourceRecordSets 和 HealthChecks 的 CamelCase 返回值已被弃用，在未来的版本中，必须使用 snake_case 返回值 hosted_zones、resource_record_sets 和 health_checks 代替。

  • route53_zone - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True。

  • sqs_queue - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True。

community.crypto

  • 对 Ansible 2.9 和 ansible-base 2.10 的支持已被弃用，将在下一个主要版本 (community.crypto 3.0.0) 中移除。某些模块可能仍然可以在这些版本之后工作，但我们将不再保留支持它们所需的兼容性代码 ( https://github.com/ansible-collections/community.crypto/pull/460 )。

community.docker

  • 对 Docker API 1.20 到 1.24 版本的支持已被弃用，将在 community.docker 3.0.0 中移除。第一个支持 API 1.25 版本的 Docker 版本是 2017 年 1 月发布的 Docker 1.13。这会影响 docker_container、docker_container_exec、docker_container_info、docker_compose、docker_login、docker_image、docker_image_info、docker_image_load、docker_host_info、docker_network、docker_network_info、docker_node_info、docker_swarm_info、docker_swarm_service、docker_swarm_service_info、docker_volume_info 和 docker_volume 模块，它们支持的最低 API 版本在 1.20 到 1.24 之间 ( https://github.com/ansible-collections/community.docker/pull/396 )。

  • 对 Python 2.6 的支持已被弃用，将在下一个主要版本 (community.docker 3.0.0) 中移除。某些模块可能仍然可以在 Python 2.6 上工作，但我们将不再尝试确保兼容性 ( https://github.com/ansible-collections/community.docker/pull/388 )。

  • docker_container - ignore_image 选项已被弃用，将在 community.docker 4.0.0 中移除。请在 comparisons 中使用 image: ignore 代替 ( https://github.com/ansible-collections/community.docker/pull/487 )。

  • docker_container - purge_networks 选项已被弃用，将在 community.docker 4.0.0 中移除。请在 comparisons 中使用 networks: strict 代替，并确保提供 networks，如果应删除所有网络，则值为 [] ( https://github.com/ansible-collections/community.docker/pull/487 )。

community.general

community.hashi_vault