Prep 3.3.0 release (#842)

Prep 3.3.0 release

SUMMARY

Run add_docs, generate changelog

ISSUE TYPE


Feature Pull Request

COMPONENT NAME

several

Reviewed-by: Joseph Torcasso <None>
Reviewed-by: Markus Bergholz <[email protected]>
Reviewed-by: Mark Chappell <None>

Author: alinabuzachis

CHANGELOG.rst

@@ -5,6 +5,36 @@ community.aws Release Notes
 .. contents:: Topics
 
 
+v3.3.0
+======
+
+Minor Changes
+-------------
+
+- aws_ec2 inventory - Allow for literal strings in hostname that don't match filter parameters in ec2 describe-instances (https://github.com/ansible-collections/amazon.aws/pull/826).
+- aws_ssm - Add support for ``endpoint`` parameter (https://github.com/ansible-collections/amazon.aws/pull/837).
+- module.utils.rds - add retry_codes to get_rds_method_attribute return data to use in call_method and add unit tests (https://github.com/ansible-collections/amazon.aws/pull/776).
+- module.utils.rds - refactor to utilize get_rds_method_attribute return data (https://github.com/ansible-collections/amazon.aws/pull/776).
+- module_utils - add new aliases ``aws_session_token`` and ``session_token`` to the ``security_token`` parameter to be more in-line with the boto SDK (https://github.com/ansible-collections/amazon.aws/pull/631).
+- module_utils.rds - Add support and unit tests for addition/removal of IAM roles to/from a db instance in module_utils.rds with waiters (https://github.com/ansible-collections/amazon.aws/pull/714).
+
+Bugfixes
+--------
+
+- Include ``PSF-license.txt`` file for ``plugins/module_utils/_version.py``.
+- aws_account_attribute lookup plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+- aws_ec2 inventory plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+- aws_rds inventory plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+- aws_resource_actions callback plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+- aws_secret lookup plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+- aws_service_ip_ranges lookup plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+- aws_ssm - Fix environment variables for client configuration (e.g., AWS_PROFILE, AWS_ACCESS_KEY_ID) (https://github.com/ansible-collections/amazon.aws/pull/837).
+- aws_ssm lookup plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+- ec2_instance - ec2_instance module broken in Python 3.8 - dict keys modified during iteration (https://github.com/ansible-collections/amazon.aws/issues/709).
+- module.utils.rds - Add waiter for promoting read replica to fix idempotency issue (https://github.com/ansible-collections/amazon.aws/pull/714).
+- module.utils.rds - Catch InvalidDBSecurityGroupStateFault when modifying a db instance (https://github.com/ansible-collections/amazon.aws/pull/776).
+- module.utils.s3 - Update validate_bucket_name minimum length to 3 (https://github.com/ansible-collections/amazon.aws/pull/802).
+
 v3.2.0
 ======
 

README.md

@@ -8,6 +8,8 @@ AWS related modules and plugins supported by the Ansible community are in the [c
 
 This collection has been tested against following Ansible versions: **>=2.9.10**.
 
+For collections that support Ansible 2.9, please ensure you update your `network_os` to use the
+fully qualified collection name (for example, `cisco.ios.ios`).
 Plugins and modules within a collection may be tested with only specific Ansible versions.
 A collection may contain metadata that identifies these versions.
 PEP440 is the schema used to describe the versions of Ansible.
@@ -62,7 +64,7 @@ Name | Description
 [amazon.aws.ec2_key](https://github.com/ansible-collections/amazon.aws/blob/stable-3/docs/amazon.aws.ec2_key_module.rst)|create or delete an ec2 key pair
 [amazon.aws.ec2_metadata_facts](https://github.com/ansible-collections/amazon.aws/blob/stable-3/docs/amazon.aws.ec2_metadata_facts_module.rst)|gathers facts (instance metadata) about remote hosts within EC2
 [amazon.aws.ec2_snapshot](https://github.com/ansible-collections/amazon.aws/blob/stable-3/docs/amazon.aws.ec2_snapshot_module.rst)|Creates a snapshot from an existing volume
-[amazon.aws.ec2_snapshot_info](https://github.com/ansible-collections/amazon.aws/blob/stable-3/docs/amazon.aws.ec2_snapshot_info_module.rst)|Gather information about ec2 volume snapshots in AWS
+[amazon.aws.ec2_snapshot_info](https://github.com/ansible-collections/amazon.aws/blob/stable-3/docs/amazon.aws.ec2_snapshot_info_module.rst)|Gathers information about EC2 volume snapshots in AWS
 [amazon.aws.ec2_spot_instance](https://github.com/ansible-collections/amazon.aws/blob/stable-3/docs/amazon.aws.ec2_spot_instance_module.rst)|request, stop, reboot or cancel spot instance
 [amazon.aws.ec2_spot_instance_info](https://github.com/ansible-collections/amazon.aws/blob/stable-3/docs/amazon.aws.ec2_spot_instance_info_module.rst)|Gather information about ec2 spot instance requests
 [amazon.aws.ec2_tag](https://github.com/ansible-collections/amazon.aws/blob/stable-3/docs/amazon.aws.ec2_tag_module.rst)|create and remove tags on ec2 resources

changelogs/changelog.yaml

@@ -743,3 +743,49 @@ releases:
     - 696-elbv2-support-alb-attributes.yml
     - 719-ec2_instance-fix-deprecation-warning-scope.yml
     release_date: '2022-04-05'
+  3.3.0:
+    changes:
+      bugfixes:
+      - Include ``PSF-license.txt`` file for ``plugins/module_utils/_version.py``.
+      - aws_account_attribute lookup plugin - fix linting errors in documentation
+        data (https://github.com/ansible-collections/amazon.aws/pull/701).
+      - aws_ec2 inventory plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+      - aws_rds inventory plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+      - aws_resource_actions callback plugin - fix linting errors in documentation
+        data (https://github.com/ansible-collections/amazon.aws/pull/701).
+      - aws_secret lookup plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+      - aws_service_ip_ranges lookup plugin - fix linting errors in documentation
+        data (https://github.com/ansible-collections/amazon.aws/pull/701).
+      - aws_ssm - Fix environment variables for client configuration (e.g., AWS_PROFILE,
+        AWS_ACCESS_KEY_ID) (https://github.com/ansible-collections/amazon.aws/pull/837).
+      - aws_ssm lookup plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
+      - ec2_instance - ec2_instance module broken in Python 3.8 - dict keys modified
+        during iteration (https://github.com/ansible-collections/amazon.aws/issues/709).
+      - module.utils.rds - Add waiter for promoting read replica to fix idempotency
+        issue (https://github.com/ansible-collections/amazon.aws/pull/714).
+      - module.utils.rds - Catch InvalidDBSecurityGroupStateFault when modifying a
+        db instance (https://github.com/ansible-collections/amazon.aws/pull/776).
+      - module.utils.s3 - Update validate_bucket_name minimum length to 3 (https://github.com/ansible-collections/amazon.aws/pull/802).
+      minor_changes:
+      - aws_ec2 inventory - Allow for literal strings in hostname that don't match
+        filter parameters in ec2 describe-instances (https://github.com/ansible-collections/amazon.aws/pull/826).
+      - aws_ssm - Add support for ``endpoint`` parameter (https://github.com/ansible-collections/amazon.aws/pull/837).
+      - module.utils.rds - add retry_codes to get_rds_method_attribute return data
+        to use in call_method and add unit tests (https://github.com/ansible-collections/amazon.aws/pull/776).
+      - module.utils.rds - refactor to utilize get_rds_method_attribute return data
+        (https://github.com/ansible-collections/amazon.aws/pull/776).
+      - module_utils - add new aliases ``aws_session_token`` and ``session_token``
+        to the ``security_token`` parameter to be more in-line with the boto SDK (https://github.com/ansible-collections/amazon.aws/pull/631).
+      - module_utils.rds - Add support and unit tests for addition/removal of IAM
+        roles to/from a db instance in module_utils.rds with waiters (https://github.com/ansible-collections/amazon.aws/pull/714).
+    fragments:
+    - 655-aws_ec2-aws_rds-add-support-for-hostvars_prefix-and-hostvars_suffix.yml
+    - 709-ec_2_instance-python-3-8-compatibility.yml
+    - 714-module_util_rds-support-iam-roles-add-waiters.yml
+    - 776-module_util_rds-add-extra-retry-codes-refactor.yml
+    - 802-update-s3-module_util-validate_bucket_name-to-accept-3-character-bucket-name.yml
+    - 826-inventory-aws_ec2-allow-literal-string-in-hostname.yml
+    - 837-aws_ssm-envars.yml
+    - psf-license.yml
+    - validate-plugins.yml
+    release_date: '2022-05-26'

changelogs/fragments/655-aws_ec2-aws_rds-add-support-for-hostvars_prefix-and-hostvars_suffix.yml

@@ -25,7 +25,7 @@ Requirements
 The below requirements are needed on the local Ansible controller node that executes this lookup.
 
 - python >= 3.6
-- boto3
+- boto3 >= 1.16.0
 - botocore >= 1.19.0
 
 
@@ -230,7 +230,7 @@ Status
 Authors
 ~~~~~~~
 
-- Sloane Hertel <[email protected]>
+- Sloane Hertel (@s-hertel) <[email protected]>
 
 
 .. hint::

changelogs/fragments/709-ec_2_instance-python-3-8-compatibility.yml

@@ -216,7 +216,8 @@ Parameters
                         <div><code>AWS STS security token</code>. If not set then the value of the <code>AWS_SECURITY_TOKEN</code> or <code>EC2_SECURITY_TOKEN</code> environment variable is used.</div>
                         <div>If <em>profile</em> is set this parameter is ignored.</div>
                         <div>Passing the <em>security_token</em> and <em>profile</em> options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.</div>
-                        <div style="font-size: small; color: darkgreen"><br/>aliases: aws_security_token, access_token</div>
+                        <div>Aliases <em>aws_session_token</em> and <em>session_token</em> have been added in version 3.2.0.</div>
+                        <div style="font-size: small; color: darkgreen"><br/>aliases: aws_session_token, session_token, aws_security_token, access_token</div>
                 </td>
             </tr>
             <tr>

changelogs/fragments/714-module_util_rds-support-iam-roles-add-waiters.yml

@@ -195,7 +195,8 @@ Parameters
                         <div><code>AWS STS security token</code>. If not set then the value of the <code>AWS_SECURITY_TOKEN</code> or <code>EC2_SECURITY_TOKEN</code> environment variable is used.</div>
                         <div>If <em>profile</em> is set this parameter is ignored.</div>
                         <div>Passing the <em>security_token</em> and <em>profile</em> options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.</div>
-                        <div style="font-size: small; color: darkgreen"><br/>aliases: aws_security_token, access_token</div>
+                        <div>Aliases <em>aws_session_token</em> and <em>session_token</em> have been added in version 3.2.0.</div>
+                        <div style="font-size: small; color: darkgreen"><br/>aliases: aws_session_token, session_token, aws_security_token, access_token</div>
                 </td>
             </tr>
             <tr>