diff --git a/docs/docsite/rst/porting_guides/porting_guide_2.9.rst b/docs/docsite/rst/porting_guides/porting_guide_2.9.rst index 5a4208ce366..0d7826fbe5c 100644 --- a/docs/docsite/rst/porting_guides/porting_guide_2.9.rst +++ b/docs/docsite/rst/porting_guides/porting_guide_2.9.rst @@ -81,47 +81,27 @@ 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 :ref:`ali_instance_info `. +* The ``aws_acm_facts`` module was renamed to :ref:`aws_acm_info `. +* The ``aws_az_facts`` module was renamed to :ref:`aws_az_info `. +* The ``aws_caller_facts`` module was renamed to :ref:`aws_caller_info `. +* The ``aws_kms_facts`` module was renamed to :ref:`aws_kms_info `. +* The ``aws_region_facts`` module was renamed to :ref:`aws_region_info `. * The ``aws_s3_bucket_facts`` module was renamed to :ref:`aws_s3_bucket_info `. When called with the new name, the module no longer returns ``ansible_facts``. To access return values, :ref:`register a variable `. +* The ``aws_sgw_facts`` module was renamed to :ref:`aws_sgw_info `. +* The ``aws_waf_facts`` module was renamed to :ref:`aws_waf_info `. +* The ``azure_rm_resourcegroup_facts`` module was renamed to :ref:`azure_rm_resourcegroup_info `. +* The ``bigip_device_facts`` module was renamed to :ref:`bigip_device_info `. +* The ``bigiq_device_facts`` module was renamed to :ref:`bigiq_device_info `. * The ``cloudformation_facts`` module was renamed to :ref:`cloudformation_info `. When called with the new name, the module no longer returns ``ansible_facts``. To access return values, :ref:`register a variable `. * The ``cloudfront_facts`` module was renamed to :ref:`cloudfront_info `. When called with the new name, the module no longer returns ``ansible_facts``. To access return values, :ref:`register a variable `. -* The ``ecs_service_facts`` module was renamed to :ref:`ecs_service_info `. - When called with the new name, the module no longer returns ``ansible_facts``. - To access return values, :ref:`register a variable `. -* The ``efs_facts`` module was renamed to :ref:`efs_info `. - When called with the new name, the module no longer returns ``ansible_facts``. - To access return values, :ref:`register a variable `. - - -Noteworthy module changes -------------------------- - -* :ref:`vmware_cluster ` was refactored for easier maintenance/bugfixes. Use the three new, specialized modules to configure clusters. Configure DRS with :ref:`vmware_cluster_drs `, HA with :ref:`vmware_cluster_ha ` and vSAN with :ref:`vmware_cluster_vsan `. -* `vmware_dvswitch ` accepts `folder` parameter to place dvswitch in user defined folder. This option makes `datacenter` as an optional parameter. -* `vmware_datastore_cluster ` accepts `folder` parameter to place datastore cluster in user defined folder. This option makes `datacenter` as an optional parameter. -* `mysql_db ` returns new `db_list` parameter in addition to `db` parameter. This `db_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` and `password` parameters. This change marks these parameters as optional. -* The ``python_requirements_facts`` module was renamed to :ref:`python_requirements_info `. -* The ``jenkins_job_facts`` module was renamed to :ref:`jenkins_job_info `. -* The ``intersight_facts`` module was renamed to :ref:`intersight_info `. -* The ``zabbix_group_facts`` module was renamed to :ref:`zabbix_group_info `. -* The ``zabbix_host_facts`` module was renamed to :ref:`zabbix_host_info `. -* The ``github_webhook_facts`` module was renamed to :ref:`github_webhook_info `. -* The ``k8s_facts`` module was renamed to :ref:`k8s_info `. -* The ``bigip_device_facts`` module was renamed to :ref:`bigip_device_info `. -* The ``bigiq_device_facts`` module was renamed to :ref:`bigiq_device_info `. -* The ``memset_memstore_facts`` module was renamed to :ref:`memset_memstore_info `. -* The ``memset_server_facts`` module was renamed to :ref:`memset_server_info `. -* The ``one_image_facts`` module was renamed to :ref:`one_image_info `. -* The ``ali_instance_facts`` module was renamed to :ref:`ali_instance_info `. -* The ``xenserver_guest_facts`` module was renamed to :ref:`xenserver_guest_info `. -* The ``azure_rm_resourcegroup_facts`` module was renamed to :ref:`azure_rm_resourcegroup_info `. -* The ``gcpubsub_facts`` module was renamed to :ref:`gcpubsub_info `. +* The ``cloudwatchlogs_log_group_facts`` module was renamed to :ref:`cloudwatchlogs_log_group_info `. * The ``digital_ocean_account_facts`` module was renamed to :ref:`digital_ocean_account_info `. * The ``digital_ocean_certificate_facts`` module was renamed to :ref:`digital_ocean_certificate_info `. * The ``digital_ocean_domain_facts`` module was renamed to :ref:`digital_ocean_domain_info `. @@ -134,14 +114,6 @@ Noteworthy module changes * The ``digital_ocean_snapshot_facts`` module was renamed to :ref:`digital_ocean_snapshot_info `. * The ``digital_ocean_tag_facts`` module was renamed to :ref:`digital_ocean_tag_info `. * The ``digital_ocean_volume_facts`` module was renamed to :ref:`digital_ocean_volume_info `. -* The ``aws_acm_facts`` module was renamed to :ref:`aws_acm_info `. -* The ``aws_az_facts`` module was renamed to :ref:`aws_az_info `. -* The ``aws_caller_facts`` module was renamed to :ref:`aws_caller_info `. -* The ``aws_kms_facts`` module was renamed to :ref:`aws_kms_info `. -* The ``aws_region_facts`` module was renamed to :ref:`aws_region_info `. -* The ``aws_sgw_facts`` module was renamed to :ref:`aws_sgw_info `. -* The ``aws_waf_facts`` module was renamed to :ref:`aws_waf_info `. -* The ``cloudwatchlogs_log_group_facts`` module was renamed to :ref:`cloudwatchlogs_log_group_info `. * The ``ec2_ami_facts`` module was renamed to :ref:`ec2_ami_info `. * The ``ec2_asg_facts`` module was renamed to :ref:`ec2_asg_info `. * The ``ec2_customer_gateway_facts`` module was renamed to :ref:`ec2_customer_gateway_info `. @@ -165,7 +137,13 @@ Noteworthy module changes * The ``ec2_vpc_subnet_facts`` module was renamed to :ref:`ec2_vpc_subnet_info `. * The ``ec2_vpc_vgw_facts`` module was renamed to :ref:`ec2_vpc_vgw_info `. * The ``ec2_vpc_vpn_facts`` module was renamed to :ref:`ec2_vpc_vpn_info `. +* The ``ecs_service_facts`` module was renamed to :ref:`ecs_service_info `. + When called with the new name, the module no longer returns ``ansible_facts``. + To access return values, :ref:`register a variable `. * The ``ecs_taskdefinition_facts`` module was renamed to :ref:`ecs_taskdefinition_info `. +* The ``efs_facts`` module was renamed to :ref:`efs_info `. + When called with the new name, the module no longer returns ``ansible_facts``. + To access return values, :ref:`register a variable `. * The ``elasticache_facts`` module was renamed to :ref:`elasticache_info `. * The ``elb_application_lb_facts`` module was renamed to :ref:`elb_application_lb_info `. * The ``elb_classic_lb_facts`` module was renamed to :ref:`elb_classic_lb_info `. @@ -186,9 +164,9 @@ Noteworthy module changes * The ``gcp_compute_http_health_check_facts`` module was renamed to :ref:`gcp_compute_http_health_check_info `. * The ``gcp_compute_https_health_check_facts`` module was renamed to :ref:`gcp_compute_https_health_check_info `. * The ``gcp_compute_image_facts`` module was renamed to :ref:`gcp_compute_image_info `. +* The ``gcp_compute_instance_facts`` module was renamed to :ref:`gcp_compute_instance_info `. * The ``gcp_compute_instance_group_facts`` module was renamed to :ref:`gcp_compute_instance_group_info `. * The ``gcp_compute_instance_group_manager_facts`` module was renamed to :ref:`gcp_compute_instance_group_manager_info `. -* The ``gcp_compute_instance_facts`` module was renamed to :ref:`gcp_compute_instance_info `. * The ``gcp_compute_instance_template_facts`` module was renamed to :ref:`gcp_compute_instance_template_info `. * The ``gcp_compute_interconnect_attachment_facts`` module was renamed to :ref:`gcp_compute_interconnect_attachment_info `. * The ``gcp_compute_network_facts`` module was renamed to :ref:`gcp_compute_network_info `. @@ -223,13 +201,35 @@ Noteworthy module changes * The ``gcp_sql_instance_facts`` module was renamed to :ref:`gcp_sql_instance_info `. * The ``gcp_sql_user_facts`` module was renamed to :ref:`gcp_sql_user_info `. * The ``gcp_tpu_node_facts`` module was renamed to :ref:`gcp_tpu_node_info `. +* The ``gcpubsub_facts`` module was renamed to :ref:`gcpubsub_info `. +* The ``github_webhook_facts`` module was renamed to :ref:`github_webhook_info `. * The ``iam_mfa_device_facts`` module was renamed to :ref:`iam_mfa_device_info `. * The ``iam_role_facts`` module was renamed to :ref:`iam_role_info `. * The ``iam_server_certificate_facts`` module was renamed to :ref:`iam_server_certificate_info `. +* The ``intersight_facts`` module was renamed to :ref:`intersight_info `. +* The ``jenkins_job_facts`` module was renamed to :ref:`jenkins_job_info `. +* The ``k8s_facts`` module was renamed to :ref:`k8s_info `. +* The ``memset_memstore_facts`` module was renamed to :ref:`memset_memstore_info `. +* The ``memset_server_facts`` module was renamed to :ref:`memset_server_info `. +* The ``one_image_facts`` module was renamed to :ref:`one_image_info `. +* The ``python_requirements_facts`` module was renamed to :ref:`python_requirements_info `. * The ``rds_instance_facts`` module was renamed to :ref:`rds_instance_info `. * The ``rds_snapshot_facts`` module was renamed to :ref:`rds_snapshot_info `. * The ``redshift_facts`` module was renamed to :ref:`redshift_info `. * The ``route53_facts`` module was renamed to :ref:`route53_info `. +* The ``xenserver_guest_facts`` module was renamed to :ref:`xenserver_guest_info `. +* The ``zabbix_group_facts`` module was renamed to :ref:`zabbix_group_info `. +* The ``zabbix_host_facts`` module was renamed to :ref:`zabbix_host_info `. + + +Noteworthy module changes +------------------------- + +* :ref:`vmware_cluster ` was refactored for easier maintenance/bugfixes. Use the three new, specialized modules to configure clusters. Configure DRS with :ref:`vmware_cluster_drs `, HA with :ref:`vmware_cluster_ha ` and vSAN with :ref:`vmware_cluster_vsan `. +* `vmware_dvswitch ` accepts `folder` parameter to place dvswitch in user defined folder. This option makes `datacenter` as an optional parameter. +* `vmware_datastore_cluster ` accepts `folder` parameter to place datastore cluster in user defined folder. This option makes `datacenter` as an optional parameter. +* `mysql_db ` returns new `db_list` parameter in addition to `db` parameter. This `db_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` and `password` parameters. This change marks these parameters as optional. * The deprecated ``force`` option in ``win_firewall_rule`` has been removed.