Ansible 10 移植指南
Ansible 10 基于 Ansible-core 2.17。
我们建议您阅读此页面以及Ansible 10 更新日志,以了解您可能需要进行的更新。
Playbook
条件语句 - 由于在 ansible-core 2.16.1 中缓解了安全问题 CVE-2023-5764,当嵌入式模板从不受信任的来源(如模块结果或标记为
!unsafe
的变量)读取数据时,带有嵌入式模板块的条件表达式可能会失败,并显示消息“Conditional is marked as unsafe, and cannot be evaluated.
”。当引用不受信任的数据时,带有嵌入式模板的条件语句可能是恶意模板注入的来源,并且几乎总是可以在不使用嵌入式模板的情况下重写。Playbook 任务条件关键字(如when
和until
)长期以来一直显示警告,不鼓励在条件语句中使用嵌入式模板;此警告已扩展到非任务条件语句,如assert
操作。- name: task with a module result (always untrusted by Ansible) shell: echo "hi mom" register: untrusted_result # don't do it this way... # - name: insecure conditional with embedded template consulting untrusted data # assert: # that: '"hi mom" is in {{ untrusted_result.stdout }}' - name: securely access untrusted values directly as Jinja variables instead assert: that: '"hi mom" is in untrusted_result.stdout'
any_errors_fatal
- 当具有rescue
部分的块中的任务在主机上失败时,将在所有主机上执行rescue
部分。发生这种情况是因为any_errors_fatal
会自动使所有主机失败。
命令行
不再支持 Python 2.7 和 Python 3.6 作为远程版本。目标执行现在需要 Python 3.7+。
已弃用
无明显更改
模块
无明显更改
已移除的模块
以下模块不再存在
无明显更改
弃用通知
无明显更改
值得注意的模块变更
无明显更改
插件
无明显更改
移植自定义脚本
无明显更改
网络
无明显更改
v10.7.0 移植指南
已知问题
dellemc.openmanage
idrac_diagnostics - 问题 (285322) - 此模块不支持通过 SOCKS 代理将诊断文件导出到 HTTP 和 HTTPS 共享。
idrac_firmware - 问题 (279282) - 此模块不支持在 iDRAC8 上使用带有身份验证的 HTTP、HTTPS 和 FTP 共享进行固件更新。
ome_smart_fabric_uplink - 问题 (186024) - 该模块由 OpenManage Enterprise Modular 支持,但是不允许创建多个同名的上行链路。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
重大更改
取消了删除 netapp.storagegrid 的计划。该集合不会从 Ansible 11 中删除 (https://forum.ansible.com/t/2811)。该集合的维护已由 NetApp 的另一个团队接管。
dellemc.openmanage
omevv_baseline_profile - 此模块允许管理基线配置文件。
omevv_baseline_profile_info - 此模块允许检索基线配置文件信息。
omevv_compliance_info - 此模块允许检索固件合规性报告。
已弃用功能
集合
ibm.spectrum_virtualize
已重命名为ibm.storage_virtualize
。目前,Ansible 中包含这两个集合。该集合将从 Ansible 12 中完全删除。请将您的 FQCN 从ibm.spectrum_virtualize
更新为ibm.storage_virtualize
。
v10.6.0 移植指南
已知问题
dellemc.openmanage
idrac_diagnostics - 问题 (285322) - 此模块不支持通过 SOCKS 代理将诊断文件导出到 HTTP 和 HTTPS 共享。
idrac_firmware - 问题 (279282) - 此模块不支持在 iDRAC8 上使用带有身份验证的 HTTP、HTTPS 和 FTP 共享进行固件更新。
ome_smart_fabric_uplink - 问题 (186024) - 该模块由 OpenManage Enterprise Modular 支持,但是不允许创建多个同名的上行链路。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
重大更改
ansible.posix
放弃支持 Ansible 2.9,此版本最低需要 ansible-core 2.15
dellemc.openmanage
omevv_firmware_repository_profile - 此模块允许管理固件存储库配置文件。
omevv_firmware_repository_profile_info - 此模块允许检索固件存储库配置文件信息。
omevv_vcenter_info - 此模块允许检索 vCenter 信息。
fortinet.fortios
改进 SET 函数的逻辑,首先发送 GET 请求,然后发送 PUT 或 POST 请求
Mantis
支持新的 FOS 版本 7.6.0。
grafana.grafana
由 @HamzaKhait 在 https://github.com/grafana/grafana-ansible-collection/pull/247 中添加对 mimir 配置文件中的“distributor”部分的支持
由 @pjezek 在 https://github.com/grafana/grafana-ansible-collection/pull/276 中再次允许 alloy_user_groups 变量
由 @voidquark 在 https://github.com/grafana/grafana-ansible-collection/pull/281 中改进 Alloy 角色
由 @dependabot 在 https://github.com/grafana/grafana-ansible-collection/pull/270 中将 ansible-lint 从 24.6.0 升级到 24.9.2
由 @dependabot 在 https://github.com/grafana/grafana-ansible-collection/pull/273 中将 pylint 从 3.2.5 升级到 3.3.1
由 @pieterlexis-tomtom 在 https://github.com/grafana/grafana-ansible-collection/pull/264 中确保检查模式适用于 otel 收集器
由 @Nemental 在 https://github.com/grafana/grafana-ansible-collection/pull/256 中修复仪表板任务的消息参数
由 @Aethylred 在 https://github.com/grafana/grafana-ansible-collection/pull/209 中将 Alloy 变量更新为使用 grafana_alloy_ 命名空间,使其具有唯一性
由 @aioue 在 https://github.com/grafana/grafana-ansible-collection/pull/272 中更新 README.md
由 @aioue 在 https://github.com/grafana/grafana-ansible-collection/pull/275 中更新 README.md
由 @aioue 在 https://github.com/grafana/grafana-ansible-collection/pull/274 中更新 main.yml
由 @weakcamel 在 https://github.com/grafana/grafana-ansible-collection/pull/251 中将 grafana_plugins_ops 添加到默认值和文档中
由 @copolycube 在 https://github.com/grafana/grafana-ansible-collection/pull/249 中添加用于填充 google_analytics_4_id 值的选项
由 @copolycube 在 https://github.com/grafana/grafana-ansible-collection/pull/279 中修复关于禁止的隐式八进制值“0640”的 ansible-lint 警告
已弃用功能
community.network
集合已弃用。如果 Ansible 12 之前没有人再次开始维护它,它将从 Ansible 12 中删除。有关更多详细信息,请参阅 未维护集合的集合移除过程 (https://forum.ansible.com/t/8030)。由于违反了 Ansible 的收录要求,google.cloud 集合将从 Ansible 12 中移除。该集合存在未解决的健全性测试失败问题。有关更多详细信息,包括如何取消移除,请参阅不满足集合要求的集合移除流程(https://forum.ansible.com/t/8609)。
community.network
此集合及其中的所有内容均未维护且已弃用(https://forum.ansible.com/t/8030)。如果您有兴趣维护集合的某些部分,请将其复制到您自己的存储库中,并在论坛讨论中告知其他人。有关详细信息,请参阅集合创建者路径。
community.vmware
vmware_cluster_dpm - 该模块已弃用,将在 community.vmware 6.0.0 中移除(https://github.com/ansible-collections/community.vmware/pull/2217)。
vmware_cluster_drs_recommendations - 该模块已弃用,将在 community.vmware 6.0.0 中移除(https://github.com/ansible-collections/community.vmware/pull/2218)。
v10.5.0 的移植指南
已知问题
dellemc.openmanage
idrac_diagnostics - 问题 (285322) - 此模块不支持通过 SOCKS 代理将诊断文件导出到 HTTP 和 HTTPS 共享。
idrac_firmware - 问题 (279282) - 此模块不支持在 iDRAC8 上使用带有身份验证的 HTTP、HTTPS 和 FTP 共享进行固件更新。
idrac_storage_volume - 问题 (290766) - 如果同一控制器上已存在虚拟磁盘,则该模块将报告成功,而不是显示在 BOSS-N1 控制器上创建新虚拟磁盘的失败信息。
idrac_support_assist - 问题 (308550) - 当 NFS 共享路径包含子目录时,此模块将失败。
ome_diagnostics - 问题 (279193) - 在 OME 4.0.0 版本上,将 SupportAssist 收集日志导出到共享位置失败。
ome_smart_fabric_uplink - 问题 (186024) - 该模块由 OpenManage Enterprise Modular 支持,但是不允许创建多个同名的上行链路。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
主要更改
dellemc.openmanage
idrac_secure_boot - 此模块允许配置属性、导入或导出安全启动证书,以及重置密钥。
idrac_system_erase - 此模块允许擦除 iDRAC 上服务器的系统和存储组件。
已弃用功能
ngine_io.exoscale
集合已弃用。如果在 Ansible 11 之前没有人开始重新维护它,它将从 Ansible 11 中删除。有关更多详细信息,请参阅未维护集合的集合移除流程(https://forum.ansible.com/t/2572)。集合
t_systems_mms.icinga_director
已重命名为telekom_mms.icinga_director
。目前,这两个集合都包含在 Ansible 中。t_systems_mms.icinga_director
中的内容已在 Ansible 9.0.0 中替换为已弃用的重定向。该集合将从 Ansible 11 中完全删除。请将您的 FQCN 从t_systems_mms.icinga_director
更新为telekom_mms.icinga_director
。由于违反了 Ansible 的收录要求,sensu.sensu_go 集合将从 Ansible 12 中移除。该集合存在未解决的健全性测试失败问题。有关更多详细信息,包括如何取消移除,请参阅不满足集合要求的集合移除流程(https://forum.ansible.com/t/8380)。
community.general
hipchat - hipchat 服务已停止,自托管版本自 2020 年以来已终止生命周期。因此,该模块已弃用,如果没人提供仍然保留它的令人信服的理由,它将从 community.general 11.0.0 中删除(https://github.com/ansible-collections/community.general/pull/8919)。
v10.4.0 的移植指南
已知问题
dellemc.openmanage
idrac_diagnostics - 问题 (285322) - 此模块不支持通过 SOCKS 代理将诊断文件导出到 HTTP 和 HTTPS 共享。
idrac_firmware - 问题 (279282) - 此模块不支持在 iDRAC8 上使用带有身份验证的 HTTP、HTTPS 和 FTP 共享进行固件更新。
idrac_storage_volume - 问题 (290766) - 如果同一控制器上已存在虚拟磁盘,则该模块将报告成功,而不是显示在 BOSS-N1 控制器上创建新虚拟磁盘的失败信息。
idrac_support_assist - 问题 (308550) - 当 NFS 共享路径包含子目录时,此模块将失败。
ome_diagnostics - 问题 (279193) - 在 OME 4.0.0 版本上,将 SupportAssist 收集日志导出到共享位置失败。
ome_smart_fabric_uplink - 问题 (186024) - 该模块由 OpenManage Enterprise Modular 支持,但是不允许创建多个同名的上行链路。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
主要更改
dellemc.openmanage
idrac_secure_boot - 此模块允许导入安全启动证书。
idrac_support_assist - 此模块允许在 iDRAC 上运行和导出 SupportAssist 收集日志。
grafana.grafana
修复:mimir molecule 应该使用 ansible core 2.16,作者:@GVengelen,网址:https://github.com/grafana/grafana-ansible-collection/pull/254
已弃用功能
amazon.aws
iam_role - 使用
create_instance_profile
和delete_instance_profile
选项创建和删除 IAM 实例配置文件的支持已弃用,将在 2026-05-01 之后的版本中删除。要管理 IAM 实例配置文件,可以使用amazon.aws.iam_instance_profile
模块代替(https://github.com/ansible-collections/amazon.aws/pull/2221)。
community.general
MH 装饰器 cause_changes 模块实用程序 - 弃用参数
on_success
和on_failure
(https://github.com/ansible-collections/community.general/pull/8791)。pipx - 对早于
1.7.0
的命令行工具pipx
的版本的支持已弃用,将在 community.general 11.0.0 中删除(https://github.com/ansible-collections/community.general/pull/8793)。pipx_info - 对早于
1.7.0
的命令行工具pipx
的版本的支持已弃用,将在 community.general 11.0.0 中删除(https://github.com/ansible-collections/community.general/pull/8793)。
community.mysql
集合 - 对 mysqlclient 连接器的支持已弃用 - 请改用 PyMySQL 连接器!我们将在集合版本 4.0.0 中停止针对它进行测试,并在 5.0.0 中删除相关代码(https://github.com/ansible-collections/community.mysql/issues/654)。
mysql_info -
users_info
过滤器返回的变量plugin_auth_string
包含哈希密码,具有误导性,它将从 community.mysql 4.0.0 中删除。请改用 plugin_hash_string 返回值(https://github.com/ansible-collections/community.mysql/pull/629)。mysql_user -
name
参数的user
别名已弃用,将在集合版本 5.0.0 中删除。请改用name
参数。
community.vmware
vmware_cluster - 该模块已弃用,将在 community.vmware 6.0.0 中移除(https://github.com/ansible-collections/community.vmware/pull/2143)。
vmware_cluster_drs - 该模块已弃用,将在 community.vmware 6.0.0 中移除(https://github.com/ansible-collections/community.vmware/pull/2136)。
vmware_cluster_vcls - 该模块已弃用,将在 community.vmware 6.0.0 中移除(https://github.com/ansible-collections/community.vmware/pull/2156)。
v10.3.0 的移植指南
已知问题
community.docker
docker_container - 当为容器的网络指定 MAC 地址,并且网络在容器创建后附加(例如,由于幂等性检查)时,Docker 守护程序至少在某些情况下会忽略该 MAC 地址(https://github.com/ansible-collections/community.docker/pull/933)。
dellemc.openmanage
idrac_diagnostics - 问题 (285322) - 此模块不支持通过 SOCKS 代理将诊断文件导出到 HTTP 和 HTTPS 共享。
idrac_firmware - 问题 (279282) - 此模块不支持在 iDRAC8 上使用带有身份验证的 HTTP、HTTPS 和 FTP 共享进行固件更新。
idrac_storage_volume - 问题 (290766) - 如果同一控制器上已存在虚拟磁盘,则该模块将报告成功,而不是显示在 BOSS-N1 控制器上创建新虚拟磁盘的失败信息。
ome_diagnostics - 问题 (279193) - 在 OME 4.0.0 版本上,将 SupportAssist 收集日志导出到共享位置失败。
ome_smart_fabric_uplink - 问题 (186024) - 该模块由 OpenManage Enterprise Modular 支持,但是不允许创建多个同名的上行链路。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
已弃用功能
community.docker
根据ansible-core 支持矩阵,该集合弃用了对当前已终止生命周期的所有 ansible-core 版本的支持。这意味着该集合的下一个主要版本将不再支持 ansible-core 2.11、ansible-core 2.12、ansible-core 2.13 和 ansible-core 2.14。
community.routeros
根据ansible-core 支持矩阵,该集合弃用了对当前已终止生命周期的所有 Ansible/ansible-base/ansible-core 版本的支持。这意味着该集合的下一个主要版本将不再支持 Ansible 2.9、ansible-base 2.10、ansible-core 2.11、ansible-core 2.12、ansible-core 2.13 和 ansible-core 2.14。
community.sops
根据ansible-core 支持矩阵,该集合弃用了对当前已终止生命周期的所有 Ansible/ansible-base/ansible-core 版本的支持。这意味着该集合的下一个主要版本将不再支持 Ansible 2.9、ansible-base 2.10、ansible-core 2.11、ansible-core 2.12、ansible-core 2.13 和 ansible-core 2.14。
v10.2.0 的移植指南
已添加的集合
kubevirt.core(版本 1.5.0)
vmware.vmware(版本 1.3.0)
已知问题
dellemc.openmanage
idrac_diagnostics - 问题 (285322) - 此模块不支持通过 SOCKS 代理将诊断文件导出到 HTTP 和 HTTPS 共享。
idrac_firmware - 问题 (279282) - 此模块不支持在 iDRAC8 上使用带有身份验证的 HTTP、HTTPS 和 FTP 共享进行固件更新。
idrac_storage_volume - 问题 (290766) - 如果同一控制器上已存在虚拟磁盘,则该模块将报告成功,而不是显示在 BOSS-N1 控制器上创建新虚拟磁盘的失败信息。
ome_diagnostics - 问题 (279193) - 在 OME 4.0.0 版本上,将 SupportAssist 收集日志导出到共享位置失败。
ome_smart_fabric_uplink - 问题 (186024) - 该模块由 OpenManage Enterprise Modular 支持,但是不允许创建多个同名的上行链路。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
主要更改
dellemc.openmanage
idrac_server_config_profile - 此模块已增强,允许您在 iDRAC 上导出和导入自定义默认值。
ome_configuration_compliance_baseline - 此模块已增强,可以安排修复作业并暂存重启。
fortinet.fortios
添加一个 sanity_test.yaml 文件以触发 GitHub 中的 CI 测试。
支持 Ansible-core 2.17。
支持新的 FOS 版本 7.4.4。
grafana.grafana
在重启 mimir 之前添加配置检查,由 @panfantastic 在 https://github.com/grafana/grafana-ansible-collection/pull/198 中完成
在 grafana 角色中添加对配置 feature_toggles 的支持,由 @LexVar 在 https://github.com/grafana/grafana-ansible-collection/pull/173 中完成
将安装后健康检查从 agent 反向移植到 alloy,由 @v-zhuravlev 在 https://github.com/grafana/grafana-ansible-collection/pull/213 中完成
将 ansible-lint 从 24.2.3 升级到 24.5.0,由 @dependabot 在 https://github.com/grafana/grafana-ansible-collection/pull/207 中完成
将 ansible-lint 从 24.5.0 升级到 24.6.0,由 @dependabot 在 https://github.com/grafana/grafana-ansible-collection/pull/216 中完成
在 1 个目录的 npm_and_yarn 组中,将 braces 从 3.0.2 升级到 3.0.3,由 @dependabot 在 https://github.com/grafana/grafana-ansible-collection/pull/218 中完成
将 pylint 从 3.1.0 升级到 3.1.1,由 @dependabot 在 https://github.com/grafana/grafana-ansible-collection/pull/200 中完成
将 pylint 从 3.1.1 升级到 3.2.2,由 @dependabot 在 https://github.com/grafana/grafana-ansible-collection/pull/208 中完成
将 pylint 从 3.2.2 升级到 3.2.3,由 @dependabot 在 https://github.com/grafana/grafana-ansible-collection/pull/217 中完成
将 pylint 从 3.2.3 升级到 3.2.5,由 @dependabot 在 https://github.com/grafana/grafana-ansible-collection/pull/234 中完成
从 config.river 更改为 config.alloy,由 @cardasac 在 https://github.com/grafana/grafana-ansible-collection/pull/225 中完成
修复基于版本的统一和旧式警报的 Grafana 配置,由 @voidquark 在 https://github.com/grafana/grafana-ansible-collection/pull/215 中完成
支持将 alloy 用户添加到额外组,由 @v-zhuravlev 在 https://github.com/grafana/grafana-ansible-collection/pull/212 中完成
将 result.json[‘message’] 更新为 result.json()[‘message’],由 @CPreun 在 https://github.com/grafana/grafana-ansible-collection/pull/223 中完成
已弃用功能
frr.frr
集合已被弃用。如果 Ansible 11 之前无人重新开始维护,它将从 Ansible 11 中删除。有关更多详细信息,请参阅 未维护集合的集合删除流程 (https://forum.ansible.com/t/6243)。openvswitch.openvswitch
集合已被弃用。如果 Ansible 11 之前无人重新开始维护,它将从 Ansible 11 中删除。有关更多详细信息,请参阅 未维护集合的集合删除流程 (https://forum.ansible.com/t/6245)。
v10.1.0 的移植指南
已添加的集合
ieisystem.inmanage (版本 2.0.0)
已知问题
community.general
homectl - 该模块在 Python 3.13 或更高版本下无法工作,因为它依赖于已删除的
crypt
标准库模块 (https://github.com/ansible-collections/community.general/issues/4691, https://github.com/ansible-collections/community.general/pull/8497)。udm_user - 该模块在 Python 3.13 或更高版本下无法工作,因为它依赖于已删除的
crypt
标准库模块 (https://github.com/ansible-collections/community.general/issues/4690, https://github.com/ansible-collections/community.general/pull/8497)。
dellemc.openmanage
idrac_diagnostics - 问题 (285322) - 此模块不支持通过 SOCKS 代理将诊断文件导出到 HTTP 和 HTTPS 共享。
idrac_firmware - 问题 (279282) - 此模块不支持在 iDRAC8 上使用带有身份验证的 HTTP、HTTPS 和 FTP 共享进行固件更新。
idrac_storage_volume - 问题 (290766) - 如果同一控制器上已存在虚拟磁盘,则该模块将报告成功,而不是显示在 BOSS-N1 控制器上创建新虚拟磁盘的失败信息。
ome_diagnostics - 问题 (279193) - 在 OME 4.0.0 版本上,将 SupportAssist 收集日志导出到共享位置失败。
ome_smart_fabric_uplink - 问题 (186024) - 该模块由 OpenManage Enterprise Modular 支持,但是不允许创建多个同名的上行链路。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
主要变更
containers.podman
添加卷的挂载和卸载
为网络添加多个子网
为 podman_container 添加新选项
为 pod 模块添加新选项
添加 podman 搜索
改进 podman_container 中网络的幂等性
重新设计 Podman Pod 模块的幂等性
dellemc.openmanage
添加了对使用会话 ID 进行 iDRAC、OpenManage Enterprise 和 OpenManage Enterprise Modular 身份验证的支持。
ome_session - 此模块允许您在 OpenManage Enterprise 和 OpenManage Enterprise Modular 上创建和删除会话。
已弃用功能
community.general
CmdRunner 模块实用程序 - 在
CmdRunner
上下文中设置ignore_none
参数的值已被弃用,并且该功能应在 community.general 12.0.0 中删除 (https://github.com/ansible-collections/community.general/pull/8479)。git_config -
list_all
选项已被弃用,并将在 community.general 11.0.0 中删除。请改用community.general.git_config_info
模块 (https://github.com/ansible-collections/community.general/pull/8453)。git_config - 在不提供
value
的情况下使用state=present
已被弃用,并且将在 community.general 11.0.0 中被禁止。请改用community.general.git_config_info
模块读取值 (https://github.com/ansible-collections/community.general/pull/8453)。
v10.0.0 的移植指南
已添加的集合
community.library_inventory_filtering_v1 (版本 1.0.1)
kaytus.ksmanage (版本 1.2.1)
已知问题
community.docker
请注意,community.docker 3.10.1 中包含的 requests 2.32.0 的修复程序仅修复了 vendored Docker SDK for Python 代码的问题。由于 SDK 目前与 requests 2.32.0 不兼容,因此使用 Docker SDK for Python 的模块和插件仍然可能失败。
如果您仍然遇到 requests 2.32.0 的问题,例如错误消息
Not supported URL scheme http+docker
,请将 requests 限制为<2.32.0
。
dellemc.openmanage
idrac_diagnostics - 问题 (285322) - 此模块不支持通过 SOCKS 代理将诊断文件导出到 HTTP 和 HTTPS 共享。
idrac_firmware - 问题 (279282) - 此模块不支持在 iDRAC8 上使用带有身份验证的 HTTP、HTTPS 和 FTP 共享进行固件更新。
idrac_network_attributes - 问题 (279049) - 如果为参数
ome_network_attributes
提供了不支持的值,则此模块不会提供正确的错误消息。idrac_storage_volume - 问题 (290766) - 如果同一控制器上已存在虚拟磁盘,则该模块将报告成功,而不是显示在 BOSS-N1 控制器上创建新虚拟磁盘的失败信息。
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 的支持范围内,则该模块将显示以下消息Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI.
ome_device_quick_deploy - 问题 (275231) - 此模块不会将新配置部署到已禁用 IPv6 的插槽。
ome_diagnostics - 问题 (279193) - 在 OME 4.0.0 版本上,将 SupportAssist 收集日志导出到共享位置失败。
ome_smart_fabric_uplink - 问题 (186024) - 该模块由 OpenManage Enterprise Modular 支持,但是不允许创建多个同名的上行链路。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
重大变更
Ansible-core
assert - 嵌套模板可能会导致无法评估条件。有关更多信息,请参阅移植指南。
amazon.aws
amazon.aws 集合 - 已删除对 ansible-core < 2.15 的支持 (https://github.com/ansible-collections/amazon.aws/pull/2093)。
iam_role -
iam_role.assume_role_policy_document
不再从 CamelCase 转换为 snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040)。iam_role_info -
iam_role.assume_role_policy_document
不再将 CamelCase 转换为 snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040)。kms_key -
policies
的返回值已重命名为key_policies
,内容未更改 (https://github.com/ansible-collections/amazon.aws/pull/2040)。kms_key_info -
policies
的返回值已重命名为key_policies
,内容未更改 (https://github.com/ansible-collections/amazon.aws/pull/2040)。lambda_event - |
batch_size
不再默认为 100。根据 boto3 API (https://boto3.amazonaws.com/v1/documentation/api/1.26.78/reference/services/lambda.html#Lambda.Client.create_event_source_mapping),batch_size
对于 sqs 源默认为 10,对于流源默认为 100 (https://github.com/ansible-collections/amazon.aws/pull/2025)。
cloud.common
将支持的最低 Python 版本提升至 3.9。
移除对 ansible-core < 2.14 的支持。
community.aws
community.aws 集合已停止支持
botocore<1.29.0
和boto3<1.26.0
。大多数模块将继续与旧版本的 AWS SDK 一起工作,但是不保证与旧版本 SDK 的兼容性,也不会进行测试。当使用旧版本的 SDK 时,Ansible 将发出警告 (https://github.com/ansible-collections/amazon.aws/pull/1763)。aws_region_info - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.aws_region_info
。aws_s3_bucket_info - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.aws_s3_bucket_info
。community.aws 集合 - 已停止支持 ansible-core < 2.15 (https://github.com/ansible-collections/community.aws/pull/2074)。
community.aws 集合 - 由于 AWS SDK 宣布停止支持低于 3.7 的 Python 版本 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/),此集合在 6.0.0 版本中已弃用对低于 3.7 的 Python 版本的支持,并在 7.0.0 版本中删除。(https://github.com/ansible-collections/amazon.aws/pull/1763)。
iam_access_key - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.iam_access_key
。iam_access_key_info - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.iam_access_key_info
。iam_group - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.iam_group
(https://github.com/ansible-collections/community.aws/pull/1945)。iam_managed_policy - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.iam_managed_policy
(https://github.com/ansible-collections/community.aws/pull/1954)。iam_mfa_device_info - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.iam_mfa_device_info
(https://github.com/ansible-collections/community.aws/pull/1953)。iam_password_policy - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.iam_password_policy
。iam_role - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.iam_role
(https://github.com/ansible-collections/community.aws/pull/1948)。iam_role_info - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.iam_role_info
(https://github.com/ansible-collections/community.aws/pull/1948)。s3_bucket_info - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.s3_bucket_info
。sts_assume_role - 该模块已从
community.aws
集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用amazon.aws.sts_assume_role
。
community.ciscosmb
接口 'bandwith' 的事实已更改为 'bandwidth'
community.dns
各种模块和插件中的
txt_character_encoding
选项的默认值已从octal
更改为decimal
(https://github.com/ansible-collections/community.dns/pull/196)。inventory 插件 -
filters
现在不再是simple_filters
的别名,而是一个新的、不同的选项 (https://github.com/ansible-collections/community.dns/pull/196)。inventory 插件 - 现在需要
plugin
选项 (https://github.com/ansible-collections/community.dns/pull/196)。lookup, lookup_as_dict -
search
的默认值已从false
(community.dns 2.x.y 的隐式默认值) 更改为true
(https://github.com/ansible-collections/community.dns/issues/200, https://github.com/ansible-collections/community.dns/pull/201)。
community.general
cpanm -
mode
选项的默认值已从compatibility
更改为new
(https://github.com/ansible-collections/community.general/pull/8198)。django_manage - 该模块现在需要 Django >= 4.1 (https://github.com/ansible-collections/community.general/pull/8198)。
django_manage - 如果指定了
virtualenv
但该位置不存在虚拟环境,则该模块现在将失败 (https://github.com/ansible-collections/community.general/pull/8198)。redfish_command, redfish_config, redfish_info - 将
timeout
的默认值从 10 更改为 60 (https://github.com/ansible-collections/community.general/pull/8198)。
community.hrobot
robot inventory 插件 -
filters
现在不再是simple_filters
的别名,而是一个新的、不同的选项 (https://github.com/ansible-collections/community.hrobot/pull/101)。
community.okd
将支持的最低 Python 版本提升至 3.9 (https://github.com/openshift/community.okd/pull/202)。
移除对 ansible-core < 2.14 的支持 (https://github.com/openshift/community.okd/pull/202)。
hetzner.hcloud
停止支持 ansible-core 2.13。
certificate - not_valid_before 和 not_valid_after 值现在以 ISO-8601 格式化的字符串返回。
certificate_info - not_valid_before 和 not_valid_after 值现在以 ISO-8601 格式化的字符串返回。
inventory - 删除已弃用的 api_token_env 选项,您可以使用 ansible.builtin.env lookup 作为替代方案。
iso_info - deprecated 值现在以 ISO-8601 格式化的字符串返回。
kubernetes.core
移除对 ansible-core < 2.14 的支持
将 python kubernetes 库更新到 24.2.0,helm/kind-action 更新到 1.8.0,kubernetes >= 1.24。
theforeman.foreman
content_view_filter - 停止从此模块管理规则,应使用
content_view_filter_rule
来进行管理inventory 插件 - 不再默认为
https://127.0.0.1:3000
作为 Foreman URL,现在必须提供 URL
vmware.vmware_rest
移除对 ansible-core < 2.14 的支持
重大更改
Ansible-core
urls.py - 移除对 Python 2 的支持
ansible.netcommon
将 requires_ansible 提升到 >=2.14.0,因为之前的 ansible-core 版本现在已 EoL。
ansible.utils
将 netaddr 提升到 >=0.10.1,这意味着从该版本开始,此集合所需的最低 netaddr 版本为 >=0.10.1。
将 requires_ansible 提升到 >=2.14.0,因为之前的 ansible-core 版本现在已 EoL。
此版本主要解决 netaddr 库中的重大更改。
随着 netaddr 1.0.0 新版本的发布,IPAddress.is_private() 方法已被移除,取而代之的是扩展了 IPAddress.is_global() 方法以支持相同的功能。 此更改已反映在 ipaddr 过滤器插件中。
arista.eos
将 requires_ansible 提升到 >=2.14.0,因为之前的 ansible-core 版本现在已 EoL。
此版本从此集合中删除了先前已弃用的模块和属性。 请参阅 已删除的功能 部分了解详细信息。
更新 netcommon 基础版本 6.1.0 以支持 cli_restore 插件。
cisco.asa
将 requires_ansible 提升到 >=2.14.0,因为之前的 ansible-core 版本现在已 EoL。
cisco.ios
将 requires_ansible 提升到 >=2.14.0,因为之前的 ansible-core 版本现在已 EoL。
更新 netcommon 基础版本 6.1.0 以支持 cli_restore 插件。
ios_ntp - 删除已弃用的 ntp 旧模块
cisco.iosxr
将 requires_ansible 提升到 >=2.14.0,因为之前的 ansible-core 版本现在已 EoL。
此版本从此集合中删除了先前已弃用的模块和属性。 请参阅 已删除的功能 部分了解详细信息。
更新 netcommon 基础版本以支持 cli_restore 插件。
cisco.nxos
将 requires_ansible 提升到 >=2.14.0,因为之前的 ansible-core 版本现在已 EoL。
此版本从此集合中删除了四个先前已弃用的模块。 请参阅 已删除的功能 部分了解详细信息。
更新了支持 cli_restore 模块所需的最低 ansible.netcommon 版本为 6.1.0。
community.dns
community.dns
集合现在依赖于community.library_inventory_filtering_v1
集合。 此实用程序集合为清单插件提供主机过滤功能。 如果您使用 Ansible 社区软件包,则会包含这两个集合,您无需执行任何特殊操作。 如果您使用ansible-galaxy collection install
安装集合,它将自动安装。 如果您通过将集合的文件复制到 ansible-core 可以找到的位置来安装集合,例如通过克隆 git 存储库,则需要确保在使用清单插件时也必须安装依赖项(https://github.com/ansible-collections/community.dns/pull/196)。
community.docker
community.docker
集合现在依赖于community.library_inventory_filtering_v1
集合。 此实用程序集合为清单插件提供主机过滤功能。 如果您使用 Ansible 社区软件包,则会包含这两个集合,您无需执行任何特殊操作。 如果您使用ansible-galaxy collection install
安装集合,它将自动安装。 如果您通过将集合的文件复制到 ansible-core 可以找到的位置来安装集合,例如通过克隆 git 存储库,则需要确保在使用清单插件时也必须安装依赖项(https://github.com/ansible-collections/community.docker/pull/698)。
community.hashi_vault
要求 -
hvac
所需的requests
包现在由于ansible-core
中回溯的重大安全更改,在此集合的某些用例中具有更严格的范围(https://github.com/ansible-collections/community.hashi_vault/pull/416)。
community.hrobot
community.hrobot
集合现在依赖于community.library_inventory_filtering_v1
集合。 此实用程序集合为清单插件提供主机过滤功能。 如果您使用 Ansible 社区软件包,则会包含这两个集合,您无需执行任何特殊操作。 如果您使用ansible-galaxy collection install
安装集合,它将自动安装。 如果您通过将集合的文件复制到 ansible-core 可以找到的位置来安装集合,例如通过克隆 git 存储库,则需要确保在使用清单插件时也必须安装依赖项(https://github.com/ansible-collections/community.hrobot/pull/101)。
community.mysql
集合版本 2.*.* 已达到 EOL,不会再进行错误修复回溯。 请考虑升级到最新版本。
containers.podman
为 Podman 模块添加 quadlet 支持
dellemc.openmanage
所有 OME 模块都已增强以支持环境变量 OME_USERNAME 和 OME_PASSWORD 作为凭据的后备。
所有 iDRAC 和 Redfish 模块都已增强以支持环境变量 IDRAC_USERNAME 和 IDRAC_PASSWORD 作为凭据的后备。
idrac_certificates - 该模块已增强以支持导入和导出 CUSTOMCERTIFICATE。
idrac_diagnostics - 引入该模块以在 iDRAC 上运行和导出诊断信息。
idrac_gather_facts - 此角色已增强以支持安全启动。
idrac_license - 引入该模块以配置 iDRAC 许可证。
idrac_session - 此模块允许您在 iDRAC 上创建和删除会话。
idrac_user - 引入此角色以管理 iDRAC 的本地用户。
dellemc.unity
添加对 Unity Puffin v5.4 的支持。
fortinet.fortios
在 monitor 和 monitor_fact 模块的文档中为备份模块添加注释。
支持新的 FOS 版本 7.4.2 和 7.4.3,并支持集合中的数据类型 mac_address。
在文档和示例中将所有布尔值更新为 true/false。
更新 log_fact 的文档。
更新支持版本的文档,从最新版本到固定版本号。
使用版本范围更新不匹配的版本消息。
将所需的 ansible 版本更新为 2.14。
将所需的 ansible 版本更新为 2.15。
更新支持的版本范围,而不是具体的版本号,以减小集合大小。
grafana.grafana
通过 @voidquark 在 https://github.com/grafana/grafana-ansible-collection/pull/188 中添加 Grafana Loki 角色
通过 @GVengelen 在 https://github.com/grafana/grafana-ansible-collection/pull/183 中添加 Grafana Mimir 角色
通过 @he0s 在 https://github.com/grafana/grafana-ansible-collection/pull/191 中添加用于配置基于 KeyCloak 的身份验证的新配置部分
通过 @ishanjainn 在 https://github.com/grafana/grafana-ansible-collection/pull/169 中添加用于 Grafana Alloy 的 Ansible 角色
通过 @ishanjainn 在 https://github.com/grafana/grafana-ansible-collection/pull/138 中添加用于 OpenTelemetry Collector 的 Ansible 角色
通过 @voidquark 在 https://github.com/grafana/grafana-ansible-collection/pull/197 中添加 promtail 角色
通过 @dependabot 在 https://github.com/grafana/grafana-ansible-collection/pull/195 中将 ansible-lint 从 24.2.2 升级到 24.2.3
ibm.qradar
将 requires_ansible 提升到 >=2.14.0,因为之前的 ansible-core 版本现在已 EoL。
infoblox.nios_modules
将 Ansible 版本支持从 2.13 升级到 2.16。
将 Python 版本支持从 3.8 升级到 3.10。
junipernetworks.junos
将 requires_ansible 提升到 >=2.14.0,因为之前的 ansible-core 版本现在已 EoL。
此版本从此集合中删除了先前已弃用的模块。 请参阅 已删除的功能 部分了解详细信息。
更新 netcommon 基础版本 6.1.0 以支持 cli_restore 插件。
splunk.es
将 requires_ansible 提升到 >=2.14.0,因为之前的 ansible-core 版本现在已 EoL。
已删除的集合
community.azure(先前包含的版本:2.0.0)
community.sap(先前包含的版本:2.0.0)
gluster.gluster(先前包含的版本:1.0.2)
hpe.nimble(先前包含的版本:1.1.4)
netapp.aws(先前包含的版本:21.7.1)
netapp.azure(先前包含的版本:21.10.1)
netapp.elementsw(先前包含的版本:21.7.0)
netapp.um_info(先前包含的版本:21.8.1)
purestorage.fusion(先前包含的版本:1.6.0)
已删除的功能
由于
community.azure
集合被认为是不维护的,因此已从 Ansible 10 中删除(https://github.com/ansible-community/community-topics/issues/263)。 用户仍然可以使用ansible-galaxy collection install community.azure
安装此集合。由于
gluster.gluster
集合被认为是不维护的,因此已从 Ansible 10 中删除(https://github.com/ansible-community/community-topics/issues/225)。 用户仍然可以使用ansible-galaxy collection install gluster.gluster
安装此集合。由于
hpe.nimble
集合被认为是不维护的,因此已从 Ansible 10 中删除(https://github.com/ansible-community/community-topics/issues/254)。 用户仍然可以使用ansible-galaxy collection install hpe.nimble
安装此集合。由于
netapp.aws
集合被认为是不维护的,因此已从 Ansible 10 中删除(https://github.com/ansible-community/community-topics/issues/223)。 用户仍然可以使用ansible-galaxy collection install netapp.aws
安装此集合。由于
netapp.azure
集合被认为是不维护的,因此已从 Ansible 10 中删除(https://github.com/ansible-community/community-topics/issues/234)。 用户仍然可以使用ansible-galaxy collection install netapp.azure
安装此集合。由于
netapp.elementsw
集合被认为是不维护的,因此已从 Ansible 10 中删除(https://github.com/ansible-community/community-topics/issues/235)。 用户仍然可以使用ansible-galaxy collection install netapp.elementsw
安装此集合。由于
netapp.um_info
集合被认为是不维护的,因此已从 Ansible 10 中删除(https://github.com/ansible-community/community-topics/issues/244)。 用户仍然可以使用ansible-galaxy collection install netapp.um_info
安装此集合。集合
community.sap
已从 Ansible 中完全移除。它已重命名为community.sap_libs
。该集合最终将完全从 Ansible 中移除。请将您的 FQCN 从community.sap
更新为community.sap_libs
。已弃用的
purestorage.fusion
集合已被移除 (https://forum.ansible.com/t/3712)。
Ansible-core
从 ansible-docs 中移除已弃用的 API (https://github.com/ansible/ansible/issues/81716)。
移除已弃用的 JINJA2_NATIVE_WARNING 环境变量 (https://github.com/ansible/ansible/issues/81714)
从 ssh 连接插件中移除已弃用的
scp_if_ssh
(https://github.com/ansible/ansible/issues/81715)。从 ansible.utils.encrypt 中移除已弃用的 crypt 支持 (https://github.com/ansible/ansible/issues/81717)
已移除对 Python 2.7 和 Python 3.6 作为受支持的远程版本的支持。目标执行现在需要 Python 3.7+。
随着对 Python 2 支持的移除,yum 模块和 yum 操作插件被移除并重定向到
dnf
。
amazon.aws
iam_role -
iam_role.assume_role_policy_document_raw
返回值已被弃用。iam_role.assume_role_policy_document
现在返回与iam_role.assume_role_policy_document_raw
相同的格式 (https://github.com/ansible-collections/amazon.aws/pull/2040)。iam_role_info -
iam_role.assume_role_policy_document_raw
返回值已被弃用。iam_role.assume_role_policy_document
现在返回与iam_role.assume_role_policy_document_raw
相同的格式 (https://github.com/ansible-collections/amazon.aws/pull/2040)。module_utils.policy - 之前已弃用的
sort_json_policy_dict()
函数已被移除,请考虑改用compare_policies()
(https://github.com/ansible-collections/amazon.aws/pull/2052)。
arista.eos
移除已弃用的 eos_bgp 模块,该模块已替换为 eos_bgp_global 和 eos_bgp_address_family。
移除已弃用的 eos_logging 模块,该模块已替换为 eos_logging_global 资源模块。
移除已弃用的 timers.throttle 属性。
cisco.ios
已弃用 ios_ntp 模块,建议使用 ios_ntp_global。
移除之前已弃用的 ios_bgp 模块,建议使用 ios_bgp_global 和 ios_bgp_address_family。
cisco.iosxr
移除已弃用的 iosxr_logging 模块,该模块已替换为 iosxr_logging_global 资源模块。
cisco.nxos
此版本已移除 nxos_logging 模块。
此版本已移除 nxos_ntp 模块。
此版本已移除 nxos_ntp_auth 模块。
此版本已移除 nxos_ntp_options 模块。
community.dns
该集合不再支持在 3.0.0 版本发布时已处于生命周期结束的 Ansible、ansible-base 和 ansible-core 版本。这意味着不再支持 Ansible 2.9、ansible-base 2.10、ansible-core 2.11、ansible-core 2.12 和 ansible-core 2.13。该集合可能仍然可以在这些版本上工作,但它可能在没有任何事先通知的情况下随时停止工作,并且这不被认为是错误 (https://github.com/ansible-collections/community.dns/pull/196)。
hetzner_dns_record_set, hetzner_dns_record - 已移除前缀选项的已弃用别名
name
(https://github.com/ansible-collections/community.dns/pull/196)。hosttech_dns_records - 已移除到
hosttech_dns_record_sets
模块的重定向 (https://github.com/ansible-collections/community.dns/pull/196)。
community.general
已移除内部模块名称的已弃用重定向。这些内部重定向是超长的 FQCN,例如
community.general.packaging.os.apt_rpm
,它重定向到短 FQCNcommunity.general.apt_rpm
。它们最初是实现平面映射所必需的;由于各种工具开始建议用户使用长名称,因此平面映射已从集合中移除,并为已经遵循这些不正确建议的用户添加了重定向 (https://github.com/ansible-collections/community.general/pull/7835)。ansible_galaxy_install - 已移除
ack_ansible29
和ack_min_ansiblecore211
选项。它们不再起任何作用 (https://github.com/ansible-collections/community.general/pull/8198)。cloudflare_dns - 移除对 SPF 记录的支持。CloudFlare 不再支持这些记录 (https://github.com/ansible-collections/community.general/pull/7782)。
django_manage - 移除对
command
值cleanup
、syncdb
和validate
的支持。请分别改用clearsessions
、migrate
和check
(https://github.com/ansible-collections/community.general/pull/8198)。flowdock - 此模块依赖于不再存在的 HTTPS API,因此被移除 (https://github.com/ansible-collections/community.general/pull/8198)。
mh.mixins.deps 模块实用程序 - 已移除
DependencyMixin
。请改用deps
模块实用程序 (https://github.com/ansible-collections/community.general/pull/8198)。proxmox - 已移除
proxmox_default_behavior
选项 (https://github.com/ansible-collections/community.general/pull/8198)。rax* 模块、rax 模块实用程序、rax 文档片段 - Rackspace 模块依赖于已弃用的包
pyrax
,因此被移除 (https://github.com/ansible-collections/community.general/pull/8198)。redhat 模块实用程序 - 已移除类
Rhsm
、RhsmPool
和RhsmPools
(https://github.com/ansible-collections/community.general/pull/8198)。redhat_subscription - 已移除
auto_attach
选项的别名autosubscribe
(https://github.com/ansible-collections/community.general/pull/8198)。stackdriver - 此模块依赖于不再存在的 HTTPS API,因此被移除 (https://github.com/ansible-collections/community.general/pull/8198)。
webfaction_* 模块 - 这些模块依赖于不再存在的 HTTPS API,因此被移除 (https://github.com/ansible-collections/community.general/pull/8198)。
community.grafana
在 grafana_dashboard 中移除已弃用的 message 参数
community.hrobot
该集合不再支持在 2.0.0 版本发布时已处于生命周期结束的 Ansible、ansible-base 和 ansible-core 版本。这意味着不再支持 Ansible 2.9、ansible-base 2.10、ansible-core 2.11、ansible-core 2.12 和 ansible-core 2.13。该集合可能仍然可以在这些版本上工作,但它可能在没有任何事先通知的情况下随时停止工作,并且这不被认为是错误 (https://github.com/ansible-collections/community.hrobot/pull/101)。
junipernetworks.junos
移除已弃用的 junos_logging 模块,该模块已替换为 junos_logging_global 资源模块。
已弃用功能
如果无人在 Ansible 11 之前再次开始维护
inspur.sm
集合,则该集合被认为是不受维护的,并将从 Ansible 11 中移除。有关更多详细信息,包括如何取消此操作,请参阅不受维护集合的集合移除流程 (https://forum.ansible.com/t/2854)。如果无人在 Ansible 11 之前再次开始维护
netapp.storagegrid
集合,则该集合被认为是不受维护的,并将从 Ansible 11 中移除。有关更多详细信息,包括如何取消此操作,请参阅不受维护集合的集合移除流程 (https://forum.ansible.com/t/2811)。
Ansible-core
使用入口点 get_host_vars 或 get_group_vars 的旧式 vars 插件已被弃用。应更新该插件以继承自 BaseVarsPlugin 并定义一个 get_vars 方法作为入口点。
‘ansible.module_utils.common.process.get_bin_path’ API 中的 ‘required’ 参数已被弃用 (https://github.com/ansible/ansible/issues/82464)。
module_utils
- 从ansible.module_utils.basic
导入以下便捷助手已弃用:get_exception
,literal_eval
,_literal_eval
,datetime
,signal
,types
,chain
,repeat
,PY2
,PY3
,b
,binary_type
,integer_types
,iteritems
,string_types
,test_type
,map
和shlex_quote
。ansible-doc - 角色入口点属性已弃用,最终将不再在 ansible-core 2.20 及更高版本的 ansible-doc 中显示(https://github.com/ansible/ansible/issues/82639, https://github.com/ansible/ansible/pull/82678)。
paramiko 连接插件,全局范围内的配置项正在被弃用,并将被删除,取而代之的是插件本身中现有的相同选项。用户应该不需要更改任何内容(配置方式相同),但使用全局常量的插件作者应改为使用插件的 get_option()。
amazon.aws
aws_ec2 清单插件 - 删除之前已弃用的
include_extra_api_calls
选项已分配给 9.0.0 版本(https://github.com/ansible-collections/amazon.aws/pull/2040)。cloudformation -
template
参数已弃用,将在 2026-05-01 之后的版本中删除。template_body
参数可以与 lookup 插件一起使用 (https://github.com/ansible-collections/amazon.aws/pull/2048)。iam_policy - 删除之前已弃用的
policies
返回键已分配给 9.0.0 版本。请改用policy_names
返回键 (https://github.com/ansible-collections/amazon.aws/pull/2040)。iam_role_info - 在 2026-05-01 之后的版本中,路径必须以
/
开头和结尾(https://github.com/ansible-collections/amazon.aws/pull/1998)。module_utils.botocore -
get_aws_connection_info()
的boto3
参数将在 2025-05-01 之后的版本中删除。boto3
参数自 4.0.0 版本起已被忽略 (https://github.com/ansible-collections/amazon.aws/pull/2047)。module_utils.botocore -
get_aws_region()
的boto3
参数将在 2025-05-01 之后的版本中删除。boto3
参数自 4.0.0 版本起已被忽略 (https://github.com/ansible-collections/amazon.aws/pull/2047)。module_utils.ec2 -
get_ec2_security_group_ids_from_names()
的boto3
参数将在 2025-05-01 之后的版本中删除。boto3
参数自 4.0.0 版本起已被忽略 (https://github.com/ansible-collections/amazon.aws/pull/2047)。rds_param_group -
rds_param_group
模块已重命名为rds_instance_param_group
。该模块的用法没有改变。rds_param_group 别名将在 10.0.0 版本中删除 (https://github.com/ansible-collections/amazon.aws/pull/2058)。
community.aws
aws_glue_connection - 更新了对删除
connection_parameters
返回键的弃用,从after 2024-06-01
到发布版本9.0.0
,它将被raw_connection_parameters
键替换 (https://github.com/ansible-collections/community.aws/pull/518)。ecs_cluster - 更新了对
purge_capacity_providers
更新的默认值的弃用,当前的默认值False
将在9.0.0
版本中更改为True
。要保持当前行为,请显式设置purge_capacity_providers=False
(https://github.com/ansible-collections/community.aws/pull/1640)。ecs_service - 更新了对
purge_placement_constraints
更新的默认值的弃用,当前的默认值False
将在9.0.0
版本中更改为True
。要保持当前行为,请显式设置purge_placement_constraints=False
(https://github.com/ansible-collections/community.aws/pull/1716)。ecs_service - 更新了对
purge_placement_strategy
更新的默认值的弃用,当前的默认值False
将在9.0.0
版本中更改为True
。要保持当前行为,请显式设置purge_placement_strategy=False
(https://github.com/ansible-collections/community.aws/pull/1716)。
community.crypto
acme 文档片段 - 默认的
community.crypto.acme[.documentation]
文档片段已弃用,将从 community.crypto 3.0.0 中删除。请将其替换为新的community.crypto.acme.basic
和community.crypto.acme.account
片段 (https://github.com/ansible-collections/community.crypto/pull/735)。acme.backends 模块工具 - 从 community.crypto 开始,
CryptoBackend
的所有实现都必须重写get_ordered_csr_identifiers()
。当前的默认实现只是对get_csr_identifiers()
的结果进行排序,然后将被删除 (https://github.com/ansible-collections/community.crypto/pull/725)。acme.backends 模块工具 - 从 community.crypto 3.0.0 开始,必须实现 ACME 加密后端的
get_cert_information()
方法 (https://github.com/ansible-collections/community.crypto/pull/736)。crypto.module_backends.common 模块工具 -
crypto.module_backends.common
模块工具已弃用,将从 community.crypto 3.0.0 中删除。请改用改进的argspec
模块工具 (https://github.com/ansible-collections/community.crypto/pull/749)。openssl_csr_pipe、openssl_privatekey_pipe、x509_certificate_pipe - 当前检查模式的行为已弃用,将在 community.crypto 3.0.0 中更改。当前行为与没有
_pipe
的模块类似:如果需要(重新)生成对象,则仅设置changed
状态,但不会更新该对象。从 community.crypto 3.0.0 开始,这些模块将忽略检查模式,并且始终表现得好像检查模式未激活。现在可以通过向任务添加check_mode: false
来实现此行为。如果您认为这会破坏您对该模块的用例,请在 community.crypto 存储库中创建一个 issue (https://github.com/ansible-collections/community.crypto/issues/712, https://github.com/ansible-collections/community.crypto/pull/714)。
community.dns
hetzner_dns_records 和 hosttech_dns_records 清单插件 -
filters
选项已重命名为simple_filters
。旧名称将在 community.hrobot 2.0.0 中停止工作 (https://github.com/ansible-collections/community.dns/pull/181)。
community.docker
docker_compose - Docker Compose v1 模块已弃用,将从 community.docker 4.0.0 中删除。请迁移到与 Docker Compose v2 一起使用的
community.docker.docker_compose_v2
模块 (https://github.com/ansible-collections/community.docker/issues/823, https://github.com/ansible-collections/community.docker/pull/833)。docker_container -
image_name_mismatch
参数的默认ignore
已弃用,将在 community.docker 4.0.0 中切换为recreate
。在使用了默认值并且行为将在默认值更改后发生变化的情况下,将打印弃用警告 (https://github.com/ansible-collections/community.docker/pull/703)。各种模块和插件 -
ssl_version
选项已弃用,将从 community.docker 4.0.0 中删除。它已从 Docker SDK for Python 7.0.0 中删除,并且过去仅在解决 SSL/TLS 问题时才是必要的 (https://github.com/ansible-collections/community.docker/pull/853)。
community.general
MH DependencyCtxMgr module_utils - 弃用
module_utils.mh.mixin.deps.DependencyCtxMgr
,转而使用module_utils.deps
(https://github.com/ansible-collections/community.general/pull/8280)。ModuleHelper module_utils - 弃用
plugins.module_utils.module_helper.AnsibleModule
(https://github.com/ansible-collections/community.general/pull/8280)。ModuleHelper 模块工具 - 弃用
plugins.module_utils.module_helper.DependencyCtxMgr
(https://github.com/ansible-collections/community.general/pull/8280)。ModuleHelper 模块工具 - 弃用
plugins.module_utils.module_helper.StateMixin
(https://github.com/ansible-collections/community.general/pull/8280)。ModuleHelper 模块工具 - 弃用
plugins.module_utils.module_helper.VarDict,
(https://github.com/ansible-collections/community.general/pull/8280)。ModuleHelper 模块工具 - 弃用
plugins.module_utils.module_helper.VarMeta
(https://github.com/ansible-collections/community.general/pull/8280)。ModuleHelper 模块工具 - 弃用
plugins.module_utils.module_helper.VarsMixin
(https://github.com/ansible-collections/community.general/pull/8280)。ModuleHelper 模块工具 - 弃用使用
VarsMixin
,建议使用VardDict
模块工具 (https://github.com/ansible-collections/community.general/pull/8226)。ModuleHelper 变量模块工具 - 将
VarMeta
、VarDict
和VarsMixin
的弃用版本提升至 11.0.0 (https://github.com/ansible-collections/community.general/pull/8226)。apt_rpm -
state=present
和state=installed
的行为已被弃用,并且将在 community.general 11.0.0 中更改。目前,如果使用这两个状态之一,该模块会将软件包升级到最新版本。如果您想要此行为,则应显式使用state=latest
,如果您不想在已安装软件包时升级它,则应切换到state=present_not_latest
。在 community.general 11.0.0 中,state=present
和state=installed
的行为将更改为state=present_not_latest
的行为 (https://github.com/ansible-collections/community.general/issues/8217, https://github.com/ansible-collections/community.general/pull/8285)。consul_acl - 该模块已被弃用,并将在 community.general 10.0.0 中删除。可以使用
consul_token
和consul_policy
代替 (https://github.com/ansible-collections/community.general/pull/7901)。django_manage -
ack_venv_creation_deprecation
选项不再有效,并将从 community.general 11.0.0 中删除 (https://github.com/ansible-collections/community.general/pull/8198)。gitlab 模块 - GitLab API 上的基本身份验证方法已被弃用,并将在 community.general 10.0.0 中删除 (https://github.com/ansible-collections/community.general/pull/8383)。
hipchat 回调插件 - hipchat 服务已停止使用,自托管版本自 2020 年以来已停止生命周期。因此,回调插件已被弃用,如果没人提供令人信服的理由来保留它,则将从 community.general 10.0.0 中删除 (https://github.com/ansible-collections/community.general/issues/8184, https://github.com/ansible-collections/community.general/pull/8189)。
irc - 为了提高安全性,
use_tls
和validate_certs
的默认值false
已被弃用,并将在 community.general 10.0.0 中更改为true
。您现在可以通过将其显式设置为true
来提高安全性。现在指定值会禁用弃用警告 (https://github.com/ansible-collections/community.general/pull/7578)。
community.hrobot
robot 清单插件 -
filters
选项已重命名为simple_filters
。旧名称将在 community.hrobot 2.0.0 中停止工作 (https://github.com/ansible-collections/community.hrobot/pull/94)。
community.okd
openshift -
openshift
清单插件已被弃用,并将在 4.0.0 版本中删除 (https://github.com/ansible-collections/kubernetes.core/issues/31)。
community.vmware
vmware_guest_tools_info - vm_tools_install_status 将从该集合的下一个主要版本 (5.0.0) 中删除,因为提供此信息的 API 调用已被 VMware 弃用。请改用 vm_tools_running_status / vm_tools_version_status (https://github.com/ansible-collections/community.vmware/issues/2033)。
dellemc.openmanage
dellemc_idrac_storage_volume
模块已被弃用,并被idrac_storage_volume
取代。
kubernetes.core
k8s -
k8s
清单插件已被弃用,并将在 4.0.0 版本中删除 (https://github.com/ansible-collections/kubernetes.core/issues/31)。