Ansible 7 移植指南

Ansible 7 基于 Ansible-core 2.14。

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

剧本

  • 变量现在是延迟评估的；只有在它们实际使用时才会进行评估。例如，在 ansible-core 2.14 中，表达式 {{ defined_variable or undefined_variable }} 不会在 undefined_variable 上失败，如果 or 的第一部分评估为 True，因为它不需要评估第二部分。需要注意的一个行为变化的特殊情况是下面使用 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

  • 清单插件 - 现在需要 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 - 使用 neighbor_address 弃用 neighbors.address/tag/ipv6_adddress，它为事实渲染启用了公共属性。

  • ios_bgp_address_family - 使用 password_options 弃用 neighbors.password，它允许加密和密码。

  • ios_bgp_address_family - 使用 slow_peer_options 弃用 slow_peer，它支持字典属性。

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 实现，因为 ROS6 和 ROS7 之间存在重大更改 (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 声称支持检查模式。由于它无法判断执行的命令是否修改状态，因此此行为不正确。由于这可能会破坏现有的剧本，因此我们不会在 community.routeros 3.0.0 之前更改此行为。

dellemc.openmanage

  • idrac_user - Issue(192043) 模块可能会出现错误，并显示消息 unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress。等待作业完成，然后再次运行任务。

  • ome_application_alerts_smtp - Issue(212310) - 如果 destination_address 超过 255 个字符，模块不会提供适当的错误消息。

  • ome_application_alerts_syslog - Issue(215374) - 如果 destination_address 超过 255 个字符，模块不会提供适当的错误消息。

  • ome_device_local_access_configuration - Issue(215035) - 如果为参数 timeout_limit 提供不支持的值，模块将报告 Successfully updated the local access setting。但是，此值实际上并没有应用于 OpenManage Enterprise Modular。

  • ome_device_local_access_configuration - Issue(217865) - 如果为 user_defined 和 lcd_language 参数提供不支持的值，模块不会显示适当的错误消息。

  • ome_device_network_services - Issue(212681) - 如果为参数 port_number、community_name、max_sessions、max_auth_retries 和 idle_timeout 提供不支持的值，模块不会提供适当的错误消息。

  • ome_device_power_settings - Issue(212679) - 如果为参数 power_cap 提供的值不在支持范围 0 到 32767 之内，模块将显示以下消息：Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI.

  • ome_device_quick_deploy - Issue(216352) - 如果为 ipv6_prefix_length 和 vlan_id 参数提供不支持的值，模块不会显示适当的错误消息。

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

netapp.ontap

  • na_ontap_snapshot - 添加了文档以使用 UTC 格式 expiry_time。

重大变更

  • 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 - 从 validate 模块中删除了 missing-python-doc 错误代码，missing-documentation 用于缺少 PowerShell 模块文档。

  • 策略插件 - 将 ignore_unreachable 更改为增加 ignored 和 ok 计数器，而不是 skipped 和 unreachable。(https://github.com/ansible/ansible/issues/77690)

amazon.aws

check_point.mgmt

  • cp_mgmt_access_role - ‘machines’ 参数现在接受单个字符串，并添加了类型为字典的新参数 ‘machines_list’。‘users’ 参数现在接受单个字符串，并添加了类型为字典的新参数 ‘users_list’。

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

  • cp_mgmt_administrator - ‘permissions_profile’ 参数现在接受单个字符串，并添加了类型为字典的新参数 ‘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 集合迁移。使用此模块的完整限定集合名的剧本应更新为使用 amazon.aws.autoscaling_group。

  • autoscaling_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完整限定集合名的剧本应更新为使用 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 集合。使用此模块的完整限定集合名的剧本应更新为使用 amazon.aws.cloudtrail。

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

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

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

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

  • cloudwatchlogs_log_group_metric_filter - 该模块已从 community.aws 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 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，并且不再依赖该 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 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 amazon.aws.ec2_eip。

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

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

  • ec2_vpc_route_table_info - 该模块已从 community.aws 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 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 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 amazon.aws.elb_application_lb。

  • elb_application_lb_info - 该模块已从 community.aws 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 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 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 amazon.aws.execute_lambda。

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

  • iam_policy_info - 该模块已从 community.aws 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 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 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 amazon.aws.iam_user。

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

  • kms_key - 该模块已从 community.aws 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 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 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 amazon.aws.kms_key_info。

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

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

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

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

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

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

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

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

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

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

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

  • rds_instance_snapshot - 该模块已从 community.aws 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 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 的类型更改为字符串，以允许将其隐式设置为继承或保持值不变。这意味着您可以通过不定义参数来保持设置不变，但也意味着虽然 true 或 no 仍然有效，但 True 或 Off（大写）将无效 (https://github.com/ansible-collections/community.vmware/pull/1483).

  • vmware_dvs_portgroup - 已删除对小于 6.7 的 vSphere API 的支持。

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

  • vmware_dvs_portgroup_info - 已删除对小于 6.7 的 vSphere API 的支持。

  • vmware_dvswitch - 已删除对小于 6.7 的 vSphere API 的支持。

  • vmware_dvswitch_uplink_pg - 已删除对小于 6.7 的 vSphere API 的支持。

  • 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 - 已删除对小于 6.7 的 vSphere API 的支持。

dellemc.enterprise_sonic

  • bgp_af - 在 argspec 中添加了 route_advertise_list 字典，以替换已删除的、过时的 advertise_prefix 属性，该属性用于此集合的 1.x 分支上的 SONiC 3.x 映像。此更改对应于 SONiC 4.0 OC YANG REST 符合性更改，用于 BGP AF REST API。它允许在每个路由通告前缀与路由映射结合使用 (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 字典。此更改对应于 OC YANG 兼容 REST API 的修订版 SONiC 4.x 实现。以前在 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 字典。此更改对应于 OC YANG 兼容 REST API 的修订版 SONiC 4.x 实现。以前在 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 集合迁移。使用此模块的完整限定集合名的剧本应更新为使用 amazon.aws.autoscaling_group。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • rds_instance_snapshot - 该模块已从 community.aws 集合中迁移。使用此模块的完全限定集合名称的剧本应更新为使用 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 dprecated 模块

  • 在该集合中的任何模块上，使用 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) 文件和内容，以提高可读性。

  • 以下模块已弃用共享参数 - 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

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

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

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

  • 使用 old_name 和 new_name 更新操作的对象，其中使用虚拟名称在 old_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 3.13 中即将移除 Python crypt 模块，因此弃用其使用。

  • 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' 参数，因为该参数未被使用。

  • 变量插件 - 使用类属性 REQUIRES_WHITELIST 确定是否运行 ansible.legacy 变量插件已弃用，请改用 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 的驼峰式命名返回值已弃用，在将来的版本中，您必须分别使用蛇形命名返回值 delegation_sets、checker_ip_ranges 和 health_check (https://github.com/ansible-collections/community.aws/pull/1322).

  • route53_info - HostedZones、ResourceRecordSets 和 HealthChecks 的驼峰式命名返回值已弃用，在将来的版本中，您必须分别使用蛇形命名返回值 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

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 中移除。请使用 image: ignore 代替 comparisons 中的选项 (https://github.com/ansible-collections/community.docker/pull/487).

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

community.general

community.hashi_vault