Ansible 10 Porting Guide
- Playbook
- Command Line
- Deprecated
- Modules
- Plugins
- Porting custom scripts
- Networking
- Porting Guide for v10.7.0
- Porting Guide for v10.6.0
- Porting Guide for v10.5.0
- Porting Guide for v10.4.0
- Porting Guide for v10.3.0
- Porting Guide for v10.2.0
- Porting Guide for v10.1.0
- Porting Guide for v10.0.0
Ansible 10 is based on Ansible-core 2.17.
We suggest you read this page along with the Ansible 10 Changelog to understand what updates you may need to make.
Playbook
-
Conditionals - due to mitigation of security issue CVE-2023-5764 in ansible-core 2.16.1, conditional expressions with embedded template blocks can fail with the message “
Conditional is marked as unsafe, and cannot be evaluated.” when an embedded template consults data from untrusted sources like module results or vars marked!unsafe. Conditionals with embedded templates can be a source of malicious template injection when referencing untrusted data, and can nearly always be rewritten without embedded templates. Playbook task conditional keywords such aswhenanduntilhave long displayed warnings discouraging use of embedded templates in conditionals; this warning has been expanded to non-task conditionals as well, such as theassertaction.- 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- when a task in a block with arescuesection fails on a host, therescuesection is executed on all hosts. This occurs becauseany_errors_fatalautomatically fails all hosts.
Command Line
- Python 2.7 and Python 3.6 are no longer supported remote versions. Python 3.7+ is now required for target execution.
Deprecated
No notable changes
Modules
No notable changes
Modules removed
The following modules no longer exist:
- No notable changes
Deprecation notices
No notable changes
Noteworthy module changes
No notable changes
Plugins
No notable changes
Porting custom scripts
No notable changes
Networking
No notable changes
Porting Guide for v10.7.0
Known Issues
dellemc.openmanage
- idrac_diagnostics - Issue(285322) - This module doesn’t support export of diagnostics file to HTTP and HTTPS share via SOCKS proxy.
- idrac_firmware - Issue(279282) - This module does not support firmware update using HTTP, HTTPS, and FTP shares with authentication on iDRAC8.
- ome_smart_fabric_uplink - Issue(186024) - The module supported by OpenManage Enterprise Modular, however it does not allow the creation of multiple uplinks of the same name. If an uplink is created using the same name as an existing uplink, then the existing uplink is modified.
Major Changes
- The removal of netapp.storagegrid was cancelled. The collection will not be removed from Ansible 11 (https://forum.ansible.com/t/2811). Maintenance of the collection has been taken over by another team at NetApp.
dellemc.openmanage
- omevv_baseline_profile - This module allows to manage baseline profile.
- omevv_baseline_profile_info - This module allows to retrieve baseline profile information.
- omevv_compliance_info - This module allows to retrieve firmware compliance reports.
Deprecated Features
- The collection
ibm.spectrum_virtualizewas renamed toibm.storage_virtualize. For now both collections are included in Ansible. The collection will be completely removed from Ansible 12. Please update your FQCNs fromibm.spectrum_virtualizetoibm.storage_virtualize.
Porting Guide for v10.6.0
Known Issues
dellemc.openmanage
- idrac_diagnostics - Issue(285322) - This module doesn’t support export of diagnostics file to HTTP and HTTPS share via SOCKS proxy.
- idrac_firmware - Issue(279282) - This module does not support firmware update using HTTP, HTTPS, and FTP shares with authentication on iDRAC8.
- ome_smart_fabric_uplink - Issue(186024) - The module supported by OpenManage Enterprise Modular, however it does not allow the creation of multiple uplinks of the same name. If an uplink is created using the same name as an existing uplink, then the existing uplink is modified.
Major Changes
ansible.posix
- Dropping support for Ansible 2.9, ansible-core 2.15 will be minimum required version for this release
dellemc.openmanage
- omevv_firmware_repository_profile - This module allows to manage firmware repository profile.
- omevv_firmware_repository_profile_info - This module allows to retrieve firmware repository profile information.
- omevv_vcenter_info - This module allows to retrieve vCenter information.
fortinet.fortios
- Improve the logic for SET function to send GET request first then PUT or POST
- Mantis
- Support new FOS versions 7.6.0.
grafana.grafana
- Adding “distributor” section support to mimir config file by @HamzaKhait in https://github.com/grafana/grafana-ansible-collection/pull/247
- Allow alloy_user_groups variable again by @pjezek in https://github.com/grafana/grafana-ansible-collection/pull/276
- Alloy Role Improvements by @voidquark in https://github.com/grafana/grafana-ansible-collection/pull/281
- Bump ansible-lint from 24.6.0 to 24.9.2 by @dependabot in https://github.com/grafana/grafana-ansible-collection/pull/270
- Bump pylint from 3.2.5 to 3.3.1 by @dependabot in https://github.com/grafana/grafana-ansible-collection/pull/273
- Ensure check-mode works for otel collector by @pieterlexis-tomtom in https://github.com/grafana/grafana-ansible-collection/pull/264
- Fix message argument of dashboard task by @Nemental in https://github.com/grafana/grafana-ansible-collection/pull/256
- Update Alloy variables to use the
grafana_alloy_namespace so they are unique by @Aethylred in https://github.com/grafana/grafana-ansible-collection/pull/209 - Update README.md by @aioue in https://github.com/grafana/grafana-ansible-collection/pull/272
- Update README.md by @aioue in https://github.com/grafana/grafana-ansible-collection/pull/275
- Update main.yml by @aioue in https://github.com/grafana/grafana-ansible-collection/pull/274
- add grafana_plugins_ops to defaults and docs by @weakcamel in https://github.com/grafana/grafana-ansible-collection/pull/251
- add option to populate google_analytics_4_id value by @copolycube in https://github.com/grafana/grafana-ansible-collection/pull/249
- fix ansible-lint warnings on Forbidden implicit octal value “0640” by @copolycube in https://github.com/grafana/grafana-ansible-collection/pull/279
Deprecated Features
- The
community.networkcollection has been deprecated. It will be removed from Ansible 12 if no one starts maintaining it again before Ansible 12. See Collections Removal Process for unmaintained collections for more details (https://forum.ansible.com/t/8030). - The google.cloud collection will be removed from Ansible 12 due to violations of the Ansible inclusion requirements. The collection has unresolved sanity test failures. See Collections Removal Process for collections not satisfying the collection requirements for more details, including for how this can be cancelled (https://forum.ansible.com/t/8609).
community.network
- This collection and all content in it is unmaintained and deprecated (https://forum.ansible.com/t/8030). If you are interested in maintaining parts of the collection, please copy them to your own repository, and tell others about in the Forum discussion. See the collection creator path for details.
community.vmware
- vmware_cluster_dpm - the module has been deprecated and will be removed in community.vmware 6.0.0 (https://github.com/ansible-collections/community.vmware/pull/2217).
- vmware_cluster_drs_recommendations - the module has been deprecated and will be removed in community.vmware 6.0.0 (https://github.com/ansible-collections/community.vmware/pull/2218).
Porting Guide for v10.5.0
Known Issues
dellemc.openmanage
- idrac_diagnostics - Issue(285322) - This module doesn’t support export of diagnostics file to HTTP and HTTPS share via SOCKS proxy.
- idrac_firmware - Issue(279282) - This module does not support firmware update using HTTP, HTTPS, and FTP shares with authentication on iDRAC8.
- idrac_storage_volume - Issue(290766) - The module will report success instead of showing failure for new virtual creation on the BOSS-N1 controller if a virtual disk is already present on the same controller.
- idrac_support_assist - Issue(308550) - This module fails when the NFS share path contains sub directory.
- ome_diagnostics - Issue(279193) - Export of SupportAssist collection logs to the share location fails on OME version 4.0.0.
- ome_smart_fabric_uplink - Issue(186024) - The module supported by OpenManage Enterprise Modular, however it does not allow the creation of multiple uplinks of the same name. If an uplink is created using the same name as an existing uplink, then the existing uplink is modified.
Major Changes
dellemc.openmanage
- idrac_secure_boot - This module allows to Configure attributes, import, or export secure boot certificate, and reset keys.
- idrac_system_erase - This module allows to Erase system and storage components of the server on iDRAC.
Deprecated Features
- The
ngine_io.exoscalecollection has been deprecated. It will be removed from Ansible 11 if no one starts maintaining it again before Ansible 11. See Collections Removal Process for unmaintained collections for more details (https://forum.ansible.com/t/2572). - The collection
t_systems_mms.icinga_directorwas renamed totelekom_mms.icinga_director. For now both collections are included in Ansible. The content int_systems_mms.icinga_directorhas been replaced by deprecated redirects in Ansible 9.0.0. The collection will be completely removed from Ansible 11. Please update your FQCNs fromt_systems_mms.icinga_directortotelekom_mms.icinga_director. - The sensu.sensu_go collection will be removed from Ansible 12 due to violations of the Ansible inclusion requirements. The collection has unresolved sanity test failures. See Collections Removal Process for collections not satisfying the collection requirements for more details, including for how this can be cancelled (https://forum.ansible.com/t/8380).
community.general
- hipchat - the hipchat service has been discontinued and the self-hosted variant has been End of Life since 2020. The module is therefore deprecated and will be removed from community.general 11.0.0 if nobody provides compelling reasons to still keep it (https://github.com/ansible-collections/community.general/pull/8919).
Porting Guide for v10.4.0
Known Issues
dellemc.openmanage
- idrac_diagnostics - Issue(285322) - This module doesn’t support export of diagnostics file to HTTP and HTTPS share via SOCKS proxy.
- idrac_firmware - Issue(279282) - This module does not support firmware update using HTTP, HTTPS, and FTP shares with authentication on iDRAC8.
- idrac_storage_volume - Issue(290766) - The module will report success instead of showing failure for new virtual creation on the BOSS-N1 controller if a virtual disk is already present on the same controller.
- idrac_support_assist - Issue(308550) - This module fails when the NFS share path contains sub directory.
- ome_diagnostics - Issue(279193) - Export of SupportAssist collection logs to the share location fails on OME version 4.0.0.
- ome_smart_fabric_uplink - Issue(186024) - The module supported by OpenManage Enterprise Modular, however it does not allow the creation of multiple uplinks of the same name. If an uplink is created using the same name as an existing uplink, then the existing uplink is modified.
Major Changes
dellemc.openmanage
- idrac_secure_boot - This module allows to import the secure boot certificate.
- idrac_support_assist - This module allows to run and export SupportAssist collection logs on iDRAC.
grafana.grafana
- fix:mimir molecule should use ansible core 2.16 by @GVengelen in https://github.com/grafana/grafana-ansible-collection/pull/254
Deprecated Features
amazon.aws
- iam_role - support for creating and deleting IAM instance profiles using the
create_instance_profileanddelete_instance_profileoptions has been deprecated and will be removed in a release after 2026-05-01. To manage IAM instance profiles theamazon.aws.iam_instance_profilemodule can be used instead (https://github.com/ansible-collections/amazon.aws/pull/2221).
community.general
- MH decorator cause_changes module utils - deprecate parameters
on_successandon_failure(https://github.com/ansible-collections/community.general/pull/8791). - pipx - support for versions of the command line tool
pipxolder than1.7.0is deprecated and will be removed in community.general 11.0.0 (https://github.com/ansible-collections/community.general/pull/8793). - pipx_info - support for versions of the command line tool
pipxolder than1.7.0is deprecated and will be removed in community.general 11.0.0 (https://github.com/ansible-collections/community.general/pull/8793).
community.mysql
- collection - support of mysqlclient connector is deprecated - use PyMySQL connector instead! We will stop testing against it in collection version 4.0.0 and remove the related code in 5.0.0 (https://github.com/ansible-collections/community.mysql/issues/654).
- mysql_info - The
users_infofilter returned variableplugin_auth_stringcontains the hashed password and it’s misleading, it will be removed from community.mysql 4.0.0. Use theplugin_hash_stringreturn value instead (https://github.com/ansible-collections/community.mysql/pull/629). - mysql_user - the
useralias of thenameargument has been deprecated and will be removed in collection version 5.0.0. Use thenameargument instead.
community.vmware
- vmware_cluster - the module has been deprecated and will be removed in community.vmware 6.0.0 (https://github.com/ansible-collections/community.vmware/pull/2143).
- vmware_cluster_drs - the module has been deprecated and will be removed in community.vmware 6.0.0 (https://github.com/ansible-collections/community.vmware/pull/2136).
- vmware_cluster_vcls - the module has been deprecated and will be removed in community.vmware 6.0.0 (https://github.com/ansible-collections/community.vmware/pull/2156).
Porting Guide for v10.3.0
Known Issues
community.docker
- docker_container - when specifying a MAC address for a container’s network, and the network is attached after container creation (for example, due to idempotency checks), the MAC address is at least in some cases ignored by the Docker Daemon (https://github.com/ansible-collections/community.docker/pull/933).
dellemc.openmanage
- idrac_diagnostics - Issue(285322) - This module doesn’t support export of diagnostics file to HTTP and HTTPS share via SOCKS proxy.
- idrac_firmware - Issue(279282) - This module does not support firmware update using HTTP, HTTPS, and FTP shares with authentication on iDRAC8.
- idrac_storage_volume - Issue(290766) - The module will report success instead of showing failure for new virtual creation on the BOSS-N1 controller if a virtual disk is already present on the same controller.
- ome_diagnostics - Issue(279193) - Export of SupportAssist collection logs to the share location fails on OME version 4.0.0.
- ome_smart_fabric_uplink - Issue(186024) - The module supported by OpenManage Enterprise Modular, however it does not allow the creation of multiple uplinks of the same name. If an uplink is created using the same name as an existing uplink, then the existing uplink is modified.
Deprecated Features
community.docker
- The collection deprecates support for all ansible-core versions that are currently End of Life, according to the ansible-core support matrix. This means that the next major release of the collection will no longer support ansible-core 2.11, ansible-core 2.12, ansible-core 2.13, and ansible-core 2.14.
community.routeros
- The collection deprecates support for all Ansible/ansible-base/ansible-core versions that are currently End of Life, according to the ansible-core support matrix. This means that the next major release of the collection will no longer support Ansible 2.9, ansible-base 2.10, ansible-core 2.11, ansible-core 2.12, ansible-core 2.13, and ansible-core 2.14.
community.sops
- The collection deprecates support for all Ansible/ansible-base/ansible-core versions that are currently End of Life, according to the ansible-core support matrix. This means that the next major release of the collection will no longer support Ansible 2.9, ansible-base 2.10, ansible-core 2.11, ansible-core 2.12, ansible-core 2.13, and ansible-core 2.14.
Porting Guide for v10.2.0
Added Collections
- kubevirt.core (version 1.5.0)
- vmware.vmware (version 1.3.0)
Known Issues
dellemc.openmanage
- idrac_diagnostics - Issue(285322) - This module doesn’t support export of diagnostics file to HTTP and HTTPS share via SOCKS proxy.
- idrac_firmware - Issue(279282) - This module does not support firmware update using HTTP, HTTPS, and FTP shares with authentication on iDRAC8.
- idrac_storage_volume - Issue(290766) - The module will report success instead of showing failure for new virtual creation on the BOSS-N1 controller if a virtual disk is already present on the same controller.
- ome_diagnostics - Issue(279193) - Export of SupportAssist collection logs to the share location fails on OME version 4.0.0.
- ome_smart_fabric_uplink - Issue(186024) - The module supported by OpenManage Enterprise Modular, however it does not allow the creation of multiple uplinks of the same name. If an uplink is created using the same name as an existing uplink, then the existing uplink is modified.
Major Changes
dellemc.openmanage
- idrac_server_config_profile - This module is enhanced to allow you to export and import custom defaults on iDRAC.
- ome_configuration_compliance_baseline - This module is enhanced to schedule the remediation job and stage the reboot.
fortinet.fortios
- Add a sanity_test.yaml file to trigger CI tests in GitHub.
- Support Ansible-core 2.17.
- Support new FOS versions 7.4.4.
grafana.grafana
- Add a config check before restarting mimir by @panfantastic in https://github.com/grafana/grafana-ansible-collection/pull/198
- Add support for configuring feature_toggles in grafana role by @LexVar in https://github.com/grafana/grafana-ansible-collection/pull/173
- Backport post-setup healthcheck from agent to alloy by @v-zhuravlev in https://github.com/grafana/grafana-ansible-collection/pull/213
- Bump ansible-lint from 24.2.3 to 24.5.0 by @dependabot in https://github.com/grafana/grafana-ansible-collection/pull/207
- Bump ansible-lint from 24.5.0 to 24.6.0 by @dependabot in https://github.com/grafana/grafana-ansible-collection/pull/216
- Bump braces from 3.0.2 to 3.0.3 in the npm_and_yarn group across 1 directory by @dependabot in https://github.com/grafana/grafana-ansible-collection/pull/218
- Bump pylint from 3.1.0 to 3.1.1 by @dependabot in https://github.com/grafana/grafana-ansible-collection/pull/200
- Bump pylint from 3.1.1 to 3.2.2 by @dependabot in https://github.com/grafana/grafana-ansible-collection/pull/208
- Bump pylint from 3.2.2 to 3.2.3 by @dependabot in https://github.com/grafana/grafana-ansible-collection/pull/217
- Bump pylint from 3.2.3 to 3.2.5 by @dependabot in https://github.com/grafana/grafana-ansible-collection/pull/234
- Change from config.river to config.alloy by @cardasac in https://github.com/grafana/grafana-ansible-collection/pull/225
- Fix Grafana Configuration for Unified and Legacy Alerting Based on Version by @voidquark in https://github.com/grafana/grafana-ansible-collection/pull/215
- Support adding alloy user to extra groups by @v-zhuravlev in https://github.com/grafana/grafana-ansible-collection/pull/212
- Updated result.json[‘message’] to result.json()[‘message’] by @CPreun in https://github.com/grafana/grafana-ansible-collection/pull/223
Deprecated Features
- The
frr.frrcollection has been deprecated. It will be removed from Ansible 11 if no one starts maintaining it again before Ansible 11. See Collections Removal Process for unmaintained collections for more details (https://forum.ansible.com/t/6243). - The
openvswitch.openvswitchcollection has been deprecated. It will be removed from Ansible 11 if no one starts maintaining it again before Ansible 11. See Collections Removal Process for unmaintained collections for more details (https://forum.ansible.com/t/6245).
Porting Guide for v10.1.0
Added Collections
- ieisystem.inmanage (version 2.0.0)
Known Issues
community.general
- homectl - the module does not work under Python 3.13 or newer, since it relies on the removed
cryptstandard library module (https://github.com/ansible-collections/community.general/issues/4691, https://github.com/ansible-collections/community.general/pull/8497). - udm_user - the module does not work under Python 3.13 or newer, since it relies on the removed
cryptstandard library module (https://github.com/ansible-collections/community.general/issues/4690, https://github.com/ansible-collections/community.general/pull/8497).
dellemc.openmanage
- idrac_diagnostics - Issue(285322) - This module doesn’t support export of diagnostics file to HTTP and HTTPS share via SOCKS proxy.
- idrac_firmware - Issue(279282) - This module does not support firmware update using HTTP, HTTPS, and FTP shares with authentication on iDRAC8.
- idrac_storage_volume - Issue(290766) - The module will report success instead of showing failure for new virtual creation on the BOSS-N1 controller if a virtual disk is already present on the same controller.
- ome_diagnostics - Issue(279193) - Export of SupportAssist collection logs to the share location fails on OME version 4.0.0.
- ome_smart_fabric_uplink - Issue(186024) - The module supported by OpenManage Enterprise Modular, however it does not allow the creation of multiple uplinks of the same name. If an uplink is created using the same name as an existing uplink, then the existing uplink is modified.
Major Changes
containers.podman
- Add mount and unmount for volumes
- Add multiple subnets for networks
- Add new options for podman_container
- Add new options to pod module
- Add podman search
- Improve idempotency for networking in podman_container
- Redesign idempotency for Podman Pod module
dellemc.openmanage
- Added support to use session ID for authentication of iDRAC, OpenManage Enterprise and OpenManage Enterprise Modular.
- ome_session - This module allows you to create and delete the sessions on OpenManage Enterprise and OpenManage Enterprise Modular.
Deprecated Features
community.general
- CmdRunner module util - setting the value of the
ignore_noneparameter within aCmdRunnercontext is deprecated and that feature should be removed in community.general 12.0.0 (https://github.com/ansible-collections/community.general/pull/8479). - git_config - the
list_alloption has been deprecated and will be removed in community.general 11.0.0. Use thecommunity.general.git_config_infomodule instead (https://github.com/ansible-collections/community.general/pull/8453). - git_config - using
state=presentwithout providingvalueis deprecated and will be disallowed in community.general 11.0.0. Use thecommunity.general.git_config_infomodule instead to read a value (https://github.com/ansible-collections/community.general/pull/8453).
Porting Guide for v10.0.0
Added Collections
- community.library_inventory_filtering_v1 (version 1.0.1)
- kaytus.ksmanage (version 1.2.1)
Known Issues
community.docker
-
Please note that the fix for requests 2.32.0 included in community.docker 3.10.1 only fixes problems with the vendored Docker SDK for Python code. Modules and plugins that use Docker SDK for Python can still fail due to the SDK currently being incompatible with requests 2.32.0.
If you still experience problems with requests 2.32.0, such as error messages like
Not supported URL scheme http+docker, please restrict requests to<2.32.0.
dellemc.openmanage
- idrac_diagnostics - Issue(285322) - This module doesn’t support export of diagnostics file to HTTP and HTTPS share via SOCKS proxy.
- idrac_firmware - Issue(279282) - This module does not support firmware update using HTTP, HTTPS, and FTP shares with authentication on iDRAC8.
- idrac_network_attributes - Issue(279049) - If unsupported values are provided for the parameter
ome_network_attributes, then this module does not provide a correct error message. - idrac_storage_volume - Issue(290766) - The module will report success instead of showing failure for new virtual creation on the BOSS-N1 controller if a virtual disk is already present on the same controller.
- ome_device_network_services - Issue(212681) - The module does not provide a proper error message if unsupported values are provided for the following parameters- port_number, community_name, max_sessions, max_auth_retries, and idle_timeout.
- ome_device_power_settings - Issue(212679) - The module displays the following message if the value provided for the parameter
power_capis not within the supported range of 0 to 32767,Unable to complete the request because PowerCap does not exist or is not applicable for the resource URI. - ome_device_quick_deploy - Issue(275231) - This module does not deploy a new configuration to a slot that has disabled IPv6.
- ome_diagnostics - Issue(279193) - Export of SupportAssist collection logs to the share location fails on OME version 4.0.0.
- ome_smart_fabric_uplink - Issue(186024) - The module supported by OpenManage Enterprise Modular, however it does not allow the creation of multiple uplinks of the same name. If an uplink is created using the same name as an existing uplink, then the existing uplink is modified.
Breaking Changes
Ansible-core
- assert - Nested templating may result in an inability for the conditional to be evaluated. See the porting guide for more information.
amazon.aws
- amazon.aws collection - Support for ansible-core < 2.15 has been dropped (https://github.com/ansible-collections/amazon.aws/pull/2093).
- iam_role -
iam_role.assume_role_policy_documentis no longer converted from CamelCase to snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040). - iam_role_info -
iam_role.assume_role_policy_documentis no longer converted from CamelCase to snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040). - kms_key - the
policiesreturn value has been renamed tokey_policiesthe contents has not been changed (https://github.com/ansible-collections/amazon.aws/pull/2040). - kms_key_info - the
policiesreturn value has been renamed tokey_policiesthe contents has not been changed (https://github.com/ansible-collections/amazon.aws/pull/2040). - lambda_event - |
batch_sizeno longer defaults to 100. According to the boto3 API (https://boto3.amazonaws.com/v1/documentation/api/1.26.78/reference/services/lambda.html#Lambda.Client.create_event_source_mapping),batch_sizedefaults to 10 for sqs sources and to 100 for stream sources (https://github.com/ansible-collections/amazon.aws/pull/2025).
cloud.common
- Bump minimum Python supported version to 3.9.
- Remove support for ansible-core < 2.14.
community.aws
- The community.aws collection has dropped support for
botocore<1.29.0andboto3<1.26.0. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/1763). - aws_region_info - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.aws_region_info. - aws_s3_bucket_info - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.aws_s3_bucket_info. - community.aws collection - Support for ansible-core < 2.15 has been dropped (https://github.com/ansible-collections/community.aws/pull/2074).
- community.aws collection - due to the AWS SDKs announcing the end of support for Python less than 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) support for Python less than 3.7 by this collection wss been deprecated in release 6.0.0 and removed in release 7.0.0. (https://github.com/ansible-collections/amazon.aws/pull/1763).
- iam_access_key - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.iam_access_key. - iam_access_key_info - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.iam_access_key_info. - iam_group - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.iam_group(https://github.com/ansible-collections/community.aws/pull/1945). - iam_managed_policy - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.iam_managed_policy(https://github.com/ansible-collections/community.aws/pull/1954). - iam_mfa_device_info - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.iam_mfa_device_info(https://github.com/ansible-collections/community.aws/pull/1953). - iam_password_policy - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.iam_password_policy. - iam_role - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.iam_role(https://github.com/ansible-collections/community.aws/pull/1948). - iam_role_info - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.iam_role_info(https://github.com/ansible-collections/community.aws/pull/1948). - s3_bucket_info - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.s3_bucket_info. - sts_assume_role - The module has been migrated from the
community.awscollection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.sts_assume_role.
community.ciscosmb
- in facts of interface ‘bandwith’ changed to ‘bandwidth’
community.dns
- The default for the
txt_character_encodingoptions in various modules and plugins changed fromoctaltodecimal(https://github.com/ansible-collections/community.dns/pull/196). - inventory plugins -
filtersis now no longer an alias ofsimple_filters, but a new, different option (https://github.com/ansible-collections/community.dns/pull/196). - inventory plugins - the
pluginoption is now required (https://github.com/ansible-collections/community.dns/pull/196). - lookup, lookup_as_dict - the default for
searchchanged fromfalse(implicit default for community.dns 2.x.y) totrue(https://github.com/ansible-collections/community.dns/issues/200, https://github.com/ansible-collections/community.dns/pull/201).
community.general
- cpanm - the default of the
modeoption changed fromcompatibilitytonew(https://github.com/ansible-collections/community.general/pull/8198). - django_manage - the module now requires Django >= 4.1 (https://github.com/ansible-collections/community.general/pull/8198).
- django_manage - the module will now fail if
virtualenvis specified but no virtual environment exists at that location (https://github.com/ansible-collections/community.general/pull/8198). - redfish_command, redfish_config, redfish_info - change the default for
timeoutfrom 10 to 60 (https://github.com/ansible-collections/community.general/pull/8198).
community.hrobot
- robot inventory plugin -
filtersis now no longer an alias ofsimple_filters, but a new, different option (https://github.com/ansible-collections/community.hrobot/pull/101).
community.okd
- Bump minimum Python suupported version to 3.9 (https://github.com/openshift/community.okd/pull/202).
- Remove support for ansible-core < 2.14 (https://github.com/openshift/community.okd/pull/202).
hetzner.hcloud
- Drop support for ansible-core 2.13.
- certificate - The
not_valid_beforeandnot_valid_aftervalues are now returned as ISO-8601 formatted strings. - certificate_info - The
not_valid_beforeandnot_valid_aftervalues are now returned as ISO-8601 formatted strings. - inventory - Remove the deprecated
api_token_envoption, you may use theansible.builtin.envlookup as alternative. - iso_info - The
deprecatedvalue is now returned as ISO-8601 formatted strings.
kubernetes.core
- Remove support for ansible-core < 2.14
- Update python kubernetes library to 24.2.0, helm/kind-action to 1.8.0, kubernetes >= 1.24.
theforeman.foreman
- content_view_filter - stop managing rules from this module,
content_view_filter_ruleshould be used for that - inventory plugin - do not default to
http://localhost:3000as the Foreman URL, providing a URL is now mandatory
vmware.vmware_rest
- Remove support for ansible-core < 2.14
Major Changes
Ansible-core
- urls.py - Removed support for Python 2
ansible.netcommon
- Bumping
requires_ansibleto>=2.14.0, since previous ansible-core versions are EoL now.
ansible.utils
- Bumping
netaddrto>=0.10.1, means that starting from this release, the minimumnetaddrversion this collection requires is>=0.10.1. - Bumping
requires_ansibleto>=2.14.0, since previous ansible-core versions are EoL now. - This release mainly addresses the breaking changes in the
netaddrlibrary. - With the new release of
netaddr1.0.0, theIPAddress.is_private()method has been removed and instead, theIPAddress.is_global()method has been extended to support the same functionality. This change has been reflected in theipaddrfilter plugin.
arista.eos
- Bumping
requires_ansibleto>=2.14.0, since previous ansible-core versions are EoL now. - This release removes previously deprecated modules and attributes from this collection. Please refer to the Removed Features section for details.
- Update the netcommon base version 6.1.0 to support cli_restore plugin.
cisco.asa
- Bumping
requires_ansibleto>=2.14.0, since previous ansible-core versions are EoL now.
cisco.ios
- Bumping
requires_ansibleto>=2.14.0, since previous ansible-core versions are EoL now. - Update the netcommon base version 6.1.0 to support cli_restore plugin.
- ios_ntp - Remove deprecated ntp legacy module
cisco.iosxr
- Bumping
requires_ansibleto>=2.14.0, since previous ansible-core versions are EoL now. - This release removes previously deprecated module and attributes from this collection. Please refer to the Removed Features section for details.
- Update the netcommon base version to support cli_restore plugin.
cisco.nxos
- Bumping
requires_ansibleto>=2.14.0, since previous ansible-core versions are EoL now. - This release removes four previously deprecated modules from this collection. Please refer to the Removed Features section for details.
- Updated the minimum required ansible.netcommon version to 6.1.0 to support the cli_restore module.
community.dns
- The
community.dnscollection now depends on thecommunity.library_inventory_filtering_v1collection. This utility collection provides host filtering functionality for inventory plugins. If you use the Ansible community package, both collections are included and you do not have to do anything special. If you install the collection withansible-galaxy collection install, it will be installed automatically. If you install the collection by copying the files of the collection to a place where ansible-core can find it, for example by cloning the git repository, you need to make sure that you also have to install the dependency if you are using the inventory plugins (https://github.com/ansible-collections/community.dns/pull/196).
community.docker
- The
community.dockercollection now depends on thecommunity.library_inventory_filtering_v1collection. This utility collection provides host filtering functionality for inventory plugins. If you use the Ansible community package, both collections are included and you do not have to do anything special. If you install the collection withansible-galaxy collection install, it will be installed automatically. If you install the collection by copying the files of the collection to a place where ansible-core can find it, for example by cloning the git repository, you need to make sure that you also have to install the dependency if you are using the inventory plugins (https://github.com/ansible-collections/community.docker/pull/698).
community.hashi_vault
- requirements - the
requestspackage which is required byhvacnow has a more restrictive range for this collection in certain use cases due to breaking security changes inansible-corethat were backported (https://github.com/ansible-collections/community.hashi_vault/pull/416).
community.hrobot
- The
community.hrobotcollection now depends on thecommunity.library_inventory_filtering_v1collection. This utility collection provides host filtering functionality for inventory plugins. If you use the Ansible community package, both collections are included and you do not have to do anything special. If you install the collection withansible-galaxy collection install, it will be installed automatically. If you install the collection by copying the files of the collection to a place where ansible-core can find it, for example by cloning the git repository, you need to make sure that you also have to install the dependency if you are using the inventory plugin (https://github.com/ansible-collections/community.hrobot/pull/101).
community.mysql
- Collection version 2.*.* is EOL, no more bugfixes will be backported. Please consider upgrading to the latest version.
containers.podman
- Add quadlet support for Podman modules
dellemc.openmanage
- All OME modules are enhanced to support the environment variables
OME_USERNAMEandOME_PASSWORDas fallback for credentials. - All iDRAC and Redfish modules are enhanced to support the environment variables
IDRAC_USERNAMEandIDRAC_PASSWORDas fallback for credentials. - idrac_certificates - The module is enhanced to support the import and export of
CUSTOMCERTIFICATE. - idrac_diagnostics - The module is introduced to run and export diagnostics on iDRAC.
- idrac_gather_facts - This role is enhanced to support secure boot.
- idrac_license - The module is introduced to configure iDRAC licenses.
- idrac_session - This module allows you to create and delete the sessions on iDRAC.
- idrac_user - This role is introduced to manage local users of iDRAC.
dellemc.unity
- Adding support for Unity Puffin v5.4.
fortinet.fortios
- Add notes for backup modules in the documentation in both monitor and monitor_fact modules.
- Supported new FOS versions 7.4.2 and 7.4.3, and support data type mac_address in the collection.
- Update all the boolean values to true/false in the documents and examples.
- Update the document of log_fact.
- Update the documentation for the supported versions from latest to a fix version number.
- Update the mismatched version message with version ranges.
- Update the required ansible version to 2.14.
- Update the required ansible version to 2.15.
- Update the supported version ranges instead of concrete version numbers to reduce the collection size.
grafana.grafana
- Add Grafana Loki role by @voidquark in https://github.com/grafana/grafana-ansible-collection/pull/188
- Add Grafana Mimir role by @GVengelen in https://github.com/grafana/grafana-ansible-collection/pull/183
- Add a new config part to configure KeyCloak based auth by @he0s in https://github.com/grafana/grafana-ansible-collection/pull/191
- Add an Ansible role for Grafana Alloy by @ishanjainn in https://github.com/grafana/grafana-ansible-collection/pull/169
- Add an Ansible role for OpenTelemetry Collector by @ishanjainn in https://github.com/grafana/grafana-ansible-collection/pull/138
- Add promtail role by @voidquark in https://github.com/grafana/grafana-ansible-collection/pull/197
- Bump ansible-lint from 24.2.2 to 24.2.3 by @dependabot in https://github.com/grafana/grafana-ansible-collection/pull/195
ibm.qradar
- Bumping
requires_ansibleto>=2.14.0, since previous ansible-core versions are EoL now.
infoblox.nios_modules
- Upgrade Ansible version support from 2.13 to 2.16.
- Upgrade Python version support from 3.8 to 3.10.
junipernetworks.junos
- Bumping
requires_ansibleto>=2.14.0, since previous ansible-core versions are EoL now. - This release removes previously deprecated modules from this collection. Please refer to the Removed Features section for details.
- Update the netcommon base version 6.1.0 to support cli_restore plugin.
splunk.es
- Bumping
requires_ansibleto>=2.14.0, since previous ansible-core versions are EoL now.
Removed Collections
- community.azure (previously included version: 2.0.0)
- community.sap (previously included version: 2.0.0)
- gluster.gluster (previously included version: 1.0.2)
- hpe.nimble (previously included version: 1.1.4)
- netapp.aws (previously included version: 21.7.1)
- netapp.azure (previously included version: 21.10.1)
- netapp.elementsw (previously included version: 21.7.0)
- netapp.um_info (previously included version: 21.8.1)
- purestorage.fusion (previously included version: 1.6.0)
Removed Features
- The
community.azurecollection was considered unmaintained and has been removed from Ansible 10 (https://github.com/ansible-community/community-topics/issues/263). Users can still install this collection withansible-galaxy collection install community.azure. - The
gluster.glustercollection was considered unmaintained and has been removed from Ansible 10 (https://github.com/ansible-community/community-topics/issues/225). Users can still install this collection withansible-galaxy collection install gluster.gluster. - The
hpe.nimblecollection was considered unmaintained and has been removed from Ansible 10 (https://github.com/ansible-community/community-topics/issues/254). Users can still install this collection withansible-galaxy collection install hpe.nimble. - The
netapp.awscollection was considered unmaintained and has been removed from Ansible 10 (https://github.com/ansible-community/community-topics/issues/223). Users can still install this collection withansible-galaxy collection install netapp.aws. - The
netapp.azurecollection was considered unmaintained and has been removed from Ansible 10 (https://github.com/ansible-community/community-topics/issues/234). Users can still install this collection withansible-galaxy collection install netapp.azure. - The
netapp.elementswcollection was considered unmaintained and has been removed from Ansible 10 (https://github.com/ansible-community/community-topics/issues/235). Users can still install this collection withansible-galaxy collection install netapp.elementsw. - The
netapp.um_infocollection was considered unmaintained and has been removed from Ansible 10 (https://github.com/ansible-community/community-topics/issues/244). Users can still install this collection withansible-galaxy collection install netapp.um_info. - The collection
community.saphas been completely removed from Ansible. It has been renamed tocommunity.sap_libs. The collection will be completely removed from Ansible eventually. Please update your FQCNs fromcommunity.saptocommunity.sap_libs. - The deprecated
purestorage.fusioncollection has been removed (https://forum.ansible.com/t/3712).
Ansible-core
- Remove deprecated APIs from ansible-docs (https://github.com/ansible/ansible/issues/81716).
- Remove deprecated JINJA2_NATIVE_WARNING environment variable (https://github.com/ansible/ansible/issues/81714)
- Remove deprecated
scp_if_sshfrom ssh connection plugin (https://github.com/ansible/ansible/issues/81715). - Remove deprecated crypt support from ansible.utils.encrypt (https://github.com/ansible/ansible/issues/81717)
- Removed Python 2.7 and Python 3.6 as a supported remote version. Python 3.7+ is now required for target execution.
- With the removal of Python 2 support, the yum module and yum action plugin are removed and redirected to
dnf.
amazon.aws
- iam_role - the
iam_role.assume_role_policy_document_rawreturn value has been deprecated.iam_role.assume_role_policy_documentnow returns the same format asiam_role.assume_role_policy_document_raw(https://github.com/ansible-collections/amazon.aws/pull/2040). - iam_role_info - the
iam_role.assume_role_policy_document_rawreturn value has been deprecated.iam_role.assume_role_policy_documentnow returns the same format asiam_role.assume_role_policy_document_raw(https://github.com/ansible-collections/amazon.aws/pull/2040). - module_utils.policy - the previously deprecated
sort_json_policy_dict()function has been removed, consider usingcompare_policies()instead (https://github.com/ansible-collections/amazon.aws/pull/2052).
arista.eos
- Remove depreacted eos_bgp module which is replaced with eos_bgp_global and eos_bgp_address_family.
- Remove deprecated eos_logging module which is replaced with eos_logging_global resource module.
- Remove deprecated timers.throttle attribute.
cisco.ios
- Deprecated ios_ntp module in favor of ios_ntp_global.
- Removed previously deprecated ios_bgp module in favor of ios_bgp_global and ios_bgp_address_family.
cisco.iosxr
- Remove deprecated iosxr_logging module which is replaced with iosxr_logging_global resource module.
cisco.nxos
- The nxos_logging module has been removed with this release.
- The nxos_ntp module has been removed with this release.
- The nxos_ntp_auth module has been removed with this release.
- The nxos_ntp_options module has been removed with this release.
community.dns
- The collection no longer supports Ansible, ansible-base, and ansible-core releases that are currently End of Life at the time of the 3.0.0 release. This means that Ansible 2.9, ansible-base 2.10, ansible-core 2.11, ansible-core 2.12, and ansible-core 2.13 are no longer supported. The collection might still work with these versions, but it can stop working at any moment without advance notice, and this will not be considered a bug (https://github.com/ansible-collections/community.dns/pull/196).
- hetzner_dns_record_set, hetzner_dns_record - the deprecated alias
nameof the prefix option was removed (https://github.com/ansible-collections/community.dns/pull/196). - hosttech_dns_records - the redirect to the
hosttech_dns_record_setsmodule has been removed (https://github.com/ansible-collections/community.dns/pull/196).
community.general
- The deprecated redirects for internal module names have been removed. These internal redirects were extra-long FQCNs like
community.general.packaging.os.apt_rpmthat redirect to the short FQCNcommunity.general.apt_rpm. They were originally needed to implement flatmapping; as various tooling started to recommend users to use the long names flatmapping was removed from the collection and redirects were added for users who already followed these incorrect recommendations (https://github.com/ansible-collections/community.general/pull/7835). - ansible_galaxy_install - the
ack_ansible29andack_min_ansiblecore211options have been removed. They no longer had any effect (https://github.com/ansible-collections/community.general/pull/8198). - cloudflare_dns - remove support for SPF records. These are no longer supported by CloudFlare (https://github.com/ansible-collections/community.general/pull/7782).
- django_manage - support for the
commandvaluescleanup,syncdb, andvalidatewere removed. Useclearsessions,migrate, andcheckinstead, respectively (https://github.com/ansible-collections/community.general/pull/8198). - flowdock - this module relied on HTTPS APIs that do not exist anymore and was thus removed (https://github.com/ansible-collections/community.general/pull/8198).
- mh.mixins.deps module utils - the
DependencyMixinhas been removed. Use thedepsmodule utils instead (https://github.com/ansible-collections/community.general/pull/8198). - proxmox - the
proxmox_default_behavioroption has been removed (https://github.com/ansible-collections/community.general/pull/8198). - rax* modules, rax module utils, rax docs fragment - the Rackspace modules relied on the deprecated package
pyraxand were thus removed (https://github.com/ansible-collections/community.general/pull/8198). - redhat module utils - the classes
Rhsm,RhsmPool, andRhsmPoolshave been removed (https://github.com/ansible-collections/community.general/pull/8198). - redhat_subscription - the alias
autosubscribeof theauto_attachoption was removed (https://github.com/ansible-collections/community.general/pull/8198). - stackdriver - this module relied on HTTPS APIs that do not exist anymore and was thus removed (https://github.com/ansible-collections/community.general/pull/8198).
- webfaction_* modules - these modules relied on HTTPS APIs that do not exist anymore and were thus removed (https://github.com/ansible-collections/community.general/pull/8198).
community.grafana
- removed deprecated
messageargument ingrafana_dashboard
community.hrobot
- The collection no longer supports Ansible, ansible-base, and ansible-core releases that are currently End of Life at the time of the 2.0.0 release. This means that Ansible 2.9, ansible-base 2.10, ansible-core 2.11, ansible-core 2.12, and ansible-core 2.13 are no longer supported. The collection might still work with these versions, but it can stop working at any moment without advance notice, and this will not be considered a bug (https://github.com/ansible-collections/community.hrobot/pull/101).
junipernetworks.junos
- Remove deprected junos_logging module which is replaced by junos_logging_global resource module.
Deprecated Features
- The
inspur.smcollection is considered unmaintained and will be removed from Ansible 11 if no one starts maintaining it again before Ansible 11. See Collections Removal Process for unmaintained collections for more details, including for how this can be cancelled (https://forum.ansible.com/t/2854). - The
netapp.storagegridcollection is considered unmaintained and will be removed from Ansible 11 if no one starts maintaining it again before Ansible 11. See Collections Removal Process for unmaintained collections for more details, including for how this can be cancelled (https://forum.ansible.com/t/2811).
Ansible-core
- Old style vars plugins which use the entrypoints
get_host_varsorget_group_varsare deprecated. The plugin should be updated to inherit fromBaseVarsPluginand define aget_varsmethod as the entrypoint. - The ‘required’ parameter in ‘ansible.module_utils.common.process.get_bin_path’ API is deprecated (https://github.com/ansible/ansible/issues/82464).
-
module_utils- importing the following convenience helpers fromansible.module_utils.basichas been deprecated:get_exception,literal_eval,_literal_eval,datetime,signal,types,chain,repeat,PY2,PY3,b,binary_type,integer_types,iteritems,string_types,test_type,mapandshlex_quote. - ansible-doc - role entrypoint attributes are deprecated and eventually will no longer be shown in ansible-doc from ansible-core 2.20 on (https://github.com/ansible/ansible/issues/82639, https://github.com/ansible/ansible/pull/82678).
- paramiko connection plugin, configuration items in the global scope are being deprecated and will be removed in favor or the existing same options in the plugin itself. Users should not need to change anything (how to configure them are the same) but plugin authors using the global constants should move to using the plugin’s get_option().
amazon.aws
- aws_ec2 inventory plugin - removal of the previously deprecated
include_extra_api_callsoption has been assigned to release 9.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2040). - cloudformation - the
templateparameter has been deprecated and will be removed in a release after 2026-05-01. Thetemplate_bodyparameter can be used in conjungtion with the lookup plugin (https://github.com/ansible-collections/amazon.aws/pull/2048). - iam_policy - removal of the previously deprecated
policiesreturn key has been assigned to release 9.0.0. Use thepolicy_namesreturn key instead (https://github.com/ansible-collections/amazon.aws/pull/2040). - iam_role_info - in a release after 2026-05-01 paths must begin and end with
/(https://github.com/ansible-collections/amazon.aws/pull/1998). - module_utils.botocore - the
boto3parameter forget_aws_connection_info()will be removed in a release after 2025-05-01. Theboto3parameter has been ignored since release 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047). - module_utils.botocore - the
boto3parameter forget_aws_region()will be removed in a release after 2025-05-01. Theboto3parameter has been ignored since release 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047). - module_utils.ec2 - the
boto3parameter forget_ec2_security_group_ids_from_names()will be removed in a release after 2025-05-01. Theboto3parameter has been ignored since release 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047). - rds_param_group - the
rds_param_groupmodule has been renamed tords_instance_param_group. The usage of the module has not changed. The rds_param_group alias will be removed in version 10.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2058).
community.aws
- aws_glue_connection - updated the deprecation for removal of the
connection_parametersreturn key fromafter 2024-06-01to release version9.0.0, it is being replaced by theraw_connection_parameterskey (https://github.com/ansible-collections/community.aws/pull/518). - ecs_cluster - updated the deprecation for updated default of
purge_capacity_providers, the current default ofFalsewill be changed toTruein release9.0.0. To maintain the current behaviour explicitly setpurge_capacity_providers=False(https://github.com/ansible-collections/community.aws/pull/1640). - ecs_service - updated the deprecation for updated default of
purge_placement_constraints, the current default ofFalsewill be changed toTruein release9.0.0. To maintain the current behaviour explicitly setpurge_placement_constraints=False(https://github.com/ansible-collections/community.aws/pull/1716). - ecs_service - updated the deprecation for updated default of
purge_placement_strategy, the current default ofFalsewill be changed toTruein release9.0.0. To maintain the current behaviour explicitly setpurge_placement_strategy=False(https://github.com/ansible-collections/community.aws/pull/1716).
community.crypto
- acme documentation fragment - the default
community.crypto.acme[.documentation]docs fragment is deprecated and will be removed from community.crypto 3.0.0. Replace it with both the newcommunity.crypto.acme.basicandcommunity.crypto.acme.accountfragments (https://github.com/ansible-collections/community.crypto/pull/735). - acme.backends module utils - from community.crypto on, all implementations of
CryptoBackendmust overrideget_ordered_csr_identifiers(). The current default implementation, which simply sorts the result ofget_csr_identifiers(), will then be removed (https://github.com/ansible-collections/community.crypto/pull/725). - acme.backends module utils - the
get_cert_information()method for a ACME crypto backend must be implemented from community.crypto 3.0.0 on (https://github.com/ansible-collections/community.crypto/pull/736). - crypto.module_backends.common module utils - the
crypto.module_backends.commonmodule utils is deprecated and will be removed from community.crypto 3.0.0. Use the improvedargspecmodule util instead (https://github.com/ansible-collections/community.crypto/pull/749). - openssl_csr_pipe, openssl_privatekey_pipe, x509_certificate_pipe - the current behavior of check mode is deprecated and will change in community.crypto 3.0.0. The current behavior is similar to the modules without
_pipe: if the object needs to be (re-)generated, only thechangedstatus is set, but the object is not updated. From community.crypto 3.0.0 on, the modules will ignore check mode and always act as if check mode is not active. This behavior can already achieved now by addingcheck_mode: falseto the task. If you think this breaks your use-case of this module, please create an issue in the community.crypto repository (https://github.com/ansible-collections/community.crypto/issues/712, https://github.com/ansible-collections/community.crypto/pull/714).
community.dns
- hetzner_dns_records and hosttech_dns_records inventory plugins - the
filtersoption has been renamed tosimple_filters. The old name will stop working in community.hrobot 2.0.0 (https://github.com/ansible-collections/community.dns/pull/181).
community.docker
- docker_compose - the Docker Compose v1 module is deprecated and will be removed from community.docker 4.0.0. Please migrate to the
community.docker.docker_compose_v2module, which works with Docker Compose v2 (https://github.com/ansible-collections/community.docker/issues/823, https://github.com/ansible-collections/community.docker/pull/833). - docker_container - the default
ignorefor theimage_name_mismatchparameter has been deprecated and will switch torecreatein community.docker 4.0.0. A deprecation warning will be printed in situations where the default value is used and where a behavior would change once the default changes (https://github.com/ansible-collections/community.docker/pull/703). - various modules and plugins - the
ssl_versionoption has been deprecated and will be removed from community.docker 4.0.0. It has already been removed from Docker SDK for Python 7.0.0, and was only necessary in the past to work around SSL/TLS issues (https://github.com/ansible-collections/community.docker/pull/853).
community.general
- MH DependencyCtxMgr module_utils - deprecate
module_utils.mh.mixin.deps.DependencyCtxMgrin favour ofmodule_utils.deps(https://github.com/ansible-collections/community.general/pull/8280). - ModuleHelper module_utils - deprecate
plugins.module_utils.module_helper.AnsibleModule(https://github.com/ansible-collections/community.general/pull/8280). - ModuleHelper module_utils - deprecate
plugins.module_utils.module_helper.DependencyCtxMgr(https://github.com/ansible-collections/community.general/pull/8280). - ModuleHelper module_utils - deprecate
plugins.module_utils.module_helper.StateMixin(https://github.com/ansible-collections/community.general/pull/8280). - ModuleHelper module_utils - deprecate
plugins.module_utils.module_helper.VarDict,(https://github.com/ansible-collections/community.general/pull/8280). - ModuleHelper module_utils - deprecate
plugins.module_utils.module_helper.VarMeta(https://github.com/ansible-collections/community.general/pull/8280). - ModuleHelper module_utils - deprecate
plugins.module_utils.module_helper.VarsMixin(https://github.com/ansible-collections/community.general/pull/8280). - ModuleHelper module_utils - deprecate use of
VarsMixinin favor of using theVardDictmodule_utils (https://github.com/ansible-collections/community.general/pull/8226). - ModuleHelper vars module_utils - bump deprecation of
VarMeta,VarDictandVarsMixinto version 11.0.0 (https://github.com/ansible-collections/community.general/pull/8226). - apt_rpm - the behavior of
state=presentandstate=installedis deprecated and will change in community.general 11.0.0. Right now the module will upgrade a package to the latest version if one of these two states is used. You should explicitly usestate=latestif you want this behavior, and switch tostate=present_not_latestif you do not want to upgrade the package if it is already installed. In community.general 11.0.0 the behavior ofstate=presentandstate=installedwill change to that ofstate=present_not_latest(https://github.com/ansible-collections/community.general/issues/8217, https://github.com/ansible-collections/community.general/pull/8285). - consul_acl - the module has been deprecated and will be removed in community.general 10.0.0.
consul_tokenandconsul_policycan be used instead (https://github.com/ansible-collections/community.general/pull/7901). - django_manage - the
ack_venv_creation_deprecationoption has no more effect and will be removed from community.general 11.0.0 (https://github.com/ansible-collections/community.general/pull/8198). - gitlab modules - the basic auth method on GitLab API have been deprecated and will be removed in community.general 10.0.0 (https://github.com/ansible-collections/community.general/pull/8383).
- hipchat callback plugin - the hipchat service has been discontinued and the self-hosted variant has been End of Life since 2020. The callback plugin is therefore deprecated and will be removed from community.general 10.0.0 if nobody provides compelling reasons to still keep it (https://github.com/ansible-collections/community.general/issues/8184, https://github.com/ansible-collections/community.general/pull/8189).
- irc - the defaults
falseforuse_tlsandvalidate_certshave been deprecated and will change totruein community.general 10.0.0 to improve security. You can already improve security now by explicitly setting them totrue. Specifying values now disables the deprecation warning (https://github.com/ansible-collections/community.general/pull/7578).
community.hrobot
- robot inventory plugin - the
filtersoption has been renamed tosimple_filters. The old name will stop working in community.hrobot 2.0.0 (https://github.com/ansible-collections/community.hrobot/pull/94).
community.okd
- openshift - the
openshiftinventory plugin has been deprecated and will be removed in release 4.0.0 (https://github.com/ansible-collections/kubernetes.core/issues/31).
community.vmware
- vmware_guest_tools_info -
vm_tools_install_statuswill be removed from next major version (5.0.0) of the collection since the API call that provides this information has been deprecated by VMware. Usevm_tools_running_status/vm_tools_version_statusinstead (https://github.com/ansible-collections/community.vmware/issues/2033).
dellemc.openmanage
- The
dellemc_idrac_storage_volumemodule is deprecated and replaced withidrac_storage_volume.
kubernetes.core
- k8s - the
k8sinventory plugin has been deprecated and will be removed in release 4.0.0 (https://github.com/ansible-collections/kubernetes.core/issues/31).
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/porting_guides/porting_guide_10.html