Ansible 8 移植指南
Ansible 8 基于 Ansible-core 2.15。
我们建议您结合阅读此页面和Ansible 8 变更日志,以了解您可能需要进行哪些更新。
剧本 (Playbook)
条件语句 - 由于在 ansible-core 2.15.7 中缓解了安全问题 CVE-2023-5764,包含嵌入式模板块的条件表达式可能会失败,并显示消息“
Conditional is marked as unsafe, and cannot be evaluated.
”,当嵌入式模板从不受信任的来源(例如模块结果或标记为!unsafe
的变量)查询数据时。包含嵌入式模板的条件语句在引用不受信任的数据时可能是恶意模板注入的来源,并且几乎总是可以重写而无需嵌入式模板。剧本任务条件关键字(例如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'
命令行
ansible-galaxy search
的返回代码现在为 0 而不是 1,当结果为空时标准输出为空,以与其他ansible-galaxy
命令保持一致。
已弃用
向
vars:
提供字典列表已被弃用,建议改为提供一个字典。不要使用:
vars: - var1: foo - var2: bar
请使用:
vars: var1: foo var2: bar
模块 (Modules)
无显著更改
已移除的模块
以下模块已不存在
无显著更改
弃用通知
无显著更改
值得注意的模块更改
无显著更改
插件 (Plugins)
无显著更改
移植自定义脚本
无显著更改
网络
无显著更改
v8.7.0 移植指南
重大更改
Ansible-core
assert - 嵌套模板可能导致无法评估条件语句。请参阅移植指南了解更多信息。
v8.6.0 移植指南
新增集合 (Collections)
ibm.storage_virtualize (版本 2.1.0)
主要更改
community.mysql
community.mysql 集合不再支持
ansible-core 2.12
和ansible-core 2.13
。虽然我们没有采取任何积极措施来阻止使用,并且也没有计划向模块引入不兼容的代码,但我们将停止测试这些版本。这两个版本都是或很快将成为生命周期结束版本,如果您仍在使用它们,应尽快升级到最新版 Ansible / ansible-core 2.15 或更高版本
(https://github.com/ansible-collections/community.mysql/pull/574)。mysql_role -
column_case_sensitive
参数的默认值将在 community.mysql 4.0.0 中更改为true
。如果您的剧本期望列自动大写以获取您的角色权限,则应将其显式设置为false(https://github.com/ansible-collections/community.mysql/issues/578)。mysql_user -
column_case_sensitive
参数的默认值将在 community.mysql 4.0.0 中更改为true
。如果您的剧本期望列自动大写以获取您的用户权限,则应将其显式设置为false(https://github.com/ansible-collections/community.mysql/issues/577)。
fortinet.fortios
添加新的 fortios 版本 7.4.1。
格式化 changelog.yml 文件中的内容。
将 Ansible 版本从 2.9 更新到 2.14。
更新问答,其中包含 Ansible 始终将 GET/PUT 请求作为 POST 请求发送的解决方案。
更新 requirement.txt 文件以指定 sphinx_rtd_theme==1.3.0
在 runtime.yml 文件中将所需的 Ansible 版本更新为 2.14.0。
已弃用的功能
集合
ibm.spectrum_virtualize
已重命名为ibm.storage_virtualize
。目前,Ansible 中同时包含这两个集合。ibm.spectrum_virtualize
中的内容将在 Ansible 10.0.0 中替换为指向新集合的已弃用重定向,这些重定向最终将从 Ansible 中删除。请更新您的ibm.spectrum_virtualize
的 FQCN。
v8.5.0 移植指南
已弃用的功能
community.general
下一个主要版本 community.general 8.0.0 将停止支持 ansible-core 2.11 和 2.12,这两个版本已经停止维护一段时间了。这意味着此集合不再支持目标上的 Python 2.6。单个内容可能仍然与不受支持的 ansible-core 版本一起工作,但这随时可能发生变化。另请注意,从现在开始,对于每个新的主要 community.general 版本,我们都将停止支持在主要版本发布之日已停止维护超过几周的所有 ansible-core 版本(https://github.com/ansible-community/community-topics/discussions/271,https://github.com/ansible-collections/community.general/pull/7259)。
redfish_info、redfish_config、redfish_command -
timeout
选项的默认值10
已弃用,将在 community.general 9.0.0 中更改为60
(https://github.com/ansible-collections/community.general/pull/7295)。
v8.4.0 移植指南
主要更改
fortinet.fortios
改进文档,为使用整数作为 mkey 的模块添加问答中的注释和示例。
已弃用功能
community.azure
集合已正式停止维护并已存档。因此,它将从 Ansible 10 中移除。社区软件包中已存在一个后续集合azure.azcollection
,它应该涵盖相同的功能 (https://github.com/ansible-community/community-topics/issues/263)。hpe.nimble
集合被认为是未维护的,如果在 Ansible 10 之前没有人再次开始维护它,它将从 Ansible 10 中移除。请参阅 移除过程,了解其工作原理的详细信息 (https://github.com/ansible-community/community-topics/issues/254)。
Ansible-core
vault 和 unfault 过滤器 - 未记录的
vaultid
参数已弃用,将在 ansible-core 2.20 中移除。请改用vault_id
。
ansible.netcommon
libssh - ssh_*_args 选项现已标注为将在 2026-01-01 后移除。
v8.3.0 移植指南
新增集合
telekom_mms.icinga_director (版本 1.34.1)
主要更改
fortinet.fortios
添加 readthedocs.yaml 文件。
更新关于设置 FortiToken 多因素身份验证的问答;
已弃用功能
t_systems_mms.icinga_director
集合已重命名为telekom_mms.icinga_director
。目前 Ansible 中同时包含这两个集合。t_systems_mms.icinga_director
中的内容将在 Ansible 9.0.0 中替换为指向新集合的已弃用重定向,这些重定向最终将从 Ansible 中移除。请更新您的t_systems_mms.icinga_director
的 FQCN。netapp.azure 集合被认为是未维护的,如果在 Ansible 10 之前没有人再次开始维护它,它将从 Ansible 10 中移除。请参阅 移除过程,了解其工作原理的详细信息 (https://github.com/ansible-community/community-topics/issues/234)。
netapp.elementsw 集合被认为是未维护的,如果在 Ansible 10 之前没有人再次开始维护它,它将从 Ansible 10 中移除。请参阅 移除过程,了解其工作原理的详细信息 (https://github.com/ansible-community/community-topics/issues/235)。
netapp.um_info 集合被认为是未维护的,如果在 Ansible 10 之前没有人再次开始维护它,它将从 Ansible 10 中移除。请参阅 移除过程,了解其工作原理的详细信息 (https://github.com/ansible-community/community-topics/issues/244)。
ngine_io.vultr 集合已正式停止维护并已存档。因此,它将从 Ansible 9 中移除。社区软件包中已存在一个后续集合
vultr.cloud
(使用最新的 v2 Vultr API),它涵盖了该功能,但语法可能不兼容 (https://github.com/ansible-community/community-topics/issues/257)。
community.crypto
get_certificate -
asn1_base64
选项的默认值false
已弃用,将在 community.crypto 3.0.0 中更改为true
(https://github.com/ansible-collections/community.crypto/pull/600)。
community.general
ejabberd_user - 已弃用参数
logging
,转而支持在模块输出中生成更详细的信息 (https://github.com/ansible-collections/community.general/pull/7043)。
community.postgresql
postgresql_lang - 该模块已弃用,并将从
community.postgresql 4.0.0
中移除。请改用postgresql_ext
模块 (https://github.com/ansible-collections/community.postgresql/issues/559)。
v8.2.0 移植指南
已知问题
Ansible-core
ansible-test - 已知 Fedora 37 远程主机在启动过程中偶尔会挂起。因此,它不再常规测试。如果可能,请改用 Fedora 38 远程主机。
community.crypto
对于 Ansible-core 2.15 之前的版本,Ansible 标记将以原始形式显示在 ansible-doc 文本输出中。如果您难以解读文档标记,请升级到 ansible-core 2.15(或更高版本),或阅读 https://docs.ansible.org.cn/ansible/devel/collections/community/crypto/ 上的 HTML 文档。
community.hrobot
对于 Ansible-core 2.15 之前的版本,Ansible 标记将以原始形式显示在 ansible-doc 文本输出中。如果您难以解读文档标记,请升级到 ansible-core 2.15(或更高版本),或阅读 https://docs.ansible.org.cn/ansible/devel/collections/community/hrobot/ 上的 HTML 文档。
community.routeros
对于 Ansible-core 2.15 之前的版本,Ansible 标记将以原始形式显示在 ansible-doc 文本输出中。如果您难以解读文档标记,请升级到 ansible-core 2.15(或更高版本),或阅读 https://docs.ansible.org.cn/ansible/devel/collections/community/routeros/ 上的 HTML 文档。
community.sops
对于 Ansible-core 2.15 之前的版本,Ansible 标记将以原始形式显示在 ansible-doc 文本输出中。如果您难以解读文档标记,请升级到 ansible-core 2.15(或更高版本),或阅读 https://docs.ansible.org.cn/ansible/devel/collections/community/sops/ 上的 HTML 文档。
重大更改
hetzner.hcloud
现在需要 hcloud-python 1.20.0 才能完全兼容
主要更改
chocolatey.chocolatey
win_chocolatey - 添加用于指定校验和的选项
win_chocolatey_facts - 添加 filter / gather_subset 选项
community.vmware
vmware_vasa - 添加了一个新模块来注册/注销 VASA 提供程序
vmware_vasa_info - 添加了一个新模块来收集有关现有 VASA 提供程序的信息
grafana.grafana
@gardar 添加了 Grafana 服务器角色
@NormanJS 可配置的代理用户组
@ishanjainn Grafana 插件支持本地 Grafana 安装
@bentonam 更新了流模式的服务
已弃用功能
community.sap
集合已重命名为community.sap_libs
。目前 Ansible 中同时包含这两个集合。community.sap
中的内容将在 Ansible 9.0.0 中替换为指向新集合的已弃用重定向,并且该集合将完全从 Ansible 10 中移除。请更新您的community.sap
的 FQCN。已弃用的 servicenow.servicenow 集合已从 Ansible 7 中移除,但意外地重新添加到 Ansible 8 中。它将再次从 Ansible 9 中移除 (https://github.com/ansible-community/community-topics/issues/246)。
community.general
flowdock - 模块完全依赖于不再响应的 API 端点,它将在 community.general 9.0.0 中移除 (https://github.com/ansible-collections/community.general/pull/6930).
proxmox - 旧的功能标志
proxmox_default_behavior
将在 community.general 10.0.0 中移除 (https://github.com/ansible-collections/community.general/pull/6836).stackdriver - 模块完全依赖于不再存在的 API 端点,它将在 community.general 9.0.0 中移除 (https://github.com/ansible-collections/community.general/pull/6887).
webfaction_app - 模块完全依赖于不再存在的 API 端点,它将在 community.general 9.0.0 中移除 (https://github.com/ansible-collections/community.general/pull/6909).
webfaction_db - 模块完全依赖于不再存在的 API 端点,它将在 community.general 9.0.0 中移除 (https://github.com/ansible-collections/community.general/pull/6909).
webfaction_domain - 模块完全依赖于不再存在的 API 端点,它将在 community.general 9.0.0 中移除 (https://github.com/ansible-collections/community.general/pull/6909).
webfaction_mailbox - 模块完全依赖于不再存在的 API 端点,它将在 community.general 9.0.0 中移除 (https://github.com/ansible-collections/community.general/pull/6909).
webfaction_site - 模块完全依赖于不再存在的 API 端点,它将在 community.general 9.0.0 中移除 (https://github.com/ansible-collections/community.general/pull/6909).
junipernetworks.junos
junos_ospfv2 - 为 area_range 添加弃用警告。
为 junos facts 结果中的 junos_acl_interfaces 键添加弃用警告。
v8.1.0 移植指南
已知问题
community.dns
在 ansible-core 2.15 之前的版本中,ansible-doc 文本输出将以原始形式显示 Ansible 标记。如果您难以解读文档标记,请升级到 ansible-core 2.15(或更高版本),或阅读 https://docs.ansible.org.cn/ansible/devel/collections/community/dns/ 上的 HTML 文档。
community.docker
在 ansible-core 2.15 之前的版本中,ansible-doc 文本输出将以原始形式显示 Ansible 标记。如果您难以解读文档标记,请升级到 ansible-core 2.15(或更高版本),或阅读 https://docs.ansible.org.cn/ansible/devel/collections/community/docker/ 上的 HTML 文档。
community.general
在 ansible-core 2.15 之前的版本中,ansible-doc 文本输出将以原始形式显示 Ansible 标记。如果您难以解读文档标记,请升级到 ansible-core 2.15(或更高版本),或阅读 https://docs.ansible.org.cn/ansible/devel/collections/community/general/ (https://github.com/ansible-collections/community.general/pull/6539) 上的 HTML 文档。
dellemc.openmanage
idrac_redfish_storage_contoller - 问题 (256164) - 如果为控制器配置提供的属性列表中的某个属性提供了不正确的 值,则此模块不会以错误退出。
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_smart_fabric_uplink - 问题 (186024) - 尽管 OpenManage Enterprise Modular 支持此模块,但它不允许创建多个同名的上行链路。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
重大变更
请注意,下面 dellemc.enterprise_sonic 变更日志中宣布的重大更改来自 dellemc.enterprise_sonic 2.1.0,并在 dellemc.enterprise_sonic 2.2.0 中被恢复,因此它不包含在 Ansible 8 中。由于技术原因,此条目仍在此处显示。
dellemc.enterprise_sonic
sonic_aaa - 向 argspec 添加 default_auth 属性以替换已删除的 group 和 local 属性。此更改允许进行有序的登录身份验证。(https://github.com/ansible-collections/dellemc.enterprise_sonic/pull/195).
主要更改
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 的测试
已弃用的功能
gluster.gluster 集合被认为是未维护的,如果在 Ansible 10 之前没有人开始再次维护它,它将从 Ansible 10 中移除。请参阅 有关此工作方式的详细信息的移除流程 (https://github.com/ansible-community/community-topics/issues/225).
amazon.aws
s3_object - 传递以
/
开头的对象键的支持已被弃用,并将在 2025-12-01 之后的发行版中移除 (https://github.com/ansible-collections/amazon.aws/pull/1549).
community.ciscosmb
对 Python 2.6 和 2.7 的支持
对 Ansible 2.9 的支持
community.general
CmdRunner 模块实用程序 - 弃用
cmd_runner_fmt.as_default_type()
格式化程序 (https://github.com/ansible-collections/community.general/pull/6601).MH VarsMixin 模块实用程序 - 弃用
VarsMixin
和支持类,转而支持简单的vardict
模块实用程序 (https://github.com/ansible-collections/community.general/pull/6649).cpanm - 值
compatibility
已被弃用,作为参数mode
的默认值 (https://github.com/ansible-collections/community.general/pull/6512).Red Hat 模块实用程序 -
module_utils.redhat
模块已被弃用,因为它实际上未被使用:Rhsm
、RhsmPool
和RhsmPools
类将在 community.general 9.0.0 中移除;RegistrationBase
类将在 community.general 10.0.0 中与rhn_register
模块一起移除,因为它是此类的唯一用户;这意味着整个module_utils.redhat
模块将在 community.general 10.0.0 中被删除,因此即使没有使用其中的任何内容,导入它也会失败 (https://github.com/ansible-collections/community.general/pull/6663).redhat_subscription -
auto_attach
选项的autosubscribe
别名已被弃用多年,尽管仅在文档中如此。正式将此别名标记为已弃用,它将在 community.general 9.0.0 中移除 (https://github.com/ansible-collections/community.general/pull/6646).redhat_subscription -
pool
选项已弃用,建议使用更精确灵活的pool_ids
选项替代 (https://github.com/ansible-collections/community.general/pull/6650)。rhsm_repository -
state=present
多年来一直无法按预期工作,而且似乎一直没有被注意到;此外,“存在”对于订阅仓库来说并不是一个有效的概念,订阅仓库只能启用或禁用。因此,将state
选项的present
和absent
值标记为已弃用,计划在community.general 10.0.0中将其移除 (https://github.com/ansible-collections/community.general/pull/6673)。
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 版本中移除。
8.0.0 版本移植指南
新增集合
dellemc.powerflex (1.6.0 版本)
dellemc.unity (1.6.0 版本)
grafana.grafana (2.0.0 版本)
microsoft.ad (1.1.0 版本)
servicenow.servicenow (1.0.6 版本)
已知问题
Ansible-core
ansible-test - 某些容器主机和容器组合可能需要额外的配置。更多详细信息可在测试文档中找到。
ansible-test - 包含
VOLUME
指令的自定义容器可能无法启动,而之前这些容器可以正常启动。移除VOLUME
指令以解决此问题。具有此条件的容器将导致ansible-test
发出警告。ansible-test - 之前未报告 Podman 网络问题的系统可能无法运行容器。请修正网络问题以继续使用 Podman 和
ansible-test
。ansible-test - 集合的单元测试不支持在 Python 2.7 上重写
pytest
断言。ansible-test - 在具有 SELinux 的系统上使用 Docker 可能需要将 SELinux 设置为许可模式。Podman 应该可以在强制模式下与 SELinux 一起工作。
dnf5 - DNF5 包管理器目前无法提供所有功能来确保现有
dnf
模块和新的dnf5
模块之间的功能一致性。因此,以下dnf5
选项实际上是无效操作:cacheonly
、enable_plugin
、disable_plugin
和lock_timeout
。
cisco.meraki
meraki_network - 已更新 local_status_page_enabled 和 remote_status_page_enabled 的文档,因为它们不再有效。
community.docker
当前使用来自 Docker SDK for Python 的供应商代码的模块和插件无法与 requests 2.29.0 和/或 urllib3 2.0.0 一起使用。对于 Docker SDK for Python 的最新版本本身也是如此 (https://github.com/ansible-collections/community.docker/issues/611,https://github.com/ansible-collections/community.docker/pull/612)。
docker_api 连接插件 - **无法与 TCP TLS 套接字一起使用!** 这是由于无法在不使用 Python 的
SSLSocket
关闭连接的情况下发送close_notify
TLS 警报造成的 (https://github.com/ansible-collections/community.docker/issues/605,https://github.com/ansible-collections/community.docker/pull/621)。docker_container_exec - 当使用
stdin
选项时,**不支持 TCP TLS 套接字**!这是由于无法在不关闭与 Python 的SSLSocket
连接的情况下发送close_notify
TLS 警告造成的(https://github.com/ansible-collections/community.docker/issues/605,https://github.com/ansible-collections/community.docker/pull/621)。
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)。
dellemc.openmanage
idrac_firmware - 问题 (249879) - 如果使用带有身份验证的 SOCKS 代理,则基于 iDRAC9 的服务器的固件更新将失败。
idrac_os_deployment - 问题 (260496) - 操作系统安装将仅支持 NFS 和 CIFS 共享来存储目标路径中的自定义 ISO,不支持 HTTP/HTTPS/FTP。
idrac_redfish_storage_contoller - 问题 (256164) - 如果为控制器配置提供的属性列表中的某个属性提供了不正确的 值,则此模块不会以错误退出。
idrac_user - 问题 (192043) 模块可能会出错,并显示消息
Unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress
。请等待作业完成,然后再次运行任务。idrac_user - 问题 (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_syslog - 问题 (215374) - 如果目标地址超过 255 个字符,则模块不会提供正确的错误消息。
ome_device_network_services - 问题 (212681) - 如果为以下参数提供不支持的值,则模块不会提供适当的错误消息:port_number、community_name、max_sessions、max_auth_retries 和 idle_timeout。
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_inventory - 问题 (256257) - 对于
Modular System
组及其相应的子组,不会检索所有主机。ome_inventory - 问题 (256589) - 对于
Custom Groups
组及其相应的子组,不会检索所有主机。ome_inventory - 问题 (256593) - 对于
PLUGIN GROUPS
组及其相应的子组,不会检索所有主机。ome_smart_fabric_uplink - 问题 (186024) - 尽管 OpenManage Enterprise Modular 支持此模块,但它不允许创建多个同名的上行链路。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
ome_smart_fabric_uplink - 问题 (186024) - 模块不允许创建多个同名的上行链路,即使 OpenManage Enterprise Modular 支持这样做。如果使用与现有上行链路相同的名称创建上行链路,则会修改现有上行链路。
重大更改
Ansible-core
ansible-doc - 不再将名称以
_
开头的集合中的插件视为已弃用(https://github.com/ansible/ansible/pull/79362)。ansible-test - 在 Ansible 测试管理的主机环境中运行时,依赖于特定文件权限的集成测试可能需要更改。需要
755
或644
以外权限的测试可能需要更新,以便在测试运行过程中设置必要的权限。ansible-test -
vcenter
测试插件现在默认使用用户提供的静态配置,而不是govcsim
模拟器来进行集合测试。设置ANSIBLE_VCSIM_CONTAINER
环境变量为govcsim
以使用模拟器。请记住,模拟器已被弃用,将在未来的版本中删除。ansible-test sanity - 以前,名称以
_
开头的集合中的插件和模块被视为已弃用,即使它们在meta/runtime.yml
中未被标记为已弃用。这种情况不再存在(https://github.com/ansible/ansible/pull/79362)。ansible-test validate-modules - 在验证模块中删除了
missing-python-doc
错误代码,对于缺少 PowerShell 模块文档,则使用missing-documentation
。
amazon.aws
amazon.aws 集合已停止支持
botocore<1.25.0
和boto3<1.22.0
。大多数模块将继续与较旧版本的 AWS SDK 兼容,但是,不保证与较旧版本的 SDK 的兼容性,并且不会对其进行测试。使用较旧版本的 SDK 时,Ansible 将发出警告(https://github.com/ansible-collections/amazon.aws/pull/1342)。amazon.aws - 已删除 Python < 3.6 的兼容性代码(https://github.com/ansible-collections/amazon.aws/pull/1257)。
ec2_eip -
device_id
参数的先前已弃用的instance_id
别名已被删除。请改用device_id
参数名(https://github.com/ansible-collections/amazon.aws/issues/1176)。ec2_instance - 已删除
instance_type
的默认值。启动新实例时,必须至少指定instance_type
或launch_template
中的一个(https://github.com/ansible-collections/amazon.aws/pull/1315)。ec2_vpc_dhcp_options - 在重命名为
dhcp_config
后,new_options
返回值已弃用。请使用dhcp_config
或dhcp_options
返回值(https://github.com/ansible-collections/amazon.aws/pull/1327)。ec2_vpc_endpoint - 已删除
policy_file
参数。可以使用带有文件查找的 I(policy) 来代替(https://github.com/ansible-collections/amazon.aws/issues/1178)。ec2_vpc_net - 已删除
classic_link_enabled
返回值。AWS 已放弃对 EC2 Classic 网络的支持(https://github.com/ansible-collections/amazon.aws/pull/1374)。ec2_vpc_net_info - 已删除
classic_link_dns_status
返回值。AWS 已放弃对 EC2 Classic 网络的支持(https://github.com/ansible-collections/amazon.aws/pull/1374)。ec2_vpc_net_info - 已删除
classic_link_enabled
返回值。AWS 已放弃对 EC2 Classic 网络的支持(https://github.com/ansible-collections/amazon.aws/pull/1374)。module_utils.cloud - 已删除先前已弃用的
CloudRetry.backoff
。请改用CloudRetry.exponential_backoff
或CloudRetry.jittered_backoff
(https://github.com/ansible-collections/amazon.aws/issues/1110)。
ansible.netcommon
NetworkConnectionBase 现在继承自 ansible.utils 中的 PersistentConnectionBase。因此,ansible.utils 的最低版本已增加到 2.7.0。
NetworkTemplate 现在不再能从 ansible_collections.ansible.netcommon.plugins.module_utils.network.common 导入,应从其正确位置 ansible_collections.ansible.netcommon.plugins.module_utils.network.common.rm_base.network_template 导入。
ResourceModule 现在不再能从 ansible_collections.ansible.netcommon.plugins.module_utils.network.common 导入,应从其正确位置 ansible_collections.ansible.netcommon.plugins.module_utils.network.common.rm_base.resource_module 导入。
VALID_MASKS、is_masklen、is_netmask、to_bits、to_ipv6_network、to_masklen、to_netmask 和 to_subnet 现在不再能从 ansible_collections.ansible.netcommon.plugins.module_utils.network.common.utils 导入,应从其正确位置 ansible.module_utils.common.network 导入。
community.aws
community.aws 集合已放弃对
botocore<1.25.0
和boto3<1.22.0
的支持。大多数模块将继续与较旧版本的 AWS SDK 兼容,但是,不保证与旧版 SDK 的兼容性,并且不会对其进行测试。使用旧版 SDK 时,Ansible 将发出警告 (https://github.com/ansible-collections/community.aws/pull/1743)。aws_ssm - AWS SSM 插件错误地将
sudo
添加到大多数命令之前。此行为不正确,现已删除。要以特定用户(包括root
用户)身份执行命令,应使用become
和become_user
指令。有关更多信息,请参阅 Ansible 文档 (https://github.com/ansible-collections/community.aws/issues/853)。codebuild_project -
tags
参数现在接受表示标签的字典,而不是 boto3 格式 (https://github.com/ansible-collections/community.aws/pull/1643)。
community.general
如果您不是将此集合用作 Ansible 的一部分,而是手动安装(和/或升级)了 community.general,则如果使用任何
sapcar_extract
、sap_task_list_execute
和hana_query
模块,则需要确保还安装了community.sap_libs
。如果没有安装该集合,则这些模块的重定向将不起作用。ModuleHelper 模块实用程序 - 当模块设置名为
msg
、exception
、output
、vars
或changed
的输出变量时,只有当它们与 ModuleHelper 本身生成的输出变量冲突时,实际输出才会在这些名称前添加_
(下划线符号),这仅在处理异常时发生。请注意,此重大更改不需要新的主要版本,因为在此版本之前,由于 错误,无法将此类变量添加到输出中 (https://github.com/ansible-collections/community.general/pull/5765)。gconftool2 - 修复了当
key
不存在时处理gconftool-2
的问题,对于value
和previous_value
返回值,返回null
而不是空字符串 (https://github.com/ansible-collections/community.general/issues/6028)。gitlab_runner -
access_level_on_creation
的默认值已从false
更改为true
(https://github.com/ansible-collections/community.general/pull/6428)。ldap_search - 将所有类似字符串的值转换为 UTF-8 (https://github.com/ansible-collections/community.general/issues/5704,https://github.com/ansible-collections/community.general/pull/6473)。
nmcli -
hairpin
选项的默认值已从true
更改为false
(https://github.com/ansible-collections/community.general/pull/6428)。proxmox -
unprivileged
选项的默认值已从false
更改为true
(https://github.com/ansible-collections/community.general/pull/6428)。
community.hashi_vault
已删除对
ansible-core
2.11 和 2.12 的支持 (https://github.com/ansible-collections/community.hashi_vault/issues/340)。community.hashi_vault
的hvac
最低版本现在为1.1.0
(https://github.com/ansible-collections/community.hashi_vault/issues/324)。hashi_vault lookup - 术语字符串中的重复选项条目现在会引发异常而不是警告 (https://github.com/ansible-collections/community.hashi_vault/issues/356)。
community.zabbix
agent 角色 - 已删除对 Darwin、Amazon、Fedora、XCP-ng、Suse、Mint 和 Sangoma 操作系统的支持。
agent 角色 - 已删除对 zabbix_create_host 的支持,并将其替换为 zabbix_agent_host_state。
agent 角色 - 已删除对 zabbix_create_hostgroup 的支持,并将其替换为 zabbix_agent_hostgroups_state。
agent 角色 - 已删除对 zabbix_http_password、zabbix_api_http_password、zabbix_api_pass 和 zabbix_api_login_pass 的支持,并将其替换为 zabbix_api_login_pass。
agent 角色 - 已删除对 zabbix_http_user、zabbix_api_http_user、zabbix_api_user 和 zabbix_api_login_user 的支持,并将其替换为 zabbix_api_login_user。
agent 角色 - 已删除对 zabbix_inventory_mode 的支持,并将其替换为 zabbix_agent_inventory_mode。
agent 角色 - 已删除对 zabbix_link_templates 的支持,并将其替换为 zabbix_agent_link_templates。
agent 角色 - 已删除对 zabbix_macros 的支持,并将其替换为 zabbix_agent_macros。
agent 角色 - 已删除对 zabbix_proxy 的支持,并将其替换为 zabbix_agent_proxy。
agent 角色 - 已删除对 zabbix_update_host 的支持,并将其替换为 zabbix_agent_host_update。
所有模块 - 已放弃对 Zabbix 6.0 以下版本的支持。
所有角色 - 已删除对 zabbix_version 变量的支持。
所有角色 - 已删除对 Zabbix 6.0 以下所有版本的支持。
所有角色 - 已删除对从 epel 和非标准存储库安装的支持。
放弃了对 zabbix-api 的支持,以使用 REST API 调用 Zabbix。
proxy 角色 - 已删除对 zabbix_database_creation 的支持,并将其替换为 zabbix_proxy_database_creation。
proxy 角色 - 已删除对 zabbix_database_sqlload 的支持,并将其替换为 zabbix_proxy_database_sqlload。
proxy 角色 - 已删除对 zabbix_selinux 的支持,并将其替换为 zabbix_proxy_selinux。
server 角色 - 已删除对 zabbix_server_mysql_login_password 的支持,并将其替换为 zabbix_server_dbpassword。
server 角色 - 已删除对 zabbix_server_mysql_login_user 的支持,并将其替换为 zabbix_server_dbuser。
停止支持 Ansible 2.12 以下版本。
停止支持 Python 3.9 以下版本。
zabbix_action - message 参数已重命名为 op_message。
zabbix_group_facts 模块 - 已删除,取而代之的是 zabbix_group_info。
zabbix_host_facts 模块 - 已删除,取而代之的是 zabbix_host_info。
hetzner.hcloud
inventory 插件 - 现在需要 Python v3.5+。
lowlydba.sqlserver
将最小 DBATools 版本更新到 v2.0.0 以允许与 pwsh 7.3+ 兼容。DBATools 中也可能存在重大更改行为,请参阅 https://blog.netnerds.net/2023/03/whats-new-dbatools-2.0/。(https://github.com/lowlydba/lowlydba.sqlserver/pull/181)
主要更改
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 版本。
cisco.iosxr
iosxr_l3_interfaces - 修复 IPv4 地址格式问题。(https://github.com/ansible-collections/cisco.iosxr/issues/311)。
cisco.meraki
meraki_mr_l7_firewall - 新模块
meraki_webhook_payload_template - 新模块
community.hrobot
firewall - Hetzner 为防火墙添加了输出规则支持。此更改不幸地意味着使用旧版本的防火墙模块将始终将输出规则列表设置为为空,从而阻止服务器发送数据包 (https://github.com/ansible-collections/community.hrobot/issues/75,https://github.com/ansible-collections/community.hrobot/pull/76)。
community.postgresql
postgresql_privs -
password
参数已弃用,将在 community.postgresql 4.0.0 中移除,请改用login_password
参数 (https://github.com/ansible-collections/community.postgresql/issues/406)。
community.vmware
在文档和示例中使用 true/false(小写)表示布尔值 (https://github.com/ansible-collections/community.vmware/issues/1660)。
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 模块生成
dellemc.openmanage
已从 Dell EMC 更名为 Dell。
支持 OMSDK 依赖的 iDRAC 模块的 IPv6 地址。
idrac_firmware - 此模块已增强以支持代理。
idrac_redfish_storage_controller - 此模块已增强以配置控制器属性和在线容量扩展。
idrac_server_config_profile - 此模块已增强以支持代理设置、导入缓冲区、包含在导出中以及忽略证书警告。
idrac_user_info - 此模块允许检索 iDRAC 本地用户信息详细信息。
ome_domian_user_groups - 此模块允许导入 LDAP 目录组。
ome_inventory - 此插件允许根据 OpenManage Enterprise 上的组创建清单。
ome_inventory - 此插件已增强以支持检索 OpenManage Enterprise 的系统和插件组的清单。
ome_profile_info - 此模块允许检索 OpenManage Enterprise 或 OpenManage Enterprise Modular 上具有属性的配置文件。
ome_smart_fabric_info - 此模块检索 OpenManage Enterprise Modular 清单中的智能结构列表。
ome_smart_fabric_uplink_info - 此模块检索 OpenManage Enterprise Modular 上结构上行链路的详细信息。
ome_template_network_vlan_info - 此模块允许检索 OpenManage Enterprise 或 OpenManage Enterprise Modular 上模板的网络配置。
fortinet.fortios
为每个模块添加成员操作的注释。
支持 FortiOS v7.0.6、v7.0.7、v7.0.8、v7.2.1、v7.2.2。
为了提高性能,更新了
fortios.py
;支持临时会话密钥和登录前/后横幅;
更新了问答中关于如何使用成员操作的示例。
infoblox.nios_modules
junipernetworks.junos
将收集的键从 junos_acls 更改为 acls
kubernetes.core
将 K8sAnsibleMixin 重构到 module_utils/k8s/ (https://github.com/ansible-collections/kubernetes.core/pull/481)。
purestorage.fusion
资源属性的修补已与底层 Python SDK 保持一致
fusion_volume - 已修复和重新组织,参数已更改
已移除的集合
dellemc.os10(先前包含的版本:1.1.1)
dellemc.os6(先前包含的版本:1.0.7)
dellemc.os9(先前包含的版本:1.0.4)
mellanox.onyx(先前包含的版本:1.0.0)
已移除的功能
dellemc.os10
被认为是未维护的,根据 Ansible 移除流程 已从 Ansible 8 中移除。用户仍然可以使用ansible-galaxy collection install dellemc.os10
安装此集合。dellemc.os6
被认为是未维护的,根据 Ansible 移除流程 已从 Ansible 8 中移除。用户仍然可以使用ansible-galaxy collection install dellemc.os6
安装此集合。dellemc.os9
被认为是未维护的,根据 Ansible 移除流程 已从 Ansible 8 中移除。用户仍然可以使用ansible-galaxy collection install dellemc.os9
安装此集合。mellanox.onyx
被认为是未维护的,根据 Ansible 移除流程 已从 Ansible 8 中移除。用户仍然可以使用ansible-galaxy collection install mellanox.onyx
安装此集合。
Ansible-core
移除已弃用的
ANSIBLE_CALLBACK_WHITELIST
配置环境变量,请改用ANSIBLE_CALLBACKS_ENABLED
。(https://github.com/ansible/ansible/issues/78821)移除已弃用的
ANSIBLE_COW_WHITELIST
配置环境变量,请改用ANSIBLE_COW_ACCEPTLIST
。(https://github.com/ansible/ansible/issues/78819)移除已弃用的
callback_whitelist
配置选项,请改用callbacks_enabled
。(https://github.com/ansible/ansible/issues/78822)移除已弃用的
cow_whitelist
配置选项,请改用cowsay_enabled_stencils
。(https://github.com/ansible/ansible/issues/78820)
amazon.aws
ec2_vpc_endpoint_info - 已移除对
query
参数的支持。amazon.aws.ec2_vpc_endpoint_info
模块现在仅查询端点。可以使用amazon.aws.ec2_vpc_endpoint_service_info
模块查询服务 (https://github.com/ansible-collections/amazon.aws/pull/1308)。s3_object - 已移除使用
s3_object
模块创建和删除存储桶的支持。可以使用amazon.aws.s3_bucket
模块创建和删除 S3 存储桶 (https://github.com/ansible-collections/amazon.aws/issues/1112)。
ansible.netcommon
cli_parse - 此插件已在 1.0.0 版本中移至 ansible.utils,并且现在已移除指向该集合的重定向。
community.general
所有
sap
模块均已从此集合中移除。它们已迁移到 community.sap_libs 集合。已提供重定向。受影响的模块如下:- sapcar_extract - sap_task_list_execute - hana_querycmd_runner 模块实用程序 -
cmd_runner_fmt
的fmt
别名已移除。请改用cmd_runner_fmt
(https://github.com/ansible-collections/community.general/pull/6428)。newrelic_deployment - 已移除
appname
和environment
选项。它们没有任何作用 (https://github.com/ansible-collections/community.general/pull/6428)。puppet - 别名
show-diff
(show_diff
选项的别名)已被移除。请使用show_diff
代替。(https://github.com/ansible-collections/community.general/pull/6428)xfconf - 在 community.general 3.0.0 中已弃用生成事实的功能,但是三个事实信息
property
、channel
和value
错误地继续生成。此行为已被移除,xfconf
将不再生成任何事实信息。(https://github.com/ansible-collections/community.general/pull/5502)xfconf - 在 community.general 3.0.0 中已弃用生成事实的功能,但是两个事实信息
previous_value
和type
错误地继续生成。此行为已被移除,xfconf
将不再生成任何事实信息。(https://github.com/ansible-collections/community.general/pull/5502)
community.zabbix
agent 角色 - 已移除配置防火墙的支持。
web 角色 - 已移除 apache、debian 和 php 的安装。
已弃用的功能
cisco.nso 集合被认为是未维护的,如果在 Ansible 9 发布前没有人开始维护它,它将从 Ansible 9 中移除。请参阅 此处的移除流程,了解具体操作方式。(https://github.com/ansible-community/community-topics/issues/155)
community.fortios 集合被认为是未维护的,如果在 Ansible 9 发布前没有人开始维护它,它将从 Ansible 9 中移除。请参阅 此处的移除流程,了解具体操作方式。(https://github.com/ansible-community/community-topics/issues/162)
community.google 集合被认为是未维护的,如果在 Ansible 9 发布前没有人开始维护它,它将从 Ansible 9 中移除。请参阅 此处的移除流程,了解具体操作方式。(https://github.com/ansible-community/community-topics/issues/160)
community.skydive 集合被认为是未维护的,如果在 Ansible 9 发布前没有人开始维护它,它将从 Ansible 9 中移除。请参阅 此处的移除流程,了解具体操作方式。(https://github.com/ansible-community/community-topics/issues/171)
netapp.aws 集合被认为是未维护的,如果在 Ansible 10 发布前没有人开始维护它,它将从 Ansible 10 中移除。请参阅 此处的移除流程,了解具体操作方式。(https://github.com/ansible-community/community-topics/issues/223)
Ansible-core
属性
ConnectionBase()._new_stdin
已弃用,请使用display.prompt_until(msg)
代替。ansible-test -
foreman
测试插件现已弃用。它将在未来的版本中移除。ansible-test -
vcenter
测试插件中的govcsim
模拟器现已弃用。它将在未来的版本中移除。用户应通过静态配置文件切换到提供他们自己的测试环境。password_hash - 如果 hashtype 不在已记录的选择列表中,则弃用使用 passlib.hash.hashtype。
vars - 为
vars:
指定字典列表已弃用,建议改为指定一个字典。
amazon.aws
amazon.aws 集合 - 由于 AWS SDK 的 Python 支持策略 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/),此集合对 Python 3.8 以下版本的支持预计将在 2024-12-01 后的某个版本中移除。(https://github.com/ansible-collections/amazon.aws/pull/1342)
amazon.aws 集合 - 由于 AWS SDK 宣布停止对 Python 3.7 以下版本的支持 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/),此集合对 Python 3.7 以下版本的支持已被弃用,并将从 7.0.0 版本中移除。(https://github.com/ansible-collections/amazon.aws/pull/1342)
amazon.aws lookup 插件 -
boto3_profile
(profile
选项的别名)已弃用,请使用profile
代替。(https://github.com/ansible-collections/amazon.aws/pull/1225)docs_fragments -
amazon.aws.aws_credentials
文档片段已弃用,请使用amazon.aws.common.plugins
代替。(https://github.com/ansible-collections/amazon.aws/pull/1248)docs_fragments -
amazon.aws.aws_region
文档片段已弃用,请使用amazon.aws.region.plugins
代替。(https://github.com/ansible-collections/amazon.aws/pull/1248)docs_fragments -
amazon.aws.aws
文档片段已弃用,请使用amazon.aws.common.modules
代替。(https://github.com/ansible-collections/amazon.aws/pull/1248)docs_fragments -
amazon.aws.ec2
文档片段已弃用,请使用amazon.aws.region.modules
代替。(https://github.com/ansible-collections/amazon.aws/pull/1248)module_utils.policy -
ansible_collections.amazon.aws.module_utils.policy.sort_json_policy_dict
已弃用,请考虑使用ansible_collections.amazon.aws.module_utils.poilcies.compare_policies
代替。(https://github.com/ansible-collections/amazon.aws/pull/1136)s3_object - 同时传递
dualstack
和endpoint_url
的支持已被弃用,当传递endpoint_url
时,dualstack
参数将被忽略。此支持将在 2024-12-01 后的某个版本中移除。(https://github.com/ansible-collections/amazon.aws/pull/1305)s3_object - 传递除
always
、never
、different
或last
之外的overwrite
值的支持已被弃用。布尔值应替换为字符串always
或never
。此支持将在 2024-12-01 后的某个版本中移除。(https://github.com/ansible-collections/amazon.aws/pull/1305)s3_object_info - 同时传递
dualstack
和endpoint_url
的支持已被弃用,当传递endpoint_url
时,dualstack
参数将被忽略。此支持将在 2024-12-01 后的某个版本中移除。(https://github.com/ansible-collections/amazon.aws/pull/1305)通过混合使用环境变量和参数来同时传递 profile 和安全令牌的支持已被弃用,并且此支持将在 6.0.0 版本中移除。6.0.0 版本之后,无论使用何种机制传递,都只能传递 profile 或安全令牌。要显式阻止来自环境变量的参数,请传递空字符串作为参数值。profile 和安全令牌一起传递的支持最初在 1.2.0 版本中被弃用,但是只在 5.0.0 版本中部分实现。(https://github.com/ansible-collections/amazon.aws/pull/1355)
check_point.mgmt
add/set/delete nat-rule 模块 - 将被单个 cp_mgmt_nat_rule 模块替换。
cp_mgmt_show_task/s 模块 - 将被单个 cp_mgmt_task_facts 模块替换。
chocolatey.chocolatey
win_chocolatey - 弃用并行安装。
cisco.ios
ios_bgp_address_family - 弃用 neighbors.address/tag/ipv6_adddress,使用 neighbor_address,以便为事实呈现启用公共属性。
ios_bgp_address_family - 弃用 neighbors.password,使用 password_options,允许加密和密码。
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。
ios_bgp_address_family - 弃用 slow_peer,使用 slow_peer_options,支持字典属性。
community.aws
community.aws 集合 - 由于 AWS SDKs Python 支持策略(https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/),该集合对 Python 3.8以下版本的支持预计将在 2024-12-01 之后的一个版本中移除(https://github.com/ansible-collections/community.aws/pull/1743)。
community.aws 集合 - 由于 AWS SDKs 宣布终止对 Python 3.7以下版本的支持(https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/),该集合对 Python 3.7以下版本的支持已被弃用,并将在 7.0.0 版本中移除(https://github.com/ansible-collections/community.aws/pull/1743)。
ecs_service - 在 2024-06-01 之后的一个版本中,
purge_placement_constraints
的默认值将从false
更改为true
(https://github.com/ansible-collections/community.aws/pull/1716)。ecs_service - 在 2024-06-01 之后的一个版本中,
purge_placement_strategy
的默认值将从false
更改为true
(https://github.com/ansible-collections/community.aws/pull/1716)。iam_role - 除
iam_role
和changed
之外的所有顶级返回值均已弃用,并将在 2023-12-01 之后的一个版本中移除(https://github.com/ansible-collections/community.aws/issues/551)。iam_role - 在 2023-12-01 之后的一个版本中,
assume_role_policy_document
的内容将不再从 CamelCase 转换为 snake_case。assume_role_policy_document_raw
返回值已以这种未来格式返回策略文档(https://github.com/ansible-collections/community.aws/issues/551)。iam_role_info - 在 2023-12-01 之后的一个版本中,
assume_role_policy_document
的内容将不再从 CamelCase 转换为 snake_case。assume_role_policy_document_raw
返回值已以这种未来格式返回策略文档(https://github.com/ansible-collections/community.aws/issues/551)。
community.crypto
x509_crl -
mode
选项已弃用;请改用crl_mode
。在 community.crypto 3.0.0 中,mode
选项的含义将更改,并将指代 CRL 文件的模式(https://github.com/ansible-collections/community.crypto/issues/596)。
community.dns
新添加的选项
txt_character_encoding
的默认值将在 community.dns 3.0.0 中从octal
更改为decimal
。新的默认值将与 RFC 1035 兼容(https://github.com/ansible-collections/community.dns/pull/134)。
community.general
ModuleHelper module_utils - MH 类的
deps
混合已弃用,建议使用deps
module_utils(https://github.com/ansible-collections/community.general/pull/6465)。consul - 已弃用对
state=absent
未使用的参数的使用(https://github.com/ansible-collections/community.general/pull/5772)。gitlab_runner - 新选项
access_level_on_creation
的默认值将在 community.general 7.0.0 中从false
更改为true
。这将导致在运行程序注册期间以及更新期间使用access_level
(https://github.com/ansible-collections/community.general/pull/5908)。gitlab_runner -
access_level
选项将在 community.general 8.0.0 中失去其默认值。从该版本开始,如果您想要受保护的运行程序,则必须显式地将此选项设置为ref_protected
(https://github.com/ansible-collections/community.general/issues/5925)。manageiq_policies - 已弃用
state=list
,建议使用community.general.manageiq_policies_info
(https://github.com/ansible-collections/community.general/pull/5721)。manageiq_tags - 已弃用
state=list
,建议使用community.general.manageiq_tags_info
(https://github.com/ansible-collections/community.general/pull/5727)。rax - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax 模块实用程序 - 模块实用程序代码依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_cbs - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_cbs_attachments - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_cdb - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_cdb_database - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_cdb_user - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_clb - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_clb_nodes - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_clb_ssl - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_dns - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_dns_record - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_facts - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_files - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_files_objects - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_identity - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_keypair - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_meta - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_mon_alarm - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_mon_check - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_mon_entity - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_mon_notification - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_mon_notification_plan - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_network - 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 中移除(https://github.com/ansible-collections/community.general/pull/5752)。rax_queue 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 版本中移除 ( https://github.com/ansible-collections/community.general/pull/5752 )。rax_scaling_group 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 版本中移除 ( https://github.com/ansible-collections/community.general/pull/5752 )。rax_scaling_policy 模块依赖于已弃用的库
pyrax
,并将从 community.general 9.0.0 版本中移除 ( https://github.com/ansible-collections/community.general/pull/5752 )。rhn_channel, rhn_register - redhat.com 上托管的 RHN 已于数年前停止服务,而使用 RHN 的 Spacewalk 5 自 2020 年 5 月 31 日起已停止支持;虽然这些模块可以在 Uyuni/SUSE Manager(Spacewalk 5 的分支)上运行,但我们尚未听说有人在这些设置中使用它们。因此,这些模块已弃用,如果没有人报告它们仍在使用,并且没有人愿意维护它们,则将在 community.general 10.0.0 版本中移除 ( https://github.com/ansible-collections/community.general/pull/6493 )。
community.hashi_vault
ansible-core - 对
ansible-core
版本2.11
和2.12
的支持将在集合版本5.0.0
中移除,这将使2.13
成为ansible-core
的最低支持版本 ( https://github.com/ansible-collections/community.hashi_vault/issues/340 )。hashi_vault lookup - 在
v5.0.0
版本中,重复的术语字符串选项将引发异常,而不是显示警告 ( https://github.com/ansible-collections/community.hashi_vault/issues/356 )。hvac - 在集合版本
5.0.0
中,hvac
的最低支持版本将至少为1.0.2
;在5.0.0
版本发布之前,此最低版本可能会提高,因此请订阅链接中的问题并注意变更日志中的新通知 ( https://github.com/ansible-collections/community.hashi_vault/issues/324 )。
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`
替换。