Ansible 6 Porting Guide

Ansible 6 is based on Ansible-core 2.13.

We suggest you read this page along with the Ansible 6 Changelog to understand what updates you may need to make.

Playbook

  • Templating - You can no longer perform arithmetic and concatenation operations outside of the jinja template. The following statement will need to be rewritten to produce [1, 2]:

- name: Prior to 2.13
  debug:
    msg: '[1] + {{ [2] }}'

- name: 2.13 and forward
  debug:
    msg: '{{ [1] + [2] }}'
  • The return value of the __repr__ method of an undefined variable represented by the AnsibleUndefined object changed. {{ '%r'|format(undefined_variable) }} returns AnsibleUndefined(hint=None, obj=missing, name='undefined_variable') in 2.13 as opposed to just AnsibleUndefined in versions 2.12 and prior.

  • The finalize method is no longer exposed in the globals for use in templating. To convert None to an empty string the following expression can be used: {{ value if value is not none }}.

Command Line

No notable changes

Deprecated

No notable changes

Modules

  • To use ansible-core 2.13 for module execution, you must use Python 2 version 2.7 or Python 3 version 3.5 or newer. Any code utilizing ansible.module_utils.basic will not function with lower Python versions.

Modules removed

The following modules no longer exist:

  • No notable changes

Deprecation notices

No notable changes

Noteworthy module changes

No notable changes

Breaking Changes

  • ansible.module_utils.urls.fetch_url will now return the captured HTTPError exception as r. HTTPError is a response like object that can offer more information to module authors. Modules should rely on info['status'] >= 400 to determine if there was a failure, instead of using r is None or catching AttributeError when attempting r.read().

Plugins

No notable changes

Porting custom scripts

No notable changes

Networking

No notable changes

Porting Guide for v6.7.0

Known Issues

community.routeros

  • api_modify - when limits for entries in queue tree are defined as human readable - for example 25M -, the configuration will be correctly set in ROS, but the module will indicate the item is changed on every run even when there was no change done. This is caused by the ROS API which returns the number in bytes - for example 25000000 (which is inconsistent with the CLI behavior). In order to mitigate that, the limits have to be defined in bytes (those will still appear as human readable in the 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 paths are not fully implemeted for ROS6 due to the significat changes between ROS6 and ROS7 (https://github.com/ansible-collections/community.routeros/pull/131).

Major Changes

cisco.meraki

  • meraki_mr_l7_firewall - New module

  • meraki_webhook_payload_template - New module

community.zabbix

  • all modules are opting away from zabbix-api and using httpapi ansible.netcommon plugin. We will support zabbix-api for backwards compatibility until next major release. See our README.md for more information about how to migrate

  • zabbix_agent and zabbix_proxy roles are opting away from zabbix-api and use httpapi ansible.netcommon plugin. We will support zabbix-api for backwards compatibility until next major release. See our README.md for more information about how to migrate

containers.podman

  • New become plugin - podman_unshare

  • Podman generate systemd module

fortinet.fortimanager

  • Fix compatibility issue for ansible 2.9.x and ansible-base 2.10.x.

  • support Ansible changelogs.

fortinet.fortios

  • Support FortiOS v7.0.6, v7.0.7, v7.0.8, v7.2.1, v7.2.2.

Deprecated Features

community.general

  • Please note that some tools, like the VScode plugin (https://github.com/ansible/vscode-ansible/issues/573), or ansible-doc --list --type module, suggest to replace the correct FQCNs for modules and actions in community.general with internal names that have more than three components. For example, community.general.ufw is suggested to be replaced by community.general.system.ufw. While these longer names do work, they are considered internal names by the collection and are subject to change and be removed at all time. They will be removed in community.general 6.0.0 and result in deprecation messages. Avoid using these internal names, and use general three-component FQCNs (community.general.<name_of_module>) instead (https://github.com/ansible-collections/community.general/pull/5373).

Porting Guide for v6.6.0

Added Collections

  • lowlydba.sqlserver (version 1.0.4)

Known Issues

community.routeros

  • The community.routeros.command module claims to support check mode. Since it cannot judge whether the commands executed modify state or not, this behavior is incorrect. Since this potentially breaks existing playbooks, we will not change this behavior until community.routeros 3.0.0.

Breaking Changes

community.general

Major Changes

community.general

fortinet.fortimanager

  • Many fixes for Ansible sanity test warnings & errors.

  • Support FortiManager Schema 7.2.0 , 98 new modules

Deprecated Features

cisco.mso

  • The mso_schema_template_contract_filter contract_filter_type attribute is deprecated. The value is now deduced from filter_type.

community.general

Porting Guide for v6.5.0

Major Changes

infoblox.nios_modules

  • Feature for extra layer security , with cert and key parameters in playbooks for authenticating using certificate and key *.pem file absolute path #154

  • Fix to remove issue causing due to template attr in deleting network using Ansible module nios network #147

Deprecated Features

community.general

Porting Guide for v6.4.0

Added Collections

  • inspur.ispim (version 1.0.1)

  • vultr.cloud (version 1.1.0)

Deprecated Features

community.general

  • proxmox - deprecated the current unprivileged default value, will be changed to true in community.general 7.0.0 (https://github.com/pull/5224).

Porting Guide for v6.3.0

Major Changes

community.mysql

  • mysql_db - the pipefail argument’s default value will be changed to true in community.mysql 4.0.0. If your target machines do not use bash as a default interpreter, set pipefail to false explicitly. However, we strongly recommend setting up bash as a default and pipefail=true as it will protect you from getting broken dumps you don’t know about (https://github.com/ansible-collections/community.mysql/issues/407).

fortinet.fortios

  • Support Diff feature in check_mode.

  • Support Fortios 7.2.0.

Deprecated Features

Porting Guide for v6.2.0

Added Collections

  • ibm.spectrum_virtualize (version 1.9.0)

Known Issues

netapp.ontap

  • na_ontap_snapshot - added documentation to use UTC format for expiry_time.

Major Changes

community.postgresql

Deprecated Features

community.hashi_vault

Porting Guide for v6.1.0

Added Collections

  • purestorage.fusion (version 1.0.2)

Known Issues

dellemc.openmanage

  • idrac_user - Issue(192043) The module may error out with the message unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress. Wait for the job to complete and run the task again.

  • ome_application_alerts_smtp - Issue(212310) - The module does not provide a proper error message if the destination_address is more than 255 characters.

  • ome_application_alerts_syslog - Issue(215374) - The module does not provide a proper error message if the destination_address is more than 255 characters.

  • ome_device_local_access_configuration - Issue(215035) - The module reports Successfully updated the local access setting if an unsupported value is provided for the parameter timeout_limit. However, this value is not actually applied on OpenManage Enterprise Modular.

  • ome_device_local_access_configuration - Issue(217865) - The module does not display a proper error message if an unsupported value is provided for the user_defined and lcd_language parameters.

  • ome_device_network_services - Issue(212681) - The module does not provide a proper error message if unsupported values are provided for the 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_cap is 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(216352) - The module does not display a proper error message if an unsupported value is provided for the ipv6_prefix_length and vlan_id parameters.

  • ome_smart_fabric_uplink - Issue(186024) - The module does not allow the creation of multiple uplinks of the same name even though it is supported by OpenManage Enterprise Modular. If an uplink is created using the same name as an existing uplink, the existing uplink is modified.

Major Changes

chocolatey.chocolatey

  • win_chocolatey - Added bootstrap_script option to allow users to target a script URL for installing Chocolatey on clients.

  • win_chocolatey_facts - Added outdated packages list to data returned.

infoblox.nios_modules

  • Update text field of TXT Record #128

  • Update operation using old_name and new_name for the object with dummy name in old_name (which does not exist in system) will not create a new object in the system. An error will be thrown stating the object does not exist in the system #129

Deprecated Features

cisco.ios

  • Deprecated ios_linkagg_module in favor of ios_lag_interfaces.

community.aws

  • aws_codebuild - The tags parameter currently uses a non-standard format and has been deprecated. In release 6.0.0 this parameter will accept a simple key/value pair dictionary instead of the current list of dictionaries. It is recommended to migrate to using the resource_tags parameter which already accepts the simple dictionary format (https://github.com/ansible-collections/community.aws/pull/1221).

  • route53_info - The CamelCase return values for HostedZones, ResourceRecordSets, and HealthChecks have been deprecated, in the future release you must use snake_case return values hosted_zones, resource_record_sets, and health_checks instead respectively”.

community.crypto

  • Support for Ansible 2.9 and ansible-base 2.10 is deprecated, and will be removed in the next major release (community.crypto 3.0.0). Some modules might still work with these versions afterwards, but we will no longer keep compatibility code that was needed to support them (https://github.com/ansible-collections/community.crypto/pull/460).

community.docker

  • Support for Docker API version 1.20 to 1.24 has been deprecated and will be removed in community.docker 3.0.0. The first Docker version supporting API version 1.25 was Docker 1.13, released in January 2017. This affects the modules docker_container, docker_container_exec, docker_container_info, docker_compose, docker_login, docker_image, docker_image_info, docker_image_load, docker_host_info, docker_network, docker_network_info, docker_node_info, docker_swarm_info, docker_swarm_service, docker_swarm_service_info, docker_volume_info, and docker_volume, whose minimally supported API version is between 1.20 and 1.24 (https://github.com/ansible-collections/community.docker/pull/396).

  • Support for Python 2.6 is deprecated and will be removed in the next major release (community.docker 3.0.0). Some modules might still work with Python 2.6, but we will no longer try to ensure compatibility (https://github.com/ansible-collections/community.docker/pull/388).

community.general

Porting Guide for v6.0.0

Added Collections

  • cisco.dnac (version 6.4.0)

  • community.sap (version 1.0.0)

  • community.sap_libs (version 1.1.0)

  • vmware.vmware_rest (version 2.1.5)

Known Issues

Ansible-core

ansible.netcommon

  • eos - When using eos modules on Ansible 2.9, tasks will occasionally fail with import_modules enabled. This can be avoided by setting import_modules: no

community.general

dellemc.openmanage

  • idrac_user - Issue(192043) The module may error out with the message unable to perform the import or export operation because there are pending attribute changes or a configuration job is in progress. Wait for the job to complete and run the task again.

  • ome_application_alerts_smtp - Issue(212310) - The module does not provide a proper error message if the destination_address is more than 255 characters.

  • ome_application_alerts_syslog - Issue(215374) - The module does not provide a proper error message if the destination_address is more than 255 characters.

  • ome_application_console_preferences - Issue(224690) - The module does not display a proper error message when an unsupported value is provided for the parameters report_row_limit, email_sender_settings, and metric_collection_settings, and the value is applied on OpenManage Enterprise.

  • ome_device_local_access_configuration - Issue(215035) - The module reports Successfully updated the local access setting if an unsupported value is provided for the parameter timeout_limit. However, this value is not actually applied on OpenManage Enterprise Modular.

  • ome_device_local_access_configuration - Issue(217865) - The module does not display a proper error message if an unsupported value is provided for the user_defined and lcd_language parameters.

  • ome_device_network_services - Issue(212681) - The module does not provide a proper error message if unsupported values are provided for the 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_cap is 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_power_settings - Issue(212679) - The module errors out with the following message if the value provided for the parameter power_cap is 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_power_settings - Issue(212679) - The module errors out with the following message if the value provided for the parameter power_cap is 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(216352) - The module does not display a proper error message if an unsupported value is provided for the ipv6_prefix_length and vlan_id parameters.

  • ome_smart_fabric_uplink - Issue(186024) - The module does not allow the creation of multiple uplinks of the same name even though it is supported by OpenManage Enterprise Modular. If an uplink is created using the same name as an existing uplink, the existing uplink is modified.

purestorage.flasharray

  • purefa_admin - Once max_login and lockout have been set there is currently no way to rest these to zero except through the FlashArray GUI

Breaking Changes

Ansible-core

  • Module Python Dependency - Drop support for Python 2.6 in module execution.

  • Templating - it is no longer allowed to perform arithmetic and concatenation operations outside of the jinja template (https://github.com/ansible/ansible/pull/75587)

  • The finalize method is no longer exposed in the globals for use in templating.

amazon.aws

  • aws_caller_facts - Remove deprecated aws_caller_facts alias. Please use aws_caller_info instead.

  • cloudformation_facts - Remove deprecated cloudformation_facts alias. Please use cloudformation_info instead.

  • ec2_ami_facts - Remove deprecated ec2_ami_facts alias. Please use ec2_ami_info instead.

  • ec2_eni_facts - Remove deprecated ec2_eni_facts alias. Please use ec2_eni_info instead.

  • ec2_group_facts - Remove deprecated ec2_group_facts alias. Please use ec2_group_info instead.

  • ec2_instance_facts - Remove deprecated ec2_instance_facts alias. Please use ec2_instance_info instead.

  • ec2_snapshot_facts - Remove deprecated ec2_snapshot_facts alias. Please use ec2_snapshot_info instead.

  • ec2_vol_facts - Remove deprecated ec2_vol_facts alias. Please use ec2_vol_info instead.

  • ec2_vpc_dhcp_option_facts - Remove deprecated ec2_vpc_dhcp_option_facts alias. Please use ec2_vpc_dhcp_option_info instead.

  • ec2_vpc_endpoint_facts - Remove deprecated ec2_vpc_endpoint_facts alias. Please use ec2_vpc_endpoint_info instead.

  • ec2_vpc_igw_facts - Remove deprecated ec2_vpc_igw_facts alias. Please use ec2_vpc_igw_info instead.

  • ec2_vpc_nat_gateway_facts - Remove deprecated ec2_vpc_nat_gateway_facts alias. Please use ec2_vpc_nat_gateway_info instead.

  • ec2_vpc_net_facts - Remove deprecated ec2_vpc_net_facts alias. Please use ec2_vpc_net_info instead.

  • ec2_vpc_route_table_facts - Remove deprecated ec2_vpc_route_table_facts alias. Please use ec2_vpc_route_table_info instead.

  • ec2_vpc_subnet_facts - Remove deprecated ec2_vpc_subnet_facts alias. Please use ec2_vpc_subnet_info instead.

ansible.netcommon

  • httpapi - Change default value of import_modules option from no to yes

  • netconf - Change default value of import_modules option from no to yes

  • network_cli - Change default value of import_modules option from no to yes

arista.eos

  • eos_command - new suboption version of parameter command, which controls the JSON response version. Previously the value was assumed to be “latest” for network_cli and “1” for httpapi, but the default will now be “latest” for both connections. This option is also available for use in modules making their own device requests with plugins.module_utils.network.eos.eos.run_commands() with the same new default behavior. (https://github.com/ansible-collections/arista.eos/pull/258).

  • httpapi - the eos_use_sessions option is now a boolean instead of an integer.

community.aws

  • aws_acm_facts - Remove deprecated alias aws_acm_facts. Please use aws_acm_info instead.

  • aws_kms_facts - Remove deprecated alias aws_kms_facts. Please use aws_kms_info instead.

  • aws_kms_info - Deprecated keys_attr field is now ignored (https://github.com/ansible-collections/community.aws/pull/838).

  • aws_region_facts - Remove deprecated alias aws_region_facts. Please use aws_region_info instead.

  • aws_s3_bucket_facts - Remove deprecated alias aws_s3_bucket_facts. Please use aws_s3_bucket_info instead.

  • aws_sgw_facts - Remove deprecated alias aws_sgw_facts. Please use aws_sgw_info instead.

  • aws_waf_facts - Remove deprecated alias aws_waf_facts. Please use aws_waf_info instead.

  • cloudfront_facts - Remove deprecated alias cloudfront_facts. Please use cloudfront_info instead.

  • cloudwatchlogs_log_group_facts - Remove deprecated alias cloudwatchlogs_log_group_facts. Please use cloudwatchlogs_log_group_info instead.

  • dynamodb_table - deprecated updates currently ignored for primary keys and global_all indexes will now result in a failure. (https://github.com/ansible-collections/community.aws/pull/837).

  • ec2_asg_facts - Remove deprecated alias ec2_asg_facts. Please use ec2_asg_info instead.

  • ec2_customer_gateway_facts - Remove deprecated alias ec2_customer_gateway_facts. Please use ec2_customer_gateway_info instead.

  • ec2_eip_facts - Remove deprecated alias ec2_eip_facts. Please use ec2_eip_info instead.

  • ec2_elb_facts - Remove deprecated alias ec2_elb_facts. Please use ec2_elb_info instead.

  • ec2_elb_info - The ec2_elb_info module has been removed. Please use the ``elb_classic_lb_info module.

  • ec2_lc_facts - Remove deprecated alias ec2_lc_facts. Please use ec2_lc_info instead.

  • ec2_placement_group_facts - Remove deprecated alias ec2_placement_group_facts. Please use ec2_placement_group_info instead.

  • ec2_vpc_nacl_facts - Remove deprecated alias ec2_vpc_nacl_facts. Please use ec2_vpc_nacl_info instead.

  • ec2_vpc_peering_facts - Remove deprecated alias ec2_vpc_peering_facts. Please use ec2_vpc_peering_info instead.

  • ec2_vpc_route_table_facts - Remove deprecated alias ec2_vpc_route_table_facts. Please use ec2_vpc_route_table_info instead.

  • ec2_vpc_vgw_facts - Remove deprecated alias ec2_vpc_vgw_facts. Please use ec2_vpc_vgw_info instead.

  • ec2_vpc_vpn_facts - Remove deprecated alias ec2_vpc_vpn_facts. Please use ec2_vpc_vpn_info instead.

  • ecs_service_facts - Remove deprecated alias ecs_service_facts. Please use ecs_service_info instead.

  • ecs_taskdefinition_facts - Remove deprecated alias ecs_taskdefinition_facts. Please use ecs_taskdefinition_info instead.

  • efs_facts - Remove deprecated alias efs_facts. Please use efs_info instead.

  • elasticache_facts - Remove deprecated alias elasticache_facts. Please use elasticache_info instead.

  • elb_application_lb_facts - Remove deprecated alias elb_application_lb_facts. Please use elb_application_lb_info instead.

  • elb_classic_lb_facts - Remove deprecated alias elb_classic_lb_facts. Please use elb_classic_lb_info instead.

  • elb_target_facts - Remove deprecated alias elb_target_facts. Please use elb_target_info instead.

  • elb_target_group_facts - Remove deprecated alias elb_target_group_facts. Please use elb_target_group_info instead.

  • iam - Removed deprecated community.aws.iam module. Please use community.aws.iam_user, community.aws.iam_access_key or community.aws.iam_group (https://github.com/ansible-collections/community.aws/pull/839).

  • iam_cert_facts - Remove deprecated alias iam_cert_facts. Please use iam_cert_info instead.

  • iam_mfa_device_facts - Remove deprecated alias iam_mfa_device_facts. Please use iam_mfa_device_info instead.

  • iam_role_facts - Remove deprecated alias iam_role_facts. Please use iam_role_info instead.

  • iam_server_certificate_facts - Remove deprecated alias iam_server_certificate_facts. Please use iam_server_certificate_info instead.

  • lambda_facts - Remove deprecated module lambda_facts``. Please use lambda_info instead.

  • rds - Removed deprecated community.aws.rds module. Please use community.aws.rds_instance (https://github.com/ansible-collections/community.aws/pull/839).

  • rds_instance_facts - Remove deprecated alias rds_instance_facts. Please use rds_instance_info instead.

  • rds_snapshot_facts - Remove deprecated alias rds_snapshot_facts. Please use rds_snapshot_info instead.

  • redshift_facts - Remove deprecated alias redshift_facts. Please use redshift_info instead.

  • route53_facts - Remove deprecated alias route53_facts. Please use route53_info instead.

community.general

community.mysql

community.vmware

  • The collection now requires at least ansible-core 2.11.0. Ansible 3 and before, and ansible-base versions are no longer supported.

  • vmware_cluster_drs - The default for enable has been changed from false to true.

  • vmware_cluster_drs - The parameter alias enable_drs has been removed, use enable instead.

  • vmware_cluster_ha - The default for enable has been changed from false to true.

  • vmware_cluster_ha - The parameter alias enable_ha has been removed, use enable instead.

  • vmware_cluster_vsan - The default for enable has been changed from false to true.

  • vmware_cluster_vsan - The parameter alias enable_vsan has been removed, use enable instead.

  • vmware_guest - Virtualization Based Security has some requirements (nested_virt, secure_boot and iommu) that the module silently enabled. They have to be enabled explicitly now.

dellemc.openmanage

  • HTTPS SSL certificate validation is a breaking change and will require modification in the existing playbooks. Please refer to SSL Certificate Validation section in the README.md for modification to existing playbooks.

theforeman.foreman

  • Set use_reports_api default value to true for the inventory plugin

  • Support for Ansible 2.8 is removed

Major Changes

  • Add a ansible-community CLI tool that allows to print the version of the Ansible community distribution. Use ansible-community --version to print this version.

Ansible-core

amazon.aws

  • amazon.aws collection - The amazon.aws collection has dropped support for botocore<1.19.0 and boto3<1.16.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/574).

ansible.netcommon

  • cli_parse - this module has been moved to the ansible.utils collection. ansible.netcommon.cli_parse will continue to work to reference the module in its new location, but this redirect will be removed in a future release

  • network_cli - Change default value of ssh_type option from paramiko to auto. This value will use libssh if the ansible-pylibssh module is installed, otherwise will fallback to paramiko.

arista.eos

chocolatey.chocolatey

  • win_chocolatey - Added choco_args option to pass additional arguments directly to Chocolatey.

cisco.asa

  • Minimum required ansible.netcommon version is 2.5.1.

  • Updated base plugin references to ansible.netcommon.

cisco.ios

  • Minimum required ansible.netcommon version is 2.5.1.

  • Updated base plugin references to ansible.netcommon.

  • facts - default value for gather_subset is changed to min instead of !config.

cisco.iosxr

  • Minimum required ansible.netcommon version is 2.5.1.

  • Updated base plugin references to ansible.netcommon.

  • facts - default value for gather_subset is changed to min instead of !config.

cisco.ise

  • Update ciscoisesdk requirement to 1.2.0

  • anc_endpoint_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • anc_policy_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • backup_last_status_info - change return value, it returns response content.

  • device_administration_authentication_rules - deletes parameter identitySourceId.

  • device_administration_authentication_rules_info - change return value, it returns response content.

  • device_administration_authorization_rules_info - change return value, it returns response content.

  • device_administration_conditions - deletes parameter attributeId.

  • device_administration_conditions_for_authentication_rule_info - change return value, it returns response content.

  • device_administration_conditions_for_authorization_rule_info - change return value, it returns response content.

  • device_administration_conditions_for_policy_set_info - change return value, it returns response content.

  • device_administration_conditions_info - change return value, it returns response content.

  • device_administration_dictionary_attributes_authentication_info - change return value, it returns response content.

  • device_administration_dictionary_attributes_authorization_info - change return value, it returns response content.

  • device_administration_dictionary_attributes_policy_set_info - change return value, it returns response content.

  • device_administration_global_exception_rules_info - change return value, it returns response content.

  • device_administration_network_conditions_info - change return value, it returns response content.

  • device_administration_time_date_conditions - deletes parameter attributeId.

  • device_administration_time_date_conditions_info - change return value, it returns response content.

  • egress_matrix_cell_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • network_access_authentication_rules - deletes parameter identitySourceId.

  • network_access_conditions - deletes parameter attributeId.

  • network_access_time_date_conditions - deletes parameter attributeId.

  • node_deployment - update parameters.

  • node_deployment_info - add filter and filterType parameters.

  • node_group - fixes response recollection.

  • node_group_info - fixes response recollection.

  • repository_files_info - change return value, it returns response content.

  • repository_info - change return value, it returns response content.

  • sg_acl_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • sg_mapping_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • sg_mapping_group_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • sg_mapping_group_info - change return value, it returns BulkStatus content.

  • sg_to_vn_to_vlan_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • sgt - change generationId type from int to str.

  • sgt_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • sxp_connections_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • sxp_local_bindings_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • sxp_vpns_bulk_monitor_status_info - change return value, it returns BulkStatus content.

  • system_certificate - new parameters portalTagTransferForSameSubject and roleTransferForSameSubject.

  • system_certificate - portalTagTransferForSameSubject parameter renamed to allowPortalTagTransferForSameSubject.

  • system_certificate - roleTransferForSameSubject parameter renamed to allowRoleTransferForSameSubject.

  • system_certificate_import - new parameters portalTagTransferForSameSubject and roleTransferForSameSubject.

  • system_certificate_import - portalTagTransferForSameSubject parameter renamed to allowPortalTagTransferForSameSubject.

  • system_certificate_import - roleTransferForSameSubject parameter renamed to allowRoleTransferForSameSubject.

  • trustsec_nbar_app_info - change type from str to list.

  • trustsec_vn_info - change type from str to list.

cisco.meraki

  • meraki_mr_radio - New module

cisco.nxos

  • The minimum required ansible.netcommon version has been bumped to v2.6.1.

  • Updated base plugin references to ansible.netcommon.

  • nxos_facts - change default gather_subset to min from !config (https://github.com/ansible-collections/cisco.nxos/issues/418).

  • nxos_file_copy has been rewritten as a module. This change also removes the dependency on pexpect for file_pull operation. Since this now uses AnsibleModule class for argspec validation, the validation messages will be slighlty different. Expect changes in the return payload in some cases. All functionality remains unchanged.

community.aws

community.general

  • The community.general collection no longer supports Ansible 2.9 and ansible-base 2.10. While we take no active measures to prevent usage, we will remove a lot of compatibility code and other compatility measures that will effectively prevent using most content from this collection with Ansible 2.9, and some content of this collection with ansible-base 2.10. Both Ansible 2.9 and ansible-base 2.10 will very soon be End of Life and if you are still using them, you should consider upgrading to ansible-core 2.11 or later as soon as possible (https://github.com/ansible-collections/community.general/pull/4548).

community.mysql

  • The community.mysql collection no longer supports Ansible 2.9 and ansible-base 2.10. While we take no active measures to prevent usage and there are no plans to introduce incompatible code to the modules, we will stop testing against Ansible 2.9 and ansible-base 2.10. Both will very soon be End of Life and if you are still using them, you should consider upgrading to the latest Ansible / ansible-core 2.11 or later as soon as possible (https://github.com/ansible-collections/community.mysql/pull/343).

community.network

  • The community.network collection no longer supports Ansible 2.9 and ansible-base 2.10. While we take no active measures to prevent usage, we will remove compatibility code and other compatility measures that will effectively prevent using most content from this collection with Ansible 2.9, and some content of this collection with ansible-base 2.10. Both Ansible 2.9 and ansible-base 2.10 will very soon be End of Life and if you are still using them, you should consider upgrading to ansible-core 2.11 or later as soon as possible (https://github.com/ansible-collections/community.network/pull/426).

community.postgresql

community.vmware

containers.podman

  • Add podman_tag module

  • Add secrets driver and driver opts support

dellemc.openmanage

  • All modules can read custom or organizational CA signed certificate from the environment variables. Please refer to SSL Certificate Validation section in the README.md for modification to existing playbooks or setting environment variable.

  • All modules now support SSL over HTTPS and socket level timeout.

  • idrac_server_config_profile - The module is enhanced to support export, import, and preview the SCP configuration using Redfish and added support for check mode.

f5networks.f5_modules

  • bigip_device_info - pagination logic has also been added to help with api stability.

  • bigip_device_info - the module no longer gathers information from all partitions on device. This change will stabalize the module by gathering resources only from the given partition and prevent the module from gathering way too much information that might result in crashing.

fortinet.fortios

  • Support FortiOS 7.0.2, 7.0.3, 7.0.4, 7.0.5.

frr.frr

  • Minimum required ansible.netcommon version is 2.5.1.

  • Updated base plugin references to ansible.netcommon.

ibm.qradar

  • Minimum required ansible.netcommon version is 2.5.1.

  • Updated base plugin references to ansible.netcommon.

junipernetworks.junos

  • Minimum required ansible.netcommon version is 2.5.1.

  • Updated base plugin references to ansible.netcommon.

  • junos_facts - change default gather_subset to min from !config.

ovirt.ovirt

splunk.es

  • Minimum required ansible.netcommon version is 2.5.1.

  • Updated base plugin references to ansible.netcommon.

vyos.vyos

Removed Collections

  • community.kubernetes (previously included version: 2.0.1)

  • community.kubevirt (previously included version: 1.0.0)

Removed Features

  • The community.kubernetes collection has been removed from Ansible 6. It has been deprecated since Ansible 4.2, and version 2.0.0 included since Ansible 5 is only a set of deprecated redirects from community.kubernetes to kubernetes.core. If you still need the redirects, you can manually install community.kubernetes with ansible-galaxy collection install community.kubernetes (https://github.com/ansible-community/community-topics/issues/93).

  • The community.kubevirt collection has been removed from Ansible 6. It has not been working with the community.kubernetes collection included since Ansible 5.0.0, and unfortunately nobody managed to adjust the collection to work with kubernetes.core >= 2.0.0. If you need to use this collection, you need to manually install community.kubernetes < 2.0.0 together with community.kubevirt with ansible-galaxy collection install community.kubevirt 'community.kubernetes:<2.0.0' (https://github.com/ansible-community/community-topics/issues/92).

Ansible-core

community.general

community.hashi_vault

community.network

community.vmware

  • vcenter_extension_facts - The deprecated module vcenter_extension_facts has been removed, use vcenter_extension_info instead.

  • vmware_about_facts - The deprecated module vmware_about_facts has been removed, use vmware_about_info instead.

  • vmware_category_facts - The deprecated module vmware_category_facts has been removed, use vmware_category_info instead.

  • vmware_cluster - Remove DRS configuration in favour of module vmware_cluster_drs.

  • vmware_cluster - Remove HA configuration in favour of module vmware_cluster_ha.

  • vmware_cluster - Remove VSAN configuration in favour of module vmware_cluster_vsan.

  • vmware_cluster_facts - The deprecated module vmware_cluster_facts has been removed, use vmware_cluster_info instead.

  • vmware_datastore_facts - The deprecated module vmware_datastore_facts has been removed, use vmware_datastore_info instead.

  • vmware_drs_group_facts - The deprecated module vmware_drs_group_facts has been removed, use vmware_drs_group_info instead.

  • vmware_drs_rule_facts - The deprecated module vmware_drs_rule_facts has been removed, use vmware_drs_rule_info instead.

  • vmware_dvs_portgroup - The deprecated parameter portgroup_type has been removed, use port_binding instead.

  • vmware_dvs_portgroup_facts - The deprecated module vmware_dvs_portgroup_facts has been removed, use vmware_dvs_portgroup_info instead.

  • vmware_guest_boot_facts - The deprecated module vmware_guest_boot_facts has been removed, use vmware_guest_boot_info instead.

  • vmware_guest_customization_facts - The deprecated module vmware_guest_customization_facts has been removed, use vmware_guest_customization_info instead.

  • vmware_guest_disk_facts - The deprecated module vmware_guest_disk_facts has been removed, use vmware_guest_disk_info instead.

  • vmware_guest_facts - The deprecated module vmware_guest_facts has been removed, use vmware_guest_info instead.

  • vmware_guest_snapshot_facts - The deprecated module vmware_guest_snapshot_facts has been removed, use vmware_guest_snapshot_info instead.

  • vmware_host_capability_facts - The deprecated module vmware_host_capability_facts has been removed, use vmware_host_capability_info instead.

  • vmware_host_config_facts - The deprecated module vmware_host_config_facts has been removed, use vmware_host_config_info instead.

  • vmware_host_dns_facts - The deprecated module vmware_host_dns_facts has been removed, use vmware_host_dns_info instead.

  • vmware_host_feature_facts - The deprecated module vmware_host_feature_facts has been removed, use vmware_host_feature_info instead.

  • vmware_host_firewall_facts - The deprecated module vmware_host_firewall_facts has been removed, use vmware_host_firewall_info instead.

  • vmware_host_ntp_facts - The deprecated module vmware_host_ntp_facts has been removed, use vmware_host_ntp_info instead.

  • vmware_host_package_facts - The deprecated module vmware_host_package_facts has been removed, use vmware_host_package_info instead.

  • vmware_host_service_facts - The deprecated module vmware_host_service_facts has been removed, use vmware_host_service_info instead.

  • vmware_host_ssl_facts - The deprecated module vmware_host_ssl_facts has been removed, use vmware_host_ssl_info instead.

  • vmware_host_vmhba_facts - The deprecated module vmware_host_vmhba_facts has been removed, use vmware_host_vmhba_info instead.

  • vmware_host_vmnic_facts - The deprecated module vmware_host_vmnic_facts has been removed, use vmware_host_vmnic_info instead.

  • vmware_local_role_facts - The deprecated module vmware_local_role_facts has been removed, use vmware_local_role_info instead.

  • vmware_local_user_facts - The deprecated module vmware_local_user_facts has been removed, use vmware_local_user_info instead.

  • vmware_portgroup_facts - The deprecated module vmware_portgroup_facts has been removed, use vmware_portgroup_info instead.

  • vmware_resource_pool_facts - The deprecated module vmware_resource_pool_facts has been removed, use vmware_resource_pool_info instead.

  • vmware_tag_facts - The deprecated module vmware_tag_facts has been removed, use vmware_tag_info instead.

  • vmware_target_canonical_facts - The deprecated module vmware_target_canonical_facts has been removed, use vmware_target_canonical_info instead.

  • vmware_vm_facts - The deprecated module vmware_vm_facts has been removed, use vmware_vm_info instead.

  • vmware_vmkernel_facts - The deprecated module vmware_vmkernel_facts has been removed, use vmware_vmkernel_info instead.

  • vmware_vmkernel_ip_config - The deprecated module vmware_vmkernel_ip_config has been removed, use vmware_vmkernel instead.

  • vmware_vswitch_facts - The deprecated module vmware_vswitch_facts has been removed, use vmware_vswitch_info instead.

Deprecated Features

  • The collection community.sap has been renamed to community.sap_libs. For now both collections are included in Ansible. The content in community.sap will be replaced with deprecated redirects to the new collection in Ansible 7.0.0, and these redirects will eventually be removed from Ansible. Please update your FQCNs for community.sap.

Ansible-core

  • ansible-core - Remove support for Python 2.6.

  • ansible-test - Remove support for Python 2.6.

  • ssh connection plugin option scp_if_ssh in favor of ssh_transfer_method.

amazon.aws

  • ec2_instance - The default value for `instance_type` has been deprecated, in the future release you must set an instance_type or a launch_template (https://github.com/ansible-collections/amazon.aws/pull/587).

  • module_utils - support for the original AWS SDK boto has been deprecated in favour of the boto3/botocore SDK. All boto based modules have either been deprecated or migrated to botocore, and the remaining support code in module_utils will be removed in release 4.0.0 of the amazon.aws collection. Any modules outside of the amazon.aws and community.aws collections based on the boto library will need to be migrated to the boto3/botocore libraries (https://github.com/ansible-collections/amazon.aws/pull/575).

cisco.ios

  • Deprecates lldp module.

  • ios_acls - Deprecated fragment attribute added boolean alternate as enable_fragment.

cisco.nxos

  • Deprecated nxos_snmp_community module.

  • Deprecated nxos_snmp_contact module.

  • Deprecated nxos_snmp_host module.

  • Deprecated nxos_snmp_location module.

  • Deprecated nxos_snmp_traps module.

  • Deprecated nxos_snmp_user module.

community.docker

community.general

community.hashi_vault

community.network

  • Support for Ansible 2.9 and ansible-base 2.10 is deprecated, and will be removed in the next major release (community.network 4.0.0) this spring. While most content will probably still work with ansible-base 2.10, we will remove symbolic links for modules and action plugins, which will make it impossible to use them with Ansible 2.9 anymore. Please use community.network 3.x.y with Ansible 2.9 and ansible-base 2.10, as these releases will continue to support Ansible 2.9 and ansible-base 2.10 even after they are End of Life (https://github.com/ansible-community/community-topics/issues/50, https://github.com/ansible-collections/community.network/pull/382).

junipernetworks.junos

  • ‘router_id’ options is deprecated from junos_ospf_interfaces, junos_ospfv2 and junos_ospfv3 resuorce module.

purestorage.flasharray

  • purefa_sso - Deprecated in favor of M(purefa_admin). Will be removed in Collection 2.0