Prep 3.1.0 release

CHANGELOG.rst

@@ -5,6 +5,37 @@ community.aws Release Notes
 .. contents:: Topics
 
 
+v3.1.0
+======
+
+Minor Changes
+-------------
+
+- add new parameters hostvars_prefix and hostvars_suffix for inventory plugins aws_ec2 and aws_rds (https://github.com/ansible-collections/amazon.aws/issues/535).
+- aws_s3 - Add ``validate_bucket_name`` option, to control bucket name validation (https://github.com/ansible-collections/amazon.aws/pull/615).
+- aws_s3 - add latest choice on ``overwrite`` parameter to get latest object on S3 (https://github.com/ansible-collections/amazon.aws/pull/595).
+- ec2_vol - add support for OutpostArn param (https://github.com/ansible-collections/amazon.aws/pull/597).
+- ec2_vol - tag volume on creation (https://github.com/ansible-collections/amazon.aws/pull/603).
+- ec2_vpc_route_table - add support for IPv6 in creating route tables (https://github.com/ansible-collections/amazon.aws/pull/601).
+- s3_bucket - Add ``validate_bucket_name`` option, to control bucket name validation (https://github.com/ansible-collections/amazon.aws/pull/615).
+
+Deprecated Features
+-------------------
+
+- ec2_instance - The default value for ```instance_type``` has been deprecated, in the future release you must set an instance_type or a launch_template (https://github.com/ansible-collections/amazon.aws/pull/587).
+
+Bugfixes
+--------
+
+- Various modules and plugins - use vendored version of ``distutils.version`` instead of the deprecated Python standard library ``distutils`` (https://github.com/ansible-collections/amazon.aws/pull/599).
+- aws_acm - No longer raising ResourceNotFound exception while retrieving ACM certificates.
+- aws_s3 - fix exception raised when using module to copy from source to destination and key is missing from source (https://github.com/ansible-collections/amazon.aws/issues/602).
+- ec2_instance - Add a condition to handle default ```instance_type``` value for fix breaking on instance creation with launch template (https://github.com/ansible-collections/amazon.aws/pull/587).
+- ec2_key - add support for ED25519 key type (https://github.com/ansible-collections/amazon.aws/issues/572).
+- ec2_vol - Sets the Iops value in req_obj even if the iops value has not changed, to allow modifying volume types that require passing an iops value to boto. (https://github.com/ansible-collections/amazon.aws/pull/606)
+- elb_classic_lb - handle security_group_ids when providing security_group_names and fix broken tasks in integration test (https://github.com/ansible-collections/amazon.aws/pull/592).
+- s3_bucket - Enable the management of bucket-level ACLs (https://github.com/ansible-collections/amazon.aws/issues/573).
+
 v3.0.0
 ======
 

changelogs/changelog.yaml

@@ -649,3 +649,52 @@ releases:
     - 575-deprecate-boto.yml
     - remove_deprecated_facts.yml
     release_date: '2021-12-06'
+  3.1.0:
+    changes:
+      bugfixes:
+      - Various modules and plugins - use vendored version of ``distutils.version``
+        instead of the deprecated Python standard library ``distutils`` (https://github.com/ansible-collections/amazon.aws/pull/599).
+      - aws_acm - No longer raising ResourceNotFound exception while retrieving ACM
+        certificates.
+      - aws_s3 - fix exception raised when using module to copy from source to destination
+        and key is missing from source (https://github.com/ansible-collections/amazon.aws/issues/602).
+      - ec2_instance - Add a condition to handle default ```instance_type``` value
+        for fix breaking on instance creation with launch template (https://github.com/ansible-collections/amazon.aws/pull/587).
+      - ec2_key - add support for ED25519 key type (https://github.com/ansible-collections/amazon.aws/issues/572).
+      - ec2_vol - Sets the Iops value in req_obj even if the iops value has not changed,
+        to allow modifying volume types that require passing an iops value to boto.
+        (https://github.com/ansible-collections/amazon.aws/pull/606)
+      - elb_classic_lb - handle security_group_ids when providing security_group_names
+        and fix broken tasks in integration test (https://github.com/ansible-collections/amazon.aws/pull/592).
+      - s3_bucket - Enable the management of bucket-level ACLs (https://github.com/ansible-collections/amazon.aws/issues/573).
+      deprecated_features:
+      - ec2_instance - The default value for ```instance_type``` has been deprecated,
+        in the future release you must set an instance_type or a launch_template (https://github.com/ansible-collections/amazon.aws/pull/587).
+      minor_changes:
+      - add new parameters hostvars_prefix and hostvars_suffix for inventory plugins
+        aws_ec2 and aws_rds (https://github.com/ansible-collections/amazon.aws/issues/535).
+      - aws_s3 - Add ``validate_bucket_name`` option, to control bucket name validation
+        (https://github.com/ansible-collections/amazon.aws/pull/615).
+      - aws_s3 - add latest choice on ``overwrite`` parameter to get latest object
+        on S3 (https://github.com/ansible-collections/amazon.aws/pull/595).
+      - ec2_vol - add support for OutpostArn param (https://github.com/ansible-collections/amazon.aws/pull/597).
+      - ec2_vol - tag volume on creation (https://github.com/ansible-collections/amazon.aws/pull/603).
+      - ec2_vpc_route_table - add support for IPv6 in creating route tables (https://github.com/ansible-collections/amazon.aws/pull/601).
+      - s3_bucket - Add ``validate_bucket_name`` option, to control bucket name validation
+        (https://github.com/ansible-collections/amazon.aws/pull/615).
+    fragments:
+    - 587-ec2_instance-default-instance-type-launch-template.yml
+    - 592-elb_classic_lb-handle-sg-ids-fix-tests.yml
+    - 593-aws_s3-fix-copy-when-missing-key.yml
+    - 595-aws_s3-add-latest-choice-on-overwrite-parameter.yml
+    - 597-ec2_vol-add-outpostarn-support.yml
+    - 601-ec2_vpc_route_table-ipv6-support.yml
+    - 603-ec2_vol-add-tags-on-creation.yml
+    - 606-ec2_vol-set-iops-even-if-unchanged-for-boto-req.yml
+    - 611-s3_bucket-add-support-for-acl.yml
+    - 614-ec2_key-add-support-for-ed25519-key-type.yml
+    - 615-s3-validate_bucket_name.yml
+    - 619-aws_ec2-aws_rds-add-support-for-hostvars_prefix-and-hostvars_suffix.yml
+    - 646-acm-resource-not-found.yml
+    - disutils.version.yml
+    release_date: '2022-02-10'

docs/amazon.aws.aws_az_info_module.rst

@@ -27,8 +27,8 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - python >= 3.6
-- boto3 >= 1.15.0
-- botocore >= 1.18.0
+- boto3 >= 1.16.0
+- botocore >= 1.19.0
 
 
 Parameters

docs/amazon.aws.aws_caller_info_module.rst

@@ -27,8 +27,8 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - python >= 3.6
-- boto3 >= 1.15.0
-- botocore >= 1.18.0
+- boto3 >= 1.16.0
+- botocore >= 1.19.0
 
 
 Parameters

docs/amazon.aws.aws_ec2_inventory.rst

@@ -17,7 +17,7 @@ amazon.aws.aws_ec2
 Synopsis
 --------
 - Get inventory hosts from Amazon Web Services EC2.
-- Uses a YAML configuration file that ends with ``aws_ec2.(yml|yaml``).
+- Uses a YAML configuration file that ends with ``aws_ec2.{yml|yaml}``.
 
 
 
@@ -339,6 +339,42 @@ Parameters
                         <div>To use tags as hostnames use the syntax tag:Name=Value to use the hostname Name_Value, or tag:Name to use the value of the Name tag.</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>hostvars_prefix</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 3.1.0</div>
+                </td>
+                <td>
+                </td>
+                    <td>
+                    </td>
+                <td>
+                        <div>The prefix for host variables names coming from AWS.</div>
+                </td>
+            </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>hostvars_suffix</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 3.1.0</div>
+                </td>
+                <td>
+                </td>
+                    <td>
+                    </td>
+                <td>
+                        <div>The suffix for host variables names coming from AWS.</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="1">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -716,6 +752,12 @@ Examples
       ansible_host: public_dns_name
     groups:
       libvpc: vpc_id == 'vpc-####'
+    # Define prefix and suffix for host variables coming from AWS.
+    plugin: aws_ec2
+    regions:
+      - us-east-1
+    hostvars_prefix: 'aws_'
+    hostvars_suffix: '_ec2'
 
 
 

docs/amazon.aws.aws_rds_inventory.rst

@@ -297,6 +297,42 @@ Parameters
                         <div>Add hosts to group based on Jinja2 conditionals.</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>hostvars_prefix</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 3.1.0</div>
+                </td>
+                <td>
+                </td>
+                    <td>
+                    </td>
+                <td>
+                        <div>The prefix for host variables names coming from AWS.</div>
+                </td>
+            </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>hostvars_suffix</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 3.1.0</div>
+                </td>
+                <td>
+                </td>
+                    <td>
+                    </td>
+                <td>
+                        <div>The suffix for host variables names coming from AWS.</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="1">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -504,6 +540,8 @@ Examples
         prefix: rds
       - key: tags
       - key: region
+    hostvars_prefix: aws_
+    hostvars_suffix: _rds
 
 
 

docs/amazon.aws.aws_s3_module.rst

@@ -26,8 +26,8 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - python >= 3.6
-- boto3 >= 1.15.0
-- botocore >= 1.18.0
+- boto3 >= 1.16.0
+- botocore >= 1.19.0
 
 
 Parameters
@@ -515,10 +515,11 @@ Parameters
                 </td>
                 <td>
                         <div>Force overwrite either locally on the filesystem or remotely with the object/key. Used with <code>PUT</code> and <code>GET</code> operations.</div>
-                        <div>Must be a Boolean, <code>always</code>, <code>never</code> or <code>different</code>.</div>
+                        <div>Must be a Boolean, <code>always</code>, <code>never</code>, <code>different</code> or <code>latest</code>.</div>
                         <div><code>true</code> is the same as <code>always</code>.</div>
                         <div><code>false</code> is equal to <code>never</code>.</div>
                         <div>When this is set to <code>different</code> the MD5 sum of the local file is compared with the &#x27;ETag&#x27; of the object/key in S3. The ETag may or may not be an MD5 digest of the object data. See the ETag response header here <a href='https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonResponseHeaders.html'>https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonResponseHeaders.html</a>.</div>
+                        <div>(<code>GET</code> mode only) When this is set to <code>latest</code> the last modified timestamp of local file is compared with the &#x27;LastModified&#x27; of the object/key in S3.</div>
                         <div style="font-size: small; color: darkgreen"><br/>aliases: force</div>
                 </td>
             </tr>
@@ -711,6 +712,28 @@ Parameters
                         <div>Tags dict to apply to the S3 object.</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="2">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>validate_bucket_name</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">boolean</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 3.1.0</div>
+                </td>
+                <td>
+                        <ul style="margin: 0; padding: 0"><b>Choices:</b>
+                                    <li>no</li>
+                                    <li><div style="color: blue"><b>yes</b>&nbsp;&larr;</div></li>
+                        </ul>
+                </td>
+                <td>
+                        <div>Whether the bucket name should be validated to conform to AWS S3 naming rules.</div>
+                        <div>On by default, this may be disabled for S3 backends that do not enforce these rules.</div>
+                        <div>See https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="2">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>

docs/amazon.aws.cloudformation_info_module.rst

@@ -26,8 +26,8 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - python >= 3.6
-- boto3 >= 1.15.0
-- botocore >= 1.18.0
+- boto3 >= 1.16.0
+- botocore >= 1.19.0
 
 
 Parameters

docs/amazon.aws.cloudformation_module.rst

@@ -26,8 +26,8 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - python >= 3.6
-- boto3 >= 1.15.0
-- botocore >= 1.18.0
+- boto3 >= 1.16.0
+- botocore >= 1.19.0
 
 
 Parameters

docs/amazon.aws.ec2_ami_info_module.rst

@@ -26,8 +26,8 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - python >= 3.6
-- boto3 >= 1.15.0
-- botocore >= 1.18.0
+- boto3 >= 1.16.0
+- botocore >= 1.19.0
 
 
 Parameters

docs/amazon.aws.ec2_ami_module.rst

@@ -26,8 +26,8 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - python >= 3.6
-- boto3 >= 1.15.0
-- botocore >= 1.18.0
+- boto3 >= 1.16.0
+- botocore >= 1.19.0
 
 
 Parameters

docs/amazon.aws.ec2_eni_info_module.rst

@@ -26,8 +26,8 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - python >= 3.6
-- boto3 >= 1.15.0
-- botocore >= 1.18.0
+- boto3 >= 1.16.0
+- botocore >= 1.19.0
 
 
 Parameters