From eed8ff52b24e06c841b57b34653dbf62e5504922 Mon Sep 17 00:00:00 2001 From: Bianca Henderson Date: Wed, 14 May 2025 15:24:12 -0400 Subject: [PATCH 1/2] Prep Release `10.0.0` (#2307) SUMMARY Prep community.aws 10.0.0 Prerequisite: Release of amazon.aws v10.0.0 ISSUE TYPE Feature Pull Request COMPONENT NAME Multiple Reviewed-by: Bianca Henderson Reviewed-by: Alina Buzachis Reviewed-by: GomathiselviS Reviewed-by: Mandar Kulkarni Reviewed-by: Mike Graves (cherry picked from commit d804ced3f8667168c876750feadf00816b8915a5) --- CHANGELOG.rst | 39 +++++++++++--- changelogs/changelog.yaml | 51 +++++++++++++++---- changelogs/fragments/20241029-main-10.0.0.yml | 2 - .../20250505-skip_ansible-core_2.16.yml | 3 -- changelogs/fragments/botocore-python.yaml | 14 ----- changelogs/fragments/botocore.yml | 7 --- changelogs/fragments/migrate_aws_ssm.yml | 5 -- galaxy.yml | 4 +- plugins/module_utils/common.py | 2 +- 9 files changed, 77 insertions(+), 50 deletions(-) delete mode 100644 changelogs/fragments/20241029-main-10.0.0.yml delete mode 100644 changelogs/fragments/20250505-skip_ansible-core_2.16.yml delete mode 100644 changelogs/fragments/botocore-python.yaml delete mode 100644 changelogs/fragments/botocore.yml delete mode 100644 changelogs/fragments/migrate_aws_ssm.yml diff --git a/CHANGELOG.rst b/CHANGELOG.rst index ce94d600498..33b5a92b379 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -4,6 +4,32 @@ community.aws Release Notes .. contents:: Topics +v10.0.0 +======= + +Release Summary +--------------- + +In this major release, the ``connection/aws_ssm`` connection plugin has been fully migrated out of this collection and into ``amazon.aws`` (https://forum.ansible.com/t/aws-ssm-connection-refactoring-plugin-promotion/39930). Playbooks or Inventory using the Fully Qualified Collection Name (FQCN) for this connection plugin should be updated to use ``amazon.aws.aws_ssm``. Additionally, ``botocore<1.31.0`` and ``boto3<1.28.0`` are no longer supported; most modules will continue to work with older versions of the AWS SDK, however, compatibility with older versions of the SDK is not guaranteed. + + +Major Changes +------------- + +- community.aws collection - The ``community.aws`` collection has dropped support for ``botocore<1.34.0`` and ``boto3<1.34.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility 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/2426). + +Breaking Changes / Porting Guide +-------------------------------- + +- Support for ``ansible-core<2.17`` has been dropped (https://github.com/ansible-collections/community.aws/pull/2303). +- The ``community.aws`` collection has dropped support for ``botocore<1.31.0`` and ``boto3<1.28.0``. Most modules will continue to work with older versions of the AWS SDK. However, compatibility 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/community.aws/pull/2195). +- connection/aws_ssm - The connection plugin has been migrated from the ``community.aws`` collection. Playbooks or Inventory using the Fully Qualified Collection Name for this connection plugin should be updated to use ``amazon.aws.aws_ssm``. + +Deprecated Features +------------------- + +- community.aws collection - Due to the AWS SDKs announcing the end of support for Python less than 3.8 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) support for Python less than 3.8 by this collection has been deprecated and was removed in this 10.0.0 release (https://github.com/ansible-collections/community.aws/pull/2195). + v9.3.0 ====== @@ -15,7 +41,7 @@ This release includes several improvements for the ``community.aws.aws_ssm`` con Minor Changes ------------- -- Bump version of ansible-lint to 25.1.2. +- Bump version of ``ansible-lint`` to 25.1.2 (https://github.com/ansible-collections/community.aws/pull/2295). - aws_ssm - Move the ``aws_ssm`` connection plugin's plugin_utils into a dedicated folder (https://github.com/ansible-collections/community.aws/pull/2279). - aws_ssm - Refactor S3 operations methods for improved clarity (https://github.com/ansible-collections/community.aws/pull/2275). - aws_ssm - Refactor connection/aws_ssm to add new TerminalManager class and move relevant methods to the new class (https://github.com/ansible-collections/community.aws/pull/2270). @@ -45,12 +71,13 @@ Release Summary Preparation for the promotion of the ``aws_ssm.py`` plugin (https://forum.ansible.com/t/aws-ssm-connection-refactoring-plugin-promotion/39930) is under way in this release; this effort includes the refactoring work for methods like ``exec_command`` (https://github.com/ansible-collections/community.aws/pull/2224) as well as new methods such as ``generate_mark()`` (https://github.com/ansible-collections/community.aws/pull/2235) which generates random strings for SSM CLI delimitation. + Minor Changes ------------- - aws_ssm - Refactor ``_init_clients`` Method for Improved Clarity and Efficiency (https://github.com/ansible-collections/community.aws/pull/2223). - aws_ssm - Refactor ``_prepare_terminal()`` Method for Improved Clarity and Efficiency (https://github.com/ansible-collections/community.aws/pull/). -- aws_ssm - Refactor exec_command Method for Improved Clarity and Efficiency (https://github.com/ansible-collections/community.aws/pull/2224). +- aws_ssm - Refactor ``exec_command`` Method for Improved Clarity and Efficiency (https://github.com/ansible-collections/community.aws/pull/2224). - aws_ssm - Add the possibility to define ``aws_ssm plugin`` variable via environment variable and by default use the version found on the $PATH rather than require that you provide an absolute path (https://github.com/ansible-collections/community.aws/issues/1990). - dms_endpoint - Improve resilience of parameter comparison (https://github.com/ansible-collections/community.aws/pull/2221). - s3_lifecycle - Support for min and max object size when applying the filter rules (https://github.com/ansible-collections/community.aws/pull/2205). @@ -105,7 +132,7 @@ Minor Changes Breaking Changes / Porting Guide -------------------------------- -- The community.aws collection has dropped support for ``botocore<1.31.0`` and ``boto3<1.28.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/community.aws/pull/2195). +- The community.aws collection has dropped support for ``botocore<1.31.0`` and ``boto3<1.28.0``. Most modules will continue to work with older versions of the AWS SDK. However, compatibility 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/community.aws/pull/2195). - autoscaling_instance_refresh - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.autoscaling_instance_refresh`` (https://github.com/ansible-collections/community.aws/pull/2177). - autoscaling_instance_refresh_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.autoscaling_instance_refresh_info`` (https://github.com/ansible-collections/community.aws/pull/2177). - ec2_launch_template - Tags defined using option ``tags`` are now applied to the launch template resources not the resource created using this launch template (https://github.com/ansible-collections/community.aws/issues/176). @@ -182,7 +209,7 @@ Minor Changes Breaking Changes / Porting Guide -------------------------------- -- The community.aws collection has dropped support for ``botocore<1.29.0`` and ``boto3<1.26.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/1763). +- The community.aws collection has dropped support for ``botocore<1.29.0`` and ``boto3<1.26.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/1763). - aws_region_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.aws_region_info``. - aws_s3_bucket_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.aws_s3_bucket_info``. - community.aws collection - Support for ansible-core < 2.15 has been dropped (https://github.com/ansible-collections/community.aws/pull/2074). @@ -276,7 +303,7 @@ Minor Changes Breaking Changes / Porting Guide -------------------------------- -- The community.aws collection has dropped support for ``botocore<1.29.0`` and ``boto3<1.26.0``. Most modules will continue to work with older versions of the AWS SDK, however compatability with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/1763). +- The community.aws collection has dropped support for ``botocore<1.29.0`` and ``boto3<1.26.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/1763). - aws_region_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.aws_region_info``. - aws_s3_bucket_info - The module has been migrated from the ``community.aws`` collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use ``amazon.aws.aws_s3_bucket_info``. - community.aws collection - due to the AWS SDKs announcing the end of support for Python less than 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) support for Python less than 3.7 by this collection wss been deprecated in release 6.0.0 and removed in release 7.0.0. (https://github.com/ansible-collections/amazon.aws/pull/1763). @@ -386,7 +413,7 @@ Minor Changes Breaking Changes / Porting Guide -------------------------------- -- The community.aws collection has dropped support for ``botocore<1.25.0`` and ``boto3<1.22.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/community.aws/pull/1743). +- The community.aws collection has dropped support for ``botocore<1.25.0`` and ``boto3<1.22.0``. Most modules will continue to work with older versions of the AWS SDK, however compatibility 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/community.aws/pull/1743). - aws_ssm - the AWS SSM plugin was incorrectly prepending ``sudo`` to most commands. This behaviour was incorrect and has been removed. To execute commands as a specific user, including the ``root`` user, the ``become`` and ``become_user`` directives should be used. See the `Ansible documentation for more information `_ (https://github.com/ansible-collections/community.aws/issues/853). - codebuild_project - ``tags`` parameter now accepts a dict representing the tags, rather than the boto3 format (https://github.com/ansible-collections/community.aws/pull/1643). diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml index 958aa30bc34..7dc78e2cade 100644 --- a/changelogs/changelog.yaml +++ b/changelogs/changelog.yaml @@ -3437,7 +3437,7 @@ releases: breaking_changes: - The community.aws collection has dropped support for ``botocore<1.25.0`` and ``boto3<1.22.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 + the AWS SDK, however compatibility 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/community.aws/pull/1743). - aws_ssm - the AWS SSM plugin was incorrectly prepending ``sudo`` to most commands. This @@ -3619,7 +3619,7 @@ releases: breaking_changes: - The community.aws collection has dropped support for ``botocore<1.29.0`` and ``boto3<1.26.0``. Most modules will continue to work with older versions of - the AWS SDK, however compatability with older versions of the SDK is not guaranteed + the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/1763). - aws_region_info - The module has been migrated from the ``community.aws`` @@ -3760,7 +3760,7 @@ releases: breaking_changes: - The community.aws collection has dropped support for ``botocore<1.29.0`` and ``boto3<1.26.0``. Most modules will continue to work with older versions of - the AWS SDK, however compatability with older versions of the SDK is not guaranteed + the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (https://github.com/ansible-collections/amazon.aws/pull/1763). - aws_region_info - The module has been migrated from the ``community.aws`` @@ -3901,7 +3901,7 @@ releases: breaking_changes: - The community.aws collection has dropped support for ``botocore<1.31.0`` and ``boto3<1.28.0``. Most modules will continue to work with older versions of - the AWS SDK. However, compatability with older versions of the SDK is not + the AWS SDK. However, compatibility 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/community.aws/pull/2195). - autoscaling_instance_refresh - The module has been migrated from the ``community.aws`` @@ -4086,13 +4086,14 @@ releases: Efficiency (https://github.com/ansible-collections/community.aws/pull/). - aws_ssm - Refactor exec_command Method for Improved Clarity and Efficiency (https://github.com/ansible-collections/community.aws/pull/2224). - - aws_ssm - Add the possibility to define ``aws_ssm plugin`` variable - via environment variable and by default use the version found on the $PATH - rather than require that you provide an absolute path (https://github.com/ansible-collections/community.aws/issues/1990). + - aws_ssm - Add function to generate random strings for SSM CLI delimitation + (https://github.com/ansible-collections/community.aws/pull/2235). + - aws_ssm - Add the possibility to define ``aws_ssm plugin`` variable via environment + variable and by default use the version found on the $PATH rather than require + that you provide an absolute path (https://github.com/ansible-collections/community.aws/issues/1990). - dms_endpoint - Improve resilience of parameter comparison (https://github.com/ansible-collections/community.aws/pull/2221). - s3_lifecycle - Support for min and max object size when applying the filter rules (https://github.com/ansible-collections/community.aws/pull/2205). - - aws_ssm - Add function to generate random strings for SSM CLI delimitation (https://github.com/ansible-collections/community.aws/pull/2235). - various modules - Linting fixups (https://github.com/ansible-collections/community.aws/pull/2221). - waf_condition - Add missing options validation to filters (https://github.com/ansible-collections/community.aws/pull/2220). fragments: @@ -4128,7 +4129,7 @@ releases: 9.3.0: changes: minor_changes: - - Bump version of ansible-lint to 25.1.2. + - Bump version of ansible-lint to 25.1.2 (https://github.com/ansible-collections/community.aws/pull/2295). - aws_ssm - Move the ``aws_ssm`` connection plugin's plugin_utils into a dedicated folder (https://github.com/ansible-collections/community.aws/pull/2279). - aws_ssm - Refactor S3 operations methods for improved clarity (https://github.com/ansible-collections/community.aws/pull/2275). @@ -4149,4 +4150,34 @@ releases: - 9.3.0.yaml - aws_ssm_filetransfermanager.yml - update_ansible-lint.yml - release_date: '2025-05-06' \ No newline at end of file + release_date: '2025-05-06' + 10.0.0: + changes: + breaking_changes: + - Support for ``ansible-core<2.17`` has been dropped (https://github.com/ansible-collections/community.aws/pull/2303). + - The community.aws collection has dropped support for ``botocore<1.31.0`` and + ``boto3<1.28.0``. Most modules will continue to work with older versions of + the AWS SDK. However, compatibility 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/community.aws/pull/2195). + - connection/aws_ssm - The connection plugin has been migrated from the ``community.aws`` + collection. Playbooks or Inventory using the Fully Qualified Collection Name + for this connection plugin should be updated to use ``amazon.aws.aws_ssm``. + deprecated_features: + - community.aws collection - due to the AWS SDKs announcing the end of support + for Python less than 3.8 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) + support for Python less than 3.8 by this collection has been deprecated and + will removed in release 10.0.0 (https://github.com/ansible-collections/community.aws/pull/2195). + major_changes: + - community.aws collection - The community.aws collection has dropped support + for ``botocore<1.34.0`` and ``boto3<1.34.0``. Most modules will continue to + work with older versions of the AWS SDK, however compatibility 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/2426). + fragments: + - 20241029-main-10.0.0.yml + - 20250505-skip_ansible-core_2.16.yml + - botocore-python.yaml + - botocore.yml + - migrate_aws_ssm.yml + release_date: '2025-05-14' diff --git a/changelogs/fragments/20241029-main-10.0.0.yml b/changelogs/fragments/20241029-main-10.0.0.yml deleted file mode 100644 index 9fbf7b5efb3..00000000000 --- a/changelogs/fragments/20241029-main-10.0.0.yml +++ /dev/null @@ -1,2 +0,0 @@ -trivial: - - galaxy.yml - bump ``release`` for main branch to ``10.0.0-dev0``. diff --git a/changelogs/fragments/20250505-skip_ansible-core_2.16.yml b/changelogs/fragments/20250505-skip_ansible-core_2.16.yml deleted file mode 100644 index be11762cfa4..00000000000 --- a/changelogs/fragments/20250505-skip_ansible-core_2.16.yml +++ /dev/null @@ -1,3 +0,0 @@ ---- -trivial: - - Exclude ansible-core 2.16 for sanity tests (https://github.com/ansible-collections/community.aws/pull/2304). diff --git a/changelogs/fragments/botocore-python.yaml b/changelogs/fragments/botocore-python.yaml deleted file mode 100644 index 08b72eacd07..00000000000 --- a/changelogs/fragments/botocore-python.yaml +++ /dev/null @@ -1,14 +0,0 @@ ---- -breaking_changes: - - The community.aws collection has dropped support for ``botocore<1.31.0`` and - ``boto3<1.28.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/community.aws/pull/2195). -deprecated_features: - - community.aws collection - due to the AWS SDKs announcing the end of support - for Python less than 3.8 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) - support for Python less than 3.8 by this collection has been deprecated - and will removed in release 10.0.0 - (https://github.com/ansible-collections/community.aws/pull/2195). diff --git a/changelogs/fragments/botocore.yml b/changelogs/fragments/botocore.yml deleted file mode 100644 index e3ace7f4005..00000000000 --- a/changelogs/fragments/botocore.yml +++ /dev/null @@ -1,7 +0,0 @@ ---- -major_changes: - - community.aws collection - The community.aws collection has dropped support for - ``botocore<1.34.0`` and ``boto3<1.34.0``. Most modules will continue to work - with older versions of the AWS SDK, however compatibility 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/2426). diff --git a/changelogs/fragments/migrate_aws_ssm.yml b/changelogs/fragments/migrate_aws_ssm.yml deleted file mode 100644 index a13b8a7822a..00000000000 --- a/changelogs/fragments/migrate_aws_ssm.yml +++ /dev/null @@ -1,5 +0,0 @@ ---- -breaking_changes: - - connection/aws_ssm - The connection plugin has been migrated from the ``community.aws`` - collection. Playbooks or Inventory using the Fully Qualified Collection Name for this connection plugin - should be updated to use ``amazon.aws.aws_ssm``. diff --git a/galaxy.yml b/galaxy.yml index e264d3977d6..82f528d14ff 100644 --- a/galaxy.yml +++ b/galaxy.yml @@ -1,7 +1,7 @@ --- namespace: community name: aws -version: 10.0.0-dev0 +version: 10.0.0 readme: README.md authors: - Ansible (https://github.com/ansible) @@ -9,7 +9,7 @@ description: A variety of Ansible content to help automate the management of AWS license_file: COPYING tags: [community, aws, cloud, amazon] dependencies: - amazon.aws: '>=10.0.0-dev0' + amazon.aws: '>=10.0.0' repository: https://github.com/ansible-collections/community.aws documentation: https://ansible-collections.github.io/community.aws/branch/main/collections/community/aws/index.html homepage: https://github.com/ansible-collections/community.aws diff --git a/plugins/module_utils/common.py b/plugins/module_utils/common.py index b5afdf0ec96..4a4e89a7eb5 100644 --- a/plugins/module_utils/common.py +++ b/plugins/module_utils/common.py @@ -5,4 +5,4 @@ COMMUNITY_AWS_COLLECTION_NAME = "community.aws" -COMMUNITY_AWS_COLLECTION_VERSION = "10.0.0-dev0" +COMMUNITY_AWS_COLLECTION_VERSION = "10.0.0" From b5763c744916f72688d83fef1512354925139fff Mon Sep 17 00:00:00 2001 From: Bianca Henderson Date: Wed, 14 May 2025 16:36:24 -0400 Subject: [PATCH 2/2] Remove unnecessary / outdated changes --- galaxy.yml | 4 ++-- plugins/module_utils/common.py | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/galaxy.yml b/galaxy.yml index 82f528d14ff..e264d3977d6 100644 --- a/galaxy.yml +++ b/galaxy.yml @@ -1,7 +1,7 @@ --- namespace: community name: aws -version: 10.0.0 +version: 10.0.0-dev0 readme: README.md authors: - Ansible (https://github.com/ansible) @@ -9,7 +9,7 @@ description: A variety of Ansible content to help automate the management of AWS license_file: COPYING tags: [community, aws, cloud, amazon] dependencies: - amazon.aws: '>=10.0.0' + amazon.aws: '>=10.0.0-dev0' repository: https://github.com/ansible-collections/community.aws documentation: https://ansible-collections.github.io/community.aws/branch/main/collections/community/aws/index.html homepage: https://github.com/ansible-collections/community.aws diff --git a/plugins/module_utils/common.py b/plugins/module_utils/common.py index 4a4e89a7eb5..b5afdf0ec96 100644 --- a/plugins/module_utils/common.py +++ b/plugins/module_utils/common.py @@ -5,4 +5,4 @@ COMMUNITY_AWS_COLLECTION_NAME = "community.aws" -COMMUNITY_AWS_COLLECTION_VERSION = "10.0.0" +COMMUNITY_AWS_COLLECTION_VERSION = "10.0.0-dev0"