Prep amazon.aws 8.0.0 (#2096) (#2100)

Update main branch CHANGELOG after 8.0.0 release

SUMMARY

Update main branch CHANGELOG after 8.0.0 release

ISSUE TYPE


Docs Pull Request

COMPONENT NAME

ADDITIONAL INFORMATION

Reviewed-by: Mike Graves <[email protected]>
Reviewed-by: Helen Bailey <[email protected]>

CHANGELOG.rst

@@ -4,6 +4,68 @@ amazon.aws Release Notes
 
 .. contents:: Topics
 
+v8.0.0
+======
+
+Release Summary
+---------------
+
+This major release brings several new features, bug fixes, and deprecated features. It also includes the removal of some functionality for ``iam_role, iam_role_info`` and ``module_utils.policy`` that were previously deprecated. We have also removed support for ``ansible-core<2.15``.
+
+Minor Changes
+-------------
+
+- autoscaling_group - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+- cloudformation - apply automatic retries when paginating through stack events without a filter (https://github.com/ansible-collections/amazon.aws/pull/2049).
+- cloudtrail - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+- ec2_instance - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+- ec2_vol - Ensure volume state is not one of ``deleted`` or ``deleting`` when trying to delete volume, to guaranty idempotency (https://github.com/ansible-collections/amazon.aws/pull/2052).
+- ec2_vol - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+- elb_classic_lb - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+- kms_key - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+- lambda_event - Add support for setting the ``maximum_batching_window_in_seconds`` option (https://github.com/ansible-collections/amazon.aws/pull/2025).
+- module_uils/botocore - support sets and tuples of errors as well as lists (https://github.com/ansible-collections/amazon.aws/pull/1829).
+- module_utils/elbv2 - Add support for adding listener with multiple certificates during ALB creation. Allows elb_application_elb module to handle mentioned use case. (https://github.com/ansible-collections/amazon.aws/pull/1950).
+- module_utils/elbv2 - Add the possibility to update ``SslPolicy``, ``Certificates`` and ``AlpnPolicy`` for TLS listeners (https://github.com/ansible-collections/amazon.aws/issues/1198).
+- rds_instance - Allow passing empty list to ``enable_cloudwatch_logs_exports`` in order to remove all existing exports (https://github.com/ansible-collections/amazon.aws/pull/1917).
+- s3_bucket - refactor s3_bucket module code for improved readability and maintainability (https://github.com/ansible-collections/amazon.aws/pull/2057).
+- s3_object - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+
+Breaking Changes / Porting Guide
+--------------------------------
+
+- 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_document`` is 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_document`` is no longer converted from CamelCase to snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040).
+- kms_key - the ``policies`` return value has been renamed to ``key_policies`` the contents has not been changed (https://github.com/ansible-collections/amazon.aws/pull/2040).
+- kms_key_info - the ``policies`` return value has been renamed to ``key_policies`` the contents has not been changed (https://github.com/ansible-collections/amazon.aws/pull/2040).
+- lambda_event - | ``batch_size`` no 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_size`` defaults to 10 for sqs sources and to 100 for stream sources (https://github.com/ansible-collections/amazon.aws/pull/2025).
+
+Deprecated Features
+-------------------
+
+- aws_ec2 inventory plugin - removal of the previously deprecated ``include_extra_api_calls`` option has been assigned to release 9.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2040).
+- cloudformation - the ``template`` parameter has been deprecated and will be removed in a release after 2026-05-01.  The ``template_body`` parameter 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 ``policies`` return key has been assigned to release 9.0.0.  Use the ``policy_names`` return key instead (https://github.com/ansible-collections/amazon.aws/pull/2040).
+- module_utils.botocore - the ``boto3`` parameter for ``get_aws_connection_info()`` will be removed in a release after 2025-05-01. The ``boto3`` parameter has been ignored since release 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047).
+- module_utils.botocore - the ``boto3`` parameter for ``get_aws_region()`` will be removed in a release after 2025-05-01. The ``boto3`` parameter has been ignored since release 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047).
+- module_utils.ec2 - the ``boto3`` parameter for ``get_ec2_security_group_ids_from_names()`` will be removed in a release after 2025-05-01. The ``boto3`` parameter has been ignored since release 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047).
+- rds_param_group - the ``rds_param_group`` module has been renamed to ``rds_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).
+
+Removed Features (previously deprecated)
+----------------------------------------
+
+- iam_role - the ``iam_role.assume_role_policy_document_raw`` return value has been deprecated.  ``iam_role.assume_role_policy_document`` now returns the same format as ``iam_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_raw`` return value has been deprecated.  ``iam_role.assume_role_policy_document`` now returns the same format as ``iam_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 using ``compare_policies()`` instead (https://github.com/ansible-collections/amazon.aws/pull/2052).
+
+Bugfixes
+--------
+
+- elb_classic_lb - fixes bug where ``proxy_protocol`` not being set or being set to ``None`` may result in unexpected behaviour or errors (https://github.com/ansible-collections/amazon.aws/pull/2049).
+- lambda_event - Fix when ``batch_size`` is greater than 10, by enabling support for setting ``maximum_batching_window_in_seconds`` (https://github.com/ansible-collections/amazon.aws/pull/2025).
+- lambda_event - Retrieve function ARN using AWS API (get_function) instead of building it with AWS account information (https://github.com/ansible-collections/amazon.aws/issues/1859).
+
 v7.6.0
 ======
 

changelogs/changelog.yaml

@@ -2483,7 +2483,8 @@ releases:
       bugfixes:
       - cloudwatchlogs_log_group_info - Implement exponential backoff when making
         API calls to prevent throttling exceptions (https://github.com/ansible-collections/amazon.aws/issues/2011).
-      - plugin_utils.inventory - Ensure templated options in lookup plugins are converted (https://github.com/ansible-collections/amazon.aws/issues/1955).
+      - plugin_utils.inventory - Ensure templated options in lookup plugins are converted
+        (https://github.com/ansible-collections/amazon.aws/issues/1955).
       release_summary: This release includes bugfixes for the ``cloudwatchlogs_log_group_info``
         module and the inventory plugins.
     fragments:
@@ -2921,3 +2922,107 @@ releases:
       name: rds_engine_versions_info
       namespace: ''
     release_date: '2024-05-07'
+  8.0.0:
+    changes:
+      breaking_changes:
+      - 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_document`` is 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_document`` is no longer converted
+        from CamelCase to snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040).
+      - kms_key - the ``policies`` return value has been renamed to ``key_policies``
+        the contents has not been changed (https://github.com/ansible-collections/amazon.aws/pull/2040).
+      - kms_key_info - the ``policies`` return value has been renamed to ``key_policies``
+        the contents has not been changed (https://github.com/ansible-collections/amazon.aws/pull/2040).
+      - lambda_event - | ``batch_size`` no 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_size`` defaults to 10 for sqs sources and to 100 for stream sources
+        (https://github.com/ansible-collections/amazon.aws/pull/2025).
+      bugfixes:
+      - elb_classic_lb - fixes bug where ``proxy_protocol`` not being set or being
+        set to ``None`` may result in unexpected behaviour or errors (https://github.com/ansible-collections/amazon.aws/pull/2049).
+      - lambda_event - Fix when ``batch_size`` is greater than 10, by enabling support
+        for setting ``maximum_batching_window_in_seconds`` (https://github.com/ansible-collections/amazon.aws/pull/2025).
+      - lambda_event - Retrieve function ARN using AWS API (get_function) instead
+        of building it with AWS account information (https://github.com/ansible-collections/amazon.aws/issues/1859).
+      deprecated_features:
+      - aws_ec2 inventory plugin - removal of the previously deprecated ``include_extra_api_calls``
+        option has been assigned to release 9.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2040).
+      - cloudformation - the ``template`` parameter has been deprecated and will be
+        removed in a release after 2026-05-01.  The ``template_body`` parameter 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 ``policies`` return key
+        has been assigned to release 9.0.0.  Use the ``policy_names`` return key instead
+        (https://github.com/ansible-collections/amazon.aws/pull/2040).
+      - module_utils.botocore - the ``boto3`` parameter for ``get_aws_connection_info()``
+        will be removed in a release after 2025-05-01. The ``boto3`` parameter has
+        been ignored since release 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047).
+      - module_utils.botocore - the ``boto3`` parameter for ``get_aws_region()`` will
+        be removed in a release after 2025-05-01. The ``boto3`` parameter has been
+        ignored since release 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047).
+      - module_utils.ec2 - the ``boto3`` parameter for ``get_ec2_security_group_ids_from_names()``
+        will be removed in a release after 2025-05-01. The ``boto3`` parameter has
+        been ignored since release 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/2047).
+      - rds_param_group - the ``rds_param_group`` module has been renamed to ``rds_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).
+      minor_changes:
+      - autoscaling_group - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+      - cloudformation - apply automatic retries when paginating through stack events
+        without a filter (https://github.com/ansible-collections/amazon.aws/pull/2049).
+      - cloudtrail - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+      - ec2_instance - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+      - ec2_vol - Ensure volume state is not one of ``deleted`` or ``deleting`` when
+        trying to delete volume, to guaranty idempotency (https://github.com/ansible-collections/amazon.aws/pull/2052).
+      - ec2_vol - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+      - elb_classic_lb - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+      - kms_key - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+      - lambda_event - Add support for setting the ``maximum_batching_window_in_seconds``
+        option (https://github.com/ansible-collections/amazon.aws/pull/2025).
+      - module_uils/botocore - support sets and tuples of errors as well as lists
+        (https://github.com/ansible-collections/amazon.aws/pull/1829).
+      - module_utils/elbv2 - Add support for adding listener with multiple certificates
+        during ALB creation. Allows elb_application_elb module to handle mentioned
+        use case. (https://github.com/ansible-collections/amazon.aws/pull/1950).
+      - module_utils/elbv2 - Add the possibility to update ``SslPolicy``, ``Certificates``
+        and ``AlpnPolicy`` for TLS listeners (https://github.com/ansible-collections/amazon.aws/issues/1198).
+      - rds_instance - Allow passing empty list to ``enable_cloudwatch_logs_exports``
+        in order to remove all existing exports (https://github.com/ansible-collections/amazon.aws/pull/1917).
+      - s3_bucket - refactor s3_bucket module code for improved readability and maintainability
+        (https://github.com/ansible-collections/amazon.aws/pull/2057).
+      - s3_object - removed unused code (https://github.com/ansible-collections/amazon.aws/pull/1996).
+      release_summary: This major release brings several new features, bug fixes,
+        and deprecated features. It also includes the removal of some functionality
+        for ``iam_role, iam_role_info`` and ``module_utils.policy`` that were previously
+        deprecated. We have also removed support for ``ansible-core<2.15``.
+      removed_features:
+      - iam_role - the ``iam_role.assume_role_policy_document_raw`` return value has
+        been deprecated.  ``iam_role.assume_role_policy_document`` now returns the
+        same format as ``iam_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_raw`` return value
+        has been deprecated.  ``iam_role.assume_role_policy_document`` now returns
+        the same format as ``iam_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 using ``compare_policies()`` instead (https://github.com/ansible-collections/amazon.aws/pull/2052).
+    fragments:
+    - 1829-is_boto3_error-tuple.yml
+    - 1950-elb_application_lb-multiple-listener-certificates-for-alb.yml
+    - 20231127-module_utils-elbv2-update.yaml
+    - 20231211-rds_instance_cloudwatch.yml
+    - 20240208-lambda_event-fix-validate-params.yml
+    - 20240227-zombies.yml
+    - 20240325-lambda_event-bugfix.yml
+    - 20240411-remove-deprecated-sort_json_policy_dict.yml
+    - 20240502-docs_cleanup.yml
+    - 20240516-rds_param_group.yml
+    - 20250513-update-docs.yml
+    - 2057-s3_bucket-refactor.yml
+    - 8.0.0-deprecation-removal.yml
+    - 8.0.0-dev0.yml
+    - 8.0.0-increase-ansible-core-version.yml
+    - cloudformation-template.yml
+    - release_summary.yml
+    - return_block_update_ec2_1.yml
+    - sanity-boto3.yml
+    - sanity-simple.yml
+    release_date: '2024-05-16'