Ansible 2.9 Porting Guide¶
This section discusses the behavioral changes between Ansible 2.8 and Ansible 2.9.
It is intended to assist in updating your playbooks, plugins and other parts of your Ansible infrastructure so they will work with this version of Ansible.
We suggest you read this page along with Ansible Changelog for 2.9 to understand what updates you may need to make.
This document is part of a collection on porting. The complete list of porting guides can be found at porting guides.
Topics
Playbook¶
Inventory¶
hash_behaviour
now affects inventory sources. If you have it set tomerge
, the data you get from inventory might change and you will have to update playbooks accordingly. If you’re using the default setting (overwrite
), you will see no changes. Inventory was ignoring this setting.
Loops¶
Ansible 2.9 handles “unsafe” data more robustly, ensuring that data marked “unsafe” is not templated. In previous versions, Ansible recursively marked all data returned by the direct use of lookup()
as “unsafe”, but only marked structured data returned by indirect lookups using with_X
style loops as “unsafe” if the returned elements were strings. Ansible 2.9 treats these two approaches consistently.
As a result, if you use with_dict
to return keys with templatable values, your templates may no longer work as expected in Ansible 2.9.
To allow the old behavior, switch from using with_X
to using loop
with a filter as described at Migrating from with_X to loop.
Command Line¶
The location of the Galaxy token file has changed from
~/.ansible_galaxy
to~/.ansible/galaxy_token
. You can configure both path and file name with the GALAXY_TOKEN_PATH config.
Deprecated¶
No notable changes
Collection loader changes¶
The way to import a PowerShell or C# module util from a collection has changed in the Ansible 2.9 release. In Ansible 2.8 a util was imported with the following syntax:
#AnsibleRequires -CSharpUtil AnsibleCollections.namespace_name.collection_name.util_filename
#AnsibleRequires -PowerShell AnsibleCollections.namespace_name.collection_name.util_filename
In Ansible 2.9 this was changed to:
#AnsibleRequires -CSharpUtil ansible_collections.namespace_name.collection_name.plugins.module_utils.util_filename
#AnsibleRequires -PowerShell ansible_collections.namespace_name.collection_name.plugins.module_utils.util_filename
The change in the collection import name also requires any C# util namespaces to be updated with the newer name format. This is more verbose but is designed to make sure we avoid plugin name conflicts across separate plugin types and to standardise how imports work in PowerShell with how Python modules work.
Modules¶
The
win_get_url
andwin_uri
module now sends requests with a defaultUser-Agent
ofansible-httpget
. This can be changed by using thehttp_agent
key.The
apt
module now honorsupdate_cache=false
while installing its own dependency and skips the cache update. Explicitly settingupdate_cache=true
or omitting the paramupdate_cache
will result in a cache update while installing its own dependency.
Renaming from _facts
to _info
¶
Ansible 2.9 renamed a lot of modules from <something>_facts
to <something>_info
, because the modules do not return Ansible facts. Ansible facts relate to a specific host. For example, the configuration of a network interface, the operating system on a unix server, and the list of packages installed on a Windows box are all Ansible facts. The renamed modules return values that are not unique to the host. For example, account information or region data for a cloud provider. Renaming these modules should provide more clarity about the types of return values each set of modules offers.
Writing modules¶
Module and module_utils files can now use relative imports to include other module_utils files. This is useful for shortening long import lines, especially in collections.
Example of using a relative import in collections:
# File: ansible_collections/my_namespace/my_collection/plugins/modules/my_module.py # Old way to use an absolute import to import module_utils from the collection: from ansible_collections.my_namespace.my_collection.plugins.module_utils import my_util # New way using a relative import: from ..module_utils import my_util
Modules and module_utils shipped with Ansible can use relative imports as well but the savings are smaller:
# File: ansible/modules/system/ping.py # Old way to use an absolute import to import module_utils from core: from ansible.module_utils.basic import AnsibleModule # New way using a relative import: from ...module_utils.basic import AnsibleModule
Each single dot (
.
) represents one level of the tree (equivalent to../
in filesystem relative links).See also
The Python Relative Import Docs go into more detail of how to write relative imports.
Modules removed¶
The following modules no longer exist:
Apstra’s
aos_*
modules. See the new modules at https://github.com/apstra.ec2_ami_find use ec2_ami_facts instead.
kubernetes use k8s_raw instead.
nxos_ip_interface use nxos_l3_interface instead.
nxos_portchannel use nxos_linkagg instead.
nxos_switchport use nxos_l2_interface instead.
oc use openshift_raw instead.
panos_nat_policy use panos_nat_rule instead.
panos_security_policy use panos_security_rule instead.
vsphere_guest use vmware_guest instead.
Deprecation notices¶
The following modules will be removed in Ansible 2.13. Please update update your playbooks accordingly.
cs_instance_facts use cs_instance_info instead.
cs_zone_facts use cs_zone_info instead.
digital_ocean_sshkey_facts use digital_ocean_sshkey_info instead.
eos_interface use eos_interfaces instead.
eos_l2_interface use eos_l2_interfaces instead.
eos_l3_interface use eos_l3_interfaces instead.
eos_linkagg use eos_lag_interfaces instead.
eos_lldp_interface use eos_lldp_interfaces instead.
eos_vlan use eos_vlans instead.
ios_interface use ios_interfaces instead.
ios_l2_interface use ios_l2_interfaces instead.
ios_l3_interface use ios_l3_interfaces instead.
ios_vlan use ios_vlans instead.
iosxr_interface use iosxr_interfaces instead.
junos_interface use junos_interfaces instead.
junos_l2_interface use junos_l2_interfaces instead.
junos_l3_interface use junos_l3_interfaces instead.
junos_linkagg use junos_lag_interfaces instead.
junos_lldp use junos_lldp_global instead.
junos_lldp_interface use junos_lldp_interfaces instead.
junos_vlan use junos_vlans instead.
lambda_facts use lambda_info instead.
na_ontap_gather_facts use na_ontap_info instead.
net_banner use the platform-specific [netos]_banner modules instead.
net_interface use the new platform-specific [netos]_interfaces modules instead.
net_l2_interface use the new platform-specific [netos]_l2_interfaces modules instead.
net_l3_interface use the new platform-specific [netos]_l3_interfaces modules instead.
net_linkagg use the new platform-specific [netos]_lag modules instead.
net_lldp use the new platform-specific [netos]_lldp_global modules instead.
net_lldp_interface use the new platform-specific [netos]_lldp_interfaces modules instead.
net_logging use the platform-specific [netos]_logging modules instead.
net_static_route use the platform-specific [netos]_static_route modules instead.
net_system use the platform-specific [netos]_system modules instead.
net_user use the platform-specific [netos]_user modules instead.
net_vlan use the new platform-specific [netos]_vlans modules instead.
net_vrf use the platform-specific [netos]_vrf modules instead.
nginx_status_facts use nginx_status_info instead.
nxos_interface use nxos_interfaces instead.
nxos_l2_interface use nxos_l2_interfaces instead.
nxos_l3_interface use nxos_l3_interfaces instead.
nxos_linkagg use nxos_lag_interfaces instead.
nxos_vlan use nxos_vlans instead.
online_server_facts use online_server_info instead.
online_user_facts use online_user_info instead.
purefa_facts use purefa_info instead.
purefb_facts use purefb_info instead.
scaleway_image_facts use scaleway_image_info instead.
scaleway_ip_facts use scaleway_ip_info instead.
scaleway_organization_facts use scaleway_organization_info instead.
scaleway_security_group_facts use scaleway_security_group_info instead.
scaleway_server_facts use scaleway_server_info instead.
scaleway_snapshot_facts use scaleway_snapshot_info instead.
scaleway_volume_facts use scaleway_volume_info instead.
vcenter_extension_facts use vcenter_extension_info instead.
vmware_about_facts use vmware_about_info instead.
vmware_category_facts use vmware_category_info instead.
vmware_drs_group_facts use vmware_drs_group_info instead.
vmware_drs_rule_facts use vmware_drs_rule_info instead.
vmware_dvs_portgroup_facts use vmware_dvs_portgroup_info instead.
vmware_guest_boot_facts use vmware_guest_boot_info instead.
vmware_guest_customization_facts use vmware_guest_customization_info instead.
vmware_guest_disk_facts use vmware_guest_disk_info instead.
vmware_host_capability_facts use vmware_host_capability_info instead.
vmware_host_config_facts use vmware_host_config_info instead.
vmware_host_dns_facts use vmware_host_dns_info instead.
vmware_host_feature_facts use vmware_host_feature_info instead.
vmware_host_firewall_facts use vmware_host_firewall_info instead.
vmware_host_ntp_facts use vmware_host_ntp_info instead.
vmware_host_package_facts use vmware_host_package_info instead.
vmware_host_service_facts use vmware_host_service_info instead.
vmware_host_ssl_facts use vmware_host_ssl_info instead.
vmware_host_vmhba_facts use vmware_host_vmhba_info instead.
vmware_host_vmnic_facts use vmware_host_vmnic_info instead.
vmware_local_role_facts use vmware_local_role_info instead.
vmware_local_user_facts use vmware_local_user_info instead.
vmware_portgroup_facts use vmware_portgroup_info instead.
vmware_resource_pool_facts use vmware_resource_pool_info instead.
vmware_target_canonical_facts use vmware_target_canonical_info instead.
vmware_vmkernel_facts use vmware_vmkernel_info instead.
vmware_vswitch_facts use vmware_vswitch_info instead.
vultr_account_facts use vultr_account_info instead.
vultr_block_storage_facts use vultr_block_storage_info instead.
vultr_dns_domain_facts use vultr_dns_domain_info instead.
vultr_firewall_group_facts use vultr_firewall_group_info instead.
vultr_network_facts use vultr_network_info instead.
vultr_os_facts use vultr_os_info instead.
vultr_plan_facts use vultr_plan_info instead.
vultr_region_facts use vultr_region_info instead.
vultr_server_facts use vultr_server_info instead.
vultr_ssh_key_facts use vultr_ssh_key_info instead.
vultr_startup_script_facts use vultr_startup_script_info instead.
vultr_user_facts use vultr_user_info instead.
vyos_interface use vyos_interfaces instead.
vyos_l3_interface use vyos_l3_interfaces instead.
vyos_linkagg use vyos_lag_interfaces instead.
vyos_lldp use vyos_lldp_global instead.
vyos_lldp_interface use vyos_lldp_interfaces instead.
The following functionality will be removed in Ansible 2.12. Please update update your playbooks accordingly.
vmware_cluster
DRS, HA and VSAN configuration; use vmware_cluster_drs, vmware_cluster_ha and vmware_cluster_vsan instead.
The following functionality will be removed in Ansible 2.13. Please update update your playbooks accordingly.
openssl_certificate
deprecates theassertonly
provider. Please see the openssl_certificate documentation examples on how to replace the provider with the openssl_certificate_info, openssl_csr_info, openssl_privatekey_info and assert modules.
For the following modules, the PyOpenSSL-based backend pyopenssl
has been deprecated and will be
removed in Ansible 2.13:
get_certificate
openssl_certificate
openssl_certificate_info
openssl_csr
openssl_csr_info
openssl_privatekey
openssl_privatekey_info
openssl_publickey
Renamed modules¶
The following modules have been renamed. The old name is deprecated and will be removed in Ansible 2.13. Please update update your playbooks accordingly.
The
ali_instance_facts
module was renamed to ali_instance_info.The
aws_acm_facts
module was renamed to aws_acm_info.The
aws_az_facts
module was renamed to aws_az_info.The
aws_caller_facts
module was renamed to aws_caller_info.The
aws_kms_facts
module was renamed to aws_kms_info.The
aws_region_facts
module was renamed to aws_region_info.The
aws_s3_bucket_facts
module was renamed to aws_s3_bucket_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
aws_sgw_facts
module was renamed to aws_sgw_info.The
aws_waf_facts
module was renamed to aws_waf_info.The
azure_rm_aks_facts
module was renamed to azure_rm_aks_info.The
azure_rm_aksversion_facts
module was renamed to azure_rm_aksversion_info.The
azure_rm_applicationsecuritygroup_facts
module was renamed to azure_rm_applicationsecuritygroup_info.The
azure_rm_appserviceplan_facts
module was renamed to azure_rm_appserviceplan_info.The
azure_rm_automationaccount_facts
module was renamed to azure_rm_automationaccount_info.The
azure_rm_autoscale_facts
module was renamed to azure_rm_autoscale_info.The
azure_rm_availabilityset_facts
module was renamed to azure_rm_availabilityset.The
azure_rm_cdnendpoint_facts
module was renamed to azure_rm_cdnendpoint_info.The
azure_rm_cdnprofile_facts
module was renamed to azure_rm_cdnprofile_info.The
azure_rm_containerinstance_facts
module was renamed to azure_rm_containerinstance_info.The
azure_rm_containerregistry_facts
module was renamed to azure_rm_containerregistry_info.The
azure_rm_cosmosdbaccount_facts
module was renamed to azure_rm_cosmosdbaccount_info.The
azure_rm_deployment_facts
module was renamed to azure_rm_deployment_info.The
azure_rm_resourcegroup_facts
module was renamed to azure_rm_resourcegroup_info.The
bigip_device_facts
module was renamed to bigip_device_info.The
bigiq_device_facts
module was renamed to bigiq_device_info.The
cloudformation_facts
module was renamed to cloudformation_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
cloudfront_facts
module was renamed to cloudfront_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
cloudwatchlogs_log_group_facts
module was renamed to cloudwatchlogs_log_group_info.The
digital_ocean_account_facts
module was renamed to digital_ocean_account_info.The
digital_ocean_certificate_facts
module was renamed to digital_ocean_certificate_info.The
digital_ocean_domain_facts
module was renamed to digital_ocean_domain_info.The
digital_ocean_firewall_facts
module was renamed to digital_ocean_firewall_info.The
digital_ocean_floating_ip_facts
module was renamed to digital_ocean_floating_ip_info.The
digital_ocean_image_facts
module was renamed to digital_ocean_image_info.The
digital_ocean_load_balancer_facts
module was renamed to digital_ocean_load_balancer_info.The
digital_ocean_region_facts
module was renamed to digital_ocean_region_info.The
digital_ocean_size_facts
module was renamed to digital_ocean_size_info.The
digital_ocean_snapshot_facts
module was renamed to digital_ocean_snapshot_info.The
digital_ocean_tag_facts
module was renamed to digital_ocean_tag_info.The
digital_ocean_volume_facts
module was renamed to digital_ocean_volume_info.The
ec2_ami_facts
module was renamed to ec2_ami_info.The
ec2_asg_facts
module was renamed to ec2_asg_info.The
ec2_customer_gateway_facts
module was renamed to ec2_customer_gateway_info.The
ec2_eip_facts
module was renamed to ec2_eip_info.The
ec2_elb_facts
module was renamed to ec2_elb_info.The
ec2_eni_facts
module was renamed to ec2_eni_info.The
ec2_group_facts
module was renamed to ec2_group_info.The
ec2_instance_facts
module was renamed to ec2_instance_info.The
ec2_lc_facts
module was renamed to ec2_lc_info.The
ec2_placement_group_facts
module was renamed to ec2_placement_group_info.The
ec2_snapshot_facts
module was renamed to ec2_snapshot_info.The
ec2_vol_facts
module was renamed to ec2_vol_info.The
ec2_vpc_dhcp_option_facts
module was renamed to ec2_vpc_dhcp_option_info.The
ec2_vpc_endpoint_facts
module was renamed to ec2_vpc_endpoint_info.The
ec2_vpc_igw_facts
module was renamed to ec2_vpc_igw_info.The
ec2_vpc_nacl_facts
module was renamed to ec2_vpc_nacl_info.The
ec2_vpc_nat_gateway_facts
module was renamed to ec2_vpc_nat_gateway_info.The
ec2_vpc_net_facts
module was renamed to ec2_vpc_net_info.The
ec2_vpc_peering_facts
module was renamed to ec2_vpc_peering_info.The
ec2_vpc_route_table_facts
module was renamed to ec2_vpc_route_table_info.The
ec2_vpc_subnet_facts
module was renamed to ec2_vpc_subnet_info.The
ec2_vpc_vgw_facts
module was renamed to ec2_vpc_vgw_info.The
ec2_vpc_vpn_facts
module was renamed to ec2_vpc_vpn_info.The
ecs_service_facts
module was renamed to ecs_service_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ecs_taskdefinition_facts
module was renamed to ecs_taskdefinition_info.The
efs_facts
module was renamed to efs_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
elasticache_facts
module was renamed to elasticache_info.The
elb_application_lb_facts
module was renamed to elb_application_lb_info.The
elb_classic_lb_facts
module was renamed to elb_classic_lb_info.The
elb_target_facts
module was renamed to elb_target_info.The
elb_target_group_facts
module was renamed to elb_target_group_info.The
gcp_bigquery_dataset_facts
module was renamed to gcp_bigquery_dataset_info.The
gcp_bigquery_table_facts
module was renamed to gcp_bigquery_table_info.The
gcp_cloudbuild_trigger_facts
module was renamed to gcp_cloudbuild_trigger_info.The
gcp_compute_address_facts
module was renamed to gcp_compute_address_info.The
gcp_compute_backend_bucket_facts
module was renamed to gcp_compute_backend_bucket_info.The
gcp_compute_backend_service_facts
module was renamed to gcp_compute_backend_service_info.The
gcp_compute_disk_facts
module was renamed to gcp_compute_disk_info.The
gcp_compute_firewall_facts
module was renamed to gcp_compute_firewall_info.The
gcp_compute_forwarding_rule_facts
module was renamed to gcp_compute_forwarding_rule_info.The
gcp_compute_global_address_facts
module was renamed to gcp_compute_global_address_info.The
gcp_compute_global_forwarding_rule_facts
module was renamed to gcp_compute_global_forwarding_rule_info.The
gcp_compute_health_check_facts
module was renamed to gcp_compute_health_check_info.The
gcp_compute_http_health_check_facts
module was renamed to gcp_compute_http_health_check_info.The
gcp_compute_https_health_check_facts
module was renamed to gcp_compute_https_health_check_info.The
gcp_compute_image_facts
module was renamed to gcp_compute_image_info.The
gcp_compute_instance_facts
module was renamed to gcp_compute_instance_info.The
gcp_compute_instance_group_facts
module was renamed to gcp_compute_instance_group_info.The
gcp_compute_instance_group_manager_facts
module was renamed to gcp_compute_instance_group_manager_info.The
gcp_compute_instance_template_facts
module was renamed to gcp_compute_instance_template_info.The
gcp_compute_interconnect_attachment_facts
module was renamed to gcp_compute_interconnect_attachment_info.The
gcp_compute_network_facts
module was renamed to gcp_compute_network_info.The
gcp_compute_region_disk_facts
module was renamed to gcp_compute_region_disk_info.The
gcp_compute_route_facts
module was renamed to gcp_compute_route_info.The
gcp_compute_router_facts
module was renamed to gcp_compute_router_info.The
gcp_compute_ssl_certificate_facts
module was renamed to gcp_compute_ssl_certificate_info.The
gcp_compute_ssl_policy_facts
module was renamed to gcp_compute_ssl_policy_info.The
gcp_compute_subnetwork_facts
module was renamed to gcp_compute_subnetwork_info.The
gcp_compute_target_http_proxy_facts
module was renamed to gcp_compute_target_http_proxy_info.The
gcp_compute_target_https_proxy_facts
module was renamed to gcp_compute_target_https_proxy_info.The
gcp_compute_target_pool_facts
module was renamed to gcp_compute_target_pool_info.The
gcp_compute_target_ssl_proxy_facts
module was renamed to gcp_compute_target_ssl_proxy_info.The
gcp_compute_target_tcp_proxy_facts
module was renamed to gcp_compute_target_tcp_proxy_info.The
gcp_compute_target_vpn_gateway_facts
module was renamed to gcp_compute_target_vpn_gateway_info.The
gcp_compute_url_map_facts
module was renamed to gcp_compute_url_map_info.The
gcp_compute_vpn_tunnel_facts
module was renamed to gcp_compute_vpn_tunnel_info.The
gcp_container_cluster_facts
module was renamed to gcp_container_cluster_info.The
gcp_container_node_pool_facts
module was renamed to gcp_container_node_pool_info.The
gcp_dns_managed_zone_facts
module was renamed to gcp_dns_managed_zone_info.The
gcp_dns_resource_record_set_facts
module was renamed to gcp_dns_resource_record_set_info.The
gcp_iam_role_facts
module was renamed to gcp_iam_role_info.The
gcp_iam_service_account_facts
module was renamed to gcp_iam_service_account_info.The
gcp_pubsub_subscription_facts
module was renamed to gcp_pubsub_subscription_info.The
gcp_pubsub_topic_facts
module was renamed to gcp_pubsub_topic_info.The
gcp_redis_instance_facts
module was renamed to gcp_redis_instance_info.The
gcp_resourcemanager_project_facts
module was renamed to gcp_resourcemanager_project_info.The
gcp_sourcerepo_repository_facts
module was renamed to gcp_sourcerepo_repository_info.The
gcp_spanner_database_facts
module was renamed to gcp_spanner_database_info.The
gcp_spanner_instance_facts
module was renamed to gcp_spanner_instance_info.The
gcp_sql_database_facts
module was renamed to gcp_sql_database_info.The
gcp_sql_instance_facts
module was renamed to gcp_sql_instance_info.The
gcp_sql_user_facts
module was renamed to gcp_sql_user_info.The
gcp_tpu_node_facts
module was renamed to gcp_tpu_node_info.The
gcpubsub_facts
module was renamed to gcpubsub_info.The
github_webhook_facts
module was renamed to github_webhook_info.The
gluster_heal_facts
module was renamed to gluster_heal_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
hcloud_datacenter_facts
module was renamed to hcloud_datacenter_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
hcloud_floating_ip_facts
module was renamed to hcloud_floating_ip_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
hcloud_image_facts
module was renamed to hcloud_image_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
hcloud_location_facts
module was renamed to hcloud_location_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
hcloud_server_facts
module was renamed to hcloud_server_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
hcloud_server_type_facts
module was renamed to hcloud_server_type_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
hcloud_ssh_key_facts
module was renamed to hcloud_ssh_key_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
hcloud_volume_facts
module was renamed to hcloud_volume_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
hpilo_facts
module was renamed to hpilo_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
iam_mfa_device_facts
module was renamed to iam_mfa_device_info.The
iam_role_facts
module was renamed to iam_role_info.The
iam_server_certificate_facts
module was renamed to iam_server_certificate_info.The
idrac_redfish_facts
module was renamed to idrac_redfish_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
intersight_facts
module was renamed to intersight_info.The
jenkins_job_facts
module was renamed to jenkins_job_info.The
k8s_facts
module was renamed to k8s_info.The
memset_memstore_facts
module was renamed to memset_memstore_info.The
memset_server_facts
module was renamed to memset_server_info.The
one_image_facts
module was renamed to one_image_info.The
onepassword_facts
module was renamed to onepassword_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
oneview_datacenter_facts
module was renamed to oneview_datacenter_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
oneview_enclosure_facts
module was renamed to oneview_enclosure_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
oneview_ethernet_network_facts
module was renamed to oneview_ethernet_network_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
oneview_fc_network_facts
module was renamed to oneview_fc_network_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
oneview_fcoe_network_facts
module was renamed to oneview_fcoe_network_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
oneview_logical_interconnect_group_facts
module was renamed to oneview_logical_interconnect_group_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
oneview_network_set_facts
module was renamed to oneview_network_set_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
oneview_san_manager_facts
module was renamed to oneview_san_manager_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
os_flavor_facts
module was renamed to os_flavor_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
os_image_facts
module was renamed to os_image_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
os_keystone_domain_facts
module was renamed to os_keystone_domain_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
os_networks_facts
module was renamed to os_networks_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
os_port_facts
module was renamed to os_port_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
os_project_facts
module was renamed to os_project_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
os_server_facts
module was renamed to os_server_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
os_subnets_facts
module was renamed to os_subnets_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
os_user_facts
module was renamed to os_user_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_affinity_label_facts
module was renamed to ovirt_affinity_label_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_api_facts
module was renamed to ovirt_api_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_cluster_facts
module was renamed to ovirt_cluster_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_datacenter_facts
module was renamed to ovirt_datacenter_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_disk_facts
module was renamed to ovirt_disk_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_event_facts
module was renamed to ovirt_event_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_external_provider_facts
module was renamed to ovirt_external_provider_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_group_facts
module was renamed to ovirt_group_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_host_facts
module was renamed to ovirt_host_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_host_storage_facts
module was renamed to ovirt_host_storage_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_network_facts
module was renamed to ovirt_network_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_nic_facts
module was renamed to ovirt_nic_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_permission_facts
module was renamed to ovirt_permission_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_quota_facts
module was renamed to ovirt_quota_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_scheduling_policy_facts
module was renamed to ovirt_scheduling_policy_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_snapshot_facts
module was renamed to ovirt_snapshot_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_storage_domain_facts
module was renamed to ovirt_storage_domain_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_storage_template_facts
module was renamed to ovirt_storage_template_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_storage_vm_facts
module was renamed to ovirt_storage_vm_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_tag_facts
module was renamed to ovirt_tag_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_template_facts
module was renamed to ovirt_template_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_user_facts
module was renamed to ovirt_user_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_vm_facts
module was renamed to ovirt_vm_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
ovirt_vmpool_facts
module was renamed to ovirt_vmpool_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
python_requirements_facts
module was renamed to python_requirements_info.The
rds_instance_facts
module was renamed to rds_instance_info.The
rds_snapshot_facts
module was renamed to rds_snapshot_info.The
redfish_facts
module was renamed to redfish_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
redshift_facts
module was renamed to redshift_info.The
route53_facts
module was renamed to route53_info.The
smartos_image_facts
module was renamed to smartos_image_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
vertica_facts
module was renamed to vertica_info. When called with the new name, the module no longer returnsansible_facts
. To access return values, register a variable.The
vmware_cluster_facts
module was renamed to vmware_cluster_info.The
vmware_datastore_facts
module was renamed to vmware_datastore_info.The
vmware_guest_facts
module was renamed to vmware_guest_info.The
vmware_guest_snapshot_facts
module was renamed to vmware_guest_snapshot_info.The
vmware_tag_facts
module was renamed to vmware_tag_info.The
vmware_vm_facts
module was renamed to vmware_vm_info.The
xenserver_guest_facts
module was renamed to xenserver_guest_info.The
zabbix_group_facts
module was renamed to zabbix_group_info.The
zabbix_host_facts
module was renamed to zabbix_host_info.
Noteworthy module changes¶
vmware_cluster was refactored for easier maintenance/bugfixes. Use the three new, specialized modules to configure clusters. Configure DRS with vmware_cluster_drs, HA with vmware_cluster_ha and vSAN with vmware_cluster_vsan.
vmware_dvswitch accepts
folder
parameter to place dvswitch in user defined folder. This option makesdatacenter
as an optional parameter.vmware_datastore_cluster accepts
folder
parameter to place datastore cluster in user defined folder. This option makesdatacenter
as an optional parameter.mysql_db returns new
db_list
parameter in addition todb
parameter. Thisdb_list
parameter refers to list of database names.db
parameter will be deprecated in version 2.13.snow_record and snow_record_find now takes environment variables for
instance
,username
andpassword
parameters. This change marks these parameters as optional.The deprecated
force
option inwin_firewall_rule
has been removed.openssl_certificate’s
ownca
provider creates authority key identifiers if not explicitly disabled withownca_create_authority_key_identifier: no
. This is only the case for thecryptography
backend, which is selected by default if thecryptography
library is available.openssl_certificate’s
ownca
andselfsigned
providers create subject key identifiers if not explicitly disabled withownca_create_subject_key_identifier: never_create
resp.selfsigned_create_subject_key_identifier: never_create
. If a subject key identifier is provided by the CSR, it is taken; if not, it is created from the public key. This is only the case for thecryptography
backend, which is selected by default if thecryptography
library is available.openssh_keypair now applies the same file permissions and ownership to both public and private keys (both get the same
mode
,owner
,group
, etc.). If you need to change permissions / ownership on one key, use the file to modify it after it is created.
Plugins¶
Removed Lookup Plugins¶
redis_kv
use redis instead.
Porting custom scripts¶
No notable changes
Networking¶
Network resource modules¶
Ansible 2.9 introduced the first batch of network resource modules. Sections of a network device’s configuration can be thought of as a resource provided by that device. Network resource modules are intentionally scoped to configure a single resource and you can combine them as building blocks to configure complex network services. The older modules are deprecated in Ansible 2.9 and will be removed in Ansible 2.13. You should scan the list of deprecated modules above and replace them with the new network resource modules in your playbooks. See Ansible Network Features in 2.9 for details.
Improved gather_facts
support for network devices¶
In Ansible 2.9, the gather_facts
keyword now supports gathering network device facts in standardized key/value pairs. You can feed these network facts into further tasks to manage the network device. You can also use the new gather_network_resources
parameter with the network *_facts
modules (such as eos_facts) to return just a subset of the device configuration. See Gathering facts from network devices for an example.
Top-level connection arguments removed in 2.9¶
Top-level connection arguments like username
, host
, and password
are removed in version 2.9.
OLD In Ansible < 2.4
- name: example of using top-level options for connection properties
ios_command:
commands: show version
host: "{{ inventory_hostname }}"
username: cisco
password: cisco
authorize: yes
auth_pass: cisco
Change your playbooks to the connection types network_cli
and netconf
using standard Ansible connection properties, and setting those properties in inventory by group. As you update your playbooks and inventory files, you can easily make the change to become
for privilege escalation (on platforms that support it). For more information, see the using become with network modules guide and the platform documentation.