Prep 2.3.0 release - run add_docs, generate changelog (#841)

Prep 2.3.0 release

SUMMARY
Run add_docs, generate changelog
ISSUE TYPE

Feature Pull Request

COMPONENT NAME
amazon.aws 2.3

Reviewed-by: Alina Buzachis <None>
Reviewed-by: Jill R <None>

Author: jatorcasso

CHANGELOG.rst

@@ -5,6 +5,22 @@ community.aws Release Notes
 .. contents:: Topics
 
 
+v2.3.0
+======
+
+Bugfixes
+--------
+
+- 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 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.s3 - Update validate_bucket_name minimum length to 3 (https://github.com/ansible-collections/amazon.aws/pull/802).
+
 v2.2.0
 ======
 

README.md

@@ -8,8 +8,6 @@ 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.
@@ -60,7 +58,7 @@ Name | Description
 [amazon.aws.ec2_key](https://github.com/ansible-collections/amazon.aws/blob/stable-2/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-2/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-2/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-2/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-2/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-2/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-2/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-2/docs/amazon.aws.ec2_tag_module.rst)|create and remove tags on ec2 resources

changelogs/changelog.yaml

@@ -622,3 +622,24 @@ releases:
     - 691-ec2_vpc_igw-fix-null-igw-error.yml
     - 695-ec2_vpc_igw-fix-nonetype-with-paginator.yml
     release_date: '2022-03-22'
+  2.3.0:
+    changes:
+      bugfixes:
+      - 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 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.s3 - Update validate_bucket_name minimum length to 3 (https://github.com/ansible-collections/amazon.aws/pull/802).
+    fragments:
+    - 709-ec_2_instance-python-3-8-compatibility.yml
+    - 802-update-s3-module_util-validate_bucket_name-to-accept-3-character-bucket-name.yml
+    - validate-plugins.yml
+    release_date: '2022-05-25'

changelogs/fragments/709-ec_2_instance-python-3-8-compatibility.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.15.0
 - botocore >= 1.18.0
 
 
@@ -230,7 +230,7 @@ Status
 Authors
 ~~~~~~~
 
-- Sloane Hertel <[email protected]>
+- Sloane Hertel (@s-hertel) <[email protected]>
 
 
 .. hint::

changelogs/fragments/802-update-s3-module_util-validate_bucket_name-to-accept-3-character-bucket-name.yml

@@ -25,8 +25,9 @@ Requirements
 ------------
 The below requirements are needed on the local Ansible controller node that executes this inventory.
 
-- boto3
-- botocore
+- python >= 3.6
+- boto3 >= 1.15.0
+- botocore >= 1.18.0
 
 
 Parameters
@@ -269,6 +270,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=dictionary</span>
                     </div>
                 </td>
                 <td>
@@ -327,6 +329,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=dictionary</span>
                     </div>
                 </td>
                 <td>
@@ -386,6 +389,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=dictionary</span>
                     </div>
                 </td>
                 <td>
@@ -590,6 +594,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                     </div>
                 </td>
                 <td>

changelogs/fragments/validate-plugins.yml

@@ -25,8 +25,9 @@ Requirements
 ------------
 The below requirements are needed on the local Ansible controller node that executes this inventory.
 
-- boto3
-- botocore
+- python >= 3.6
+- boto3 >= 1.15.0
+- botocore >= 1.18.0
 
 
 Parameters
@@ -523,6 +524,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                     </div>
                 </td>
                 <td>
@@ -607,6 +609,12 @@ Parameters
     <br/>
 
 
+Notes
+-----
+
+.. note::
+   - Ansible versions prior to 2.10 should use the fully qualified plugin name 'amazon.aws.aws_rds'.
+
 
 
 Examples

docs/amazon.aws.aws_account_attribute_lookup.rst

@@ -27,7 +27,7 @@ Requirements
 The below requirements are needed on the local Ansible controller node that executes this lookup.
 
 - python >= 3.6
-- boto3
+- boto3 >= 1.15.0
 - botocore >= 1.18.0
 
 
@@ -415,7 +415,7 @@ Status
 Authors
 ~~~~~~~
 
-- Aaron Smith <[email protected]>
+- Aaron Smith (!UNKNOWN) <[email protected]>
 
 
 .. hint::

docs/amazon.aws.aws_ec2_inventory.rst

@@ -155,7 +155,7 @@ Status
 Authors
 ~~~~~~~
 
-- James Turner <[email protected]>
+- James Turner (!UNKNOWN) <[email protected]>
 
 
 .. hint::

docs/amazon.aws.aws_rds_inventory.rst

@@ -28,7 +28,7 @@ Requirements
 The below requirements are needed on the local Ansible controller node that executes this lookup.
 
 - python >= 3.6
-- boto3
+- boto3 >= 1.15.0
 - botocore >= 1.18.0
 
 
@@ -242,9 +242,9 @@ Status
 Authors
 ~~~~~~~
 
-- Bill Wang <ozbillwang(at)gmail.com>
-- Marat Bakeev <hawara(at)gmail.com>
-- Michael De La Rue <[email protected]>
+- Bill Wang (!UNKNOWN) <ozbillwang(at)gmail.com>
+- Marat Bakeev (!UNKNOWN) <hawara(at)gmail.com>
+- Michael De La Rue (!UNKNOWN) <[email protected]>
 
 
 .. hint::

docs/amazon.aws.aws_secret_lookup.rst

@@ -730,6 +730,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                     </div>
                 </td>
                 <td>
@@ -746,6 +747,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                     </div>
                 </td>
                 <td>
@@ -762,6 +764,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                     </div>
                 </td>
                 <td>
@@ -794,6 +797,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
+                         / <span style="color: purple">elements=string</span>
                     </div>
                 </td>
                 <td>

docs/amazon.aws.aws_service_ip_ranges_lookup.rst

@@ -5,7 +5,7 @@
 amazon.aws.ec2_snapshot_info
 ****************************
 
-**Gather information about ec2 volume snapshots in AWS**
+**Gathers information about EC2 volume snapshots in AWS**
 
 
 Version added: 1.0.0
@@ -17,7 +17,7 @@ Version added: 1.0.0
 
 Synopsis
 --------
-- Gather information about ec2 volume snapshots in AWS.
+- Gathers information about EC2 volume snapshots in AWS.
 - This module was called ``ec2_snapshot_facts`` before Ansible 2.9. The usage did not change.
 
 
@@ -435,7 +435,7 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
                 </td>
                 <td>always</td>
                 <td>
-                            <div>The data encryption key identifier for the snapshot. This value is a unique identifier that             corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy.</div>
+                            <div>The data encryption key identifier for the snapshot. This value is a unique identifier that corresponds to the data encryption key that was used to encrypt the original volume or snapshot copy.</div>
                     <br/>
                         <div style="font-size: smaller"><b>Sample:</b></div>
                         <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">arn:aws:kms:ap-southeast-2:012345678900:key/74c9742a-a1b2-45cb-b3fe-abcdef123456</div>
@@ -489,7 +489,7 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
                 </td>
                 <td>always</td>
                 <td>
-                            <div>The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to             protect the volume encryption key for the parent volume.</div>
+                            <div>The full ARN of the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to protect the volume encryption key for the parent volume.</div>
                     <br/>
                         <div style="font-size: smaller"><b>Sample:</b></div>
                         <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">74c9742a-a1b2-45cb-b3fe-abcdef123456</div>

docs/amazon.aws.aws_ssm_lookup.rst

@@ -1,6 +1,6 @@
 namespace: amazon
 name: aws
-version: 2.2.0
+version: 2.3.0
 readme: README.md
 authors:
   - Ansible (https://github.com/ansible)