Skip to content

Commit 8d35ae4

Browse files
mandar242mandar242
authored
Prep 2.2.0 release, Run add_docs, generate changelog (#727)
Prep 2.2.0 release, Run add_docs, generate changelog SUMMARY Prep 2.2.0 release, Run add_docs, Generate changelog ISSUE TYPE Feature Pull Request Reviewed-by: Alina Buzachis <None> Reviewed-by: Mark Chappell <None>
1 parent fe5cfae commit 8d35ae4

14 files changed

+295
-71
lines changed

‎CHANGELOG.rst

+18
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,24 @@ community.aws Release Notes
55
.. contents:: Topics
66

77

8+
v2.2.0
9+
======
10+
11+
Minor Changes
12+
-------------
13+
14+
- ec2_instance - add count parameter support (https://github.com/ansible-collections/amazon.aws/pull/539).
15+
16+
Bugfixes
17+
--------
18+
19+
- aws_ec2 inventory - use the iam_role_arn configuration parameter to assume the role before trying to call DescribeRegions if the regions configuration is not set and AWS credentials provided without enough privilege to perform the DescribeRegions action. (https://github.com/ansible-collections/amazon.aws/issues/566).
20+
- 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)
21+
- ec2_vol - changing a volume from a type that does not support IOPS (like ``standard``) to a type that does (like ``gp3``) fails (https://github.com/ansible-collections/amazon.aws/issues/626).
22+
- ec2_vpc_igw - fix 'NoneType' object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/691).
23+
- ec2_vpc_igw - use paginator for describe internet gateways and add retry to fix NoneType object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/695).
24+
- 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).
25+
826
v2.1.0
927
======
1028

‎README.md

+49-47
Large diffs are not rendered by default.

‎changelogs/changelog.yaml

+28
Original file line numberDiff line numberDiff line change
@@ -594,3 +594,31 @@ releases:
594594
- 552-elb_classic_lb-fact.yml
595595
- 557-action_group-missing-entry.yml
596596
release_date: '2021-11-11'
597+
2.2.0:
598+
changes:
599+
bugfixes:
600+
- aws_ec2 inventory - use the iam_role_arn configuration parameter to assume
601+
the role before trying to call DescribeRegions if the regions configuration
602+
is not set and AWS credentials provided without enough privilege to perform
603+
the DescribeRegions action. (https://github.com/ansible-collections/amazon.aws/issues/566).
604+
- ec2_vol - Sets the Iops value in req_obj even if the iops value has not changed,
605+
to allow modifying volume types that require passing an iops value to boto.
606+
(https://github.com/ansible-collections/amazon.aws/pull/606)
607+
- ec2_vol - changing a volume from a type that does not support IOPS (like ``standard``)
608+
to a type that does (like ``gp3``) fails (https://github.com/ansible-collections/amazon.aws/issues/626).
609+
- ec2_vpc_igw - fix 'NoneType' object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/691).
610+
- ec2_vpc_igw - use paginator for describe internet gateways and add retry to
611+
fix NoneType object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/695).
612+
- elb_classic_lb - handle security_group_ids when providing security_group_names
613+
and fix broken tasks in integration test (https://github.com/ansible-collections/amazon.aws/pull/592).
614+
minor_changes:
615+
- ec2_instance - add count parameter support (https://github.com/ansible-collections/amazon.aws/pull/539).
616+
fragments:
617+
- 539-ec2_instance_add_count_param.yml
618+
- 592-elb_classic_lb-handle-sg-ids-fix-tests.yml
619+
- 606-ec2_vol-set-iops-even-if-unchanged-for-boto-req.yml
620+
- 619-inventory-aws_ec2-assume-arn-role-when-listing-regions.yml
621+
- 626-ec2_vol-iops-when-source-does-not-have-iops.yml
622+
- 691-ec2_vpc_igw-fix-null-igw-error.yml
623+
- 695-ec2_vpc_igw-fix-nonetype-with-paginator.yml
624+
release_date: '2022-03-22'

‎changelogs/fragments/539-ec2_instance_add_count_param.yml

-3
This file was deleted.

‎changelogs/fragments/592-elb_classic_lb-handle-sg-ids-fix-tests.yml

-2
This file was deleted.

‎changelogs/fragments/606-ec2_vol-set-iops-even-if-unchanged-for-boto-req.yml

-5
This file was deleted.

‎changelogs/fragments/619-inventory-aws_ec2-assume-arn-role-when-listing-regions.yml

-5
This file was deleted.

‎changelogs/fragments/626-ec2_vol-iops-when-source-does-not-have-iops.yml

-3
This file was deleted.

‎changelogs/fragments/691-ec2_vpc_igw-fix-null-igw-error.yml

-2
This file was deleted.

‎changelogs/fragments/695-ec2_vpc_igw-fix-nonetype-with-paginator.yml

-2
This file was deleted.

‎docs/amazon.aws.aws_ec2_inventory.rst

+1-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ amazon.aws.aws_ec2
1717
Synopsis
1818
--------
1919
- Get inventory hosts from Amazon Web Services EC2.
20-
- Uses a YAML configuration file that ends with ``aws_ec2.(yml|yaml``).
20+
- Uses a YAML configuration file that ends with ``aws_ec2.{yml|yaml}``.
2121

2222

2323

‎docs/amazon.aws.ec2_instance_module.rst

+68
Original file line numberDiff line numberDiff line change
@@ -129,6 +129,24 @@ Parameters
129129
<div style="font-size: small; color: darkgreen"><br/>aliases: ec2_secret_key, secret_key</div>
130130
</td>
131131
</tr>
132+
<tr>
133+
<td colspan="2">
134+
<div class="ansibleOptionAnchor" id="parameter-"></div>
135+
<b>count</b>
136+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
137+
<div style="font-size: small">
138+
<span style="color: purple">integer</span>
139+
</div>
140+
<div style="font-style: italic; font-size: small; color: darkgreen">added in 2.2.0</div>
141+
</td>
142+
<td>
143+
</td>
144+
<td>
145+
<div>Number of instances to launch.</div>
146+
<div>Setting this value will result in always launching new instances.</div>
147+
<div>Mutually exclusive with <em>exact_count</em>.</div>
148+
</td>
149+
</tr>
132150
<tr>
133151
<td colspan="2">
134152
<div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -278,6 +296,25 @@ Parameters
278296
<div style="font-size: small; color: darkgreen"><br/>aliases: aws_endpoint_url, endpoint_url</div>
279297
</td>
280298
</tr>
299+
<tr>
300+
<td colspan="2">
301+
<div class="ansibleOptionAnchor" id="parameter-"></div>
302+
<b>exact_count</b>
303+
<a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
304+
<div style="font-size: small">
305+
<span style="color: purple">integer</span>
306+
</div>
307+
<div style="font-style: italic; font-size: small; color: darkgreen">added in 2.2.0</div>
308+
</td>
309+
<td>
310+
</td>
311+
<td>
312+
<div>An integer value which indicates how many instances that match the <em>filters</em> parameter should be running.</div>
313+
<div>Instances are either created or terminated based on this value.</div>
314+
<div>If termination takes place, least recently created instances will be terminated based on Launch Time.</div>
315+
<div>Mutually exclusive with <em>count</em>, <em>instance_ids</em>.</div>
316+
</td>
317+
</tr>
281318
<tr>
282319
<td colspan="2">
283320
<div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -388,6 +425,7 @@ Parameters
388425
</td>
389426
<td>
390427
<div>If you specify one or more instance IDs, only instances that have the specified IDs are returned.</div>
428+
<div>Mutually exclusive with <em>exact_count</em>.</div>
391429
</td>
392430
</tr>
393431
<tr>
@@ -1295,6 +1333,7 @@ Examples
12951333
tags:
12961334
Env: "eni_on"
12971335
instance_type: t2.micro
1336+
12981337
- name: start an instance with metadata options
12991338
amazon.aws.ec2_instance:
13001339
name: "public-metadataoptions-instance"
@@ -1307,6 +1346,35 @@ Examples
13071346
http_endpoint: enabled
13081347
http_tokens: optional
13091348
1349+
# ensure number of instances running with a tag matches exact_count
1350+
- name: start multiple instances
1351+
amazon.aws.ec2_instance:
1352+
instance_type: t3.small
1353+
image_id: ami-123456
1354+
exact_count: 5
1355+
region: us-east-2
1356+
vpc_subnet_id: subnet-0123456
1357+
network:
1358+
assign_public_ip: yes
1359+
security_group: default
1360+
tags:
1361+
foo: bar
1362+
1363+
# launches multiple instances - specific number of instances
1364+
- name: start specific number of multiple instances
1365+
amazon.aws.ec2_instance:
1366+
instance_type: t3.small
1367+
image_id: ami-123456
1368+
count: 3
1369+
region: us-east-2
1370+
network:
1371+
assign_public_ip: yes
1372+
security_group: default
1373+
vpc_subnet_id: subnet-0123456
1374+
state: present
1375+
tags:
1376+
foo: bar
1377+
13101378
13111379
13121380
Return Values

‎docs/amazon.aws.s3_bucket_module.rst

+130
Original file line numberDiff line numberDiff line change
@@ -705,6 +705,136 @@ Examples
705705
706706
707707
708+
Return Values
709+
-------------
710+
Common return values are documented `here <https://docs.ansible.com/ansible/latest/reference_appendices/common_return_values.html#common-return-values>`_, the following are the fields unique to this module:
711+
712+
.. raw:: html
713+
714+
<table border=0 cellpadding=0 class="documentation-table">
715+
<tr>
716+
<th colspan="1">Key</th>
717+
<th>Returned</th>
718+
<th width="100%">Description</th>
719+
</tr>
720+
<tr>
721+
<td colspan="1">
722+
<div class="ansibleOptionAnchor" id="return-"></div>
723+
<b>encryption</b>
724+
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
725+
<div style="font-size: small">
726+
<span style="color: purple">string</span>
727+
</div>
728+
</td>
729+
<td><em>state=present</em></td>
730+
<td>
731+
<div>Server-side encryption of the objects in the S3 bucket.</div>
732+
<br/>
733+
</td>
734+
</tr>
735+
<tr>
736+
<td colspan="1">
737+
<div class="ansibleOptionAnchor" id="return-"></div>
738+
<b>name</b>
739+
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
740+
<div style="font-size: small">
741+
<span style="color: purple">string</span>
742+
</div>
743+
</td>
744+
<td><em>state=present</em></td>
745+
<td>
746+
<div>Name of the S3 bucket.</div>
747+
<br/>
748+
<div style="font-size: smaller"><b>Sample:</b></div>
749+
<div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">2d3ce10a8210d36d6b4d23b822892074complex</div>
750+
</td>
751+
</tr>
752+
<tr>
753+
<td colspan="1">
754+
<div class="ansibleOptionAnchor" id="return-"></div>
755+
<b>object_ownership</b>
756+
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
757+
<div style="font-size: small">
758+
<span style="color: purple">string</span>
759+
</div>
760+
</td>
761+
<td><em>state=present</em></td>
762+
<td>
763+
<div>S3 bucket&#x27;s ownership controls.</div>
764+
<br/>
765+
<div style="font-size: smaller"><b>Sample:</b></div>
766+
<div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">BucketOwnerPreferred</div>
767+
</td>
768+
</tr>
769+
<tr>
770+
<td colspan="1">
771+
<div class="ansibleOptionAnchor" id="return-"></div>
772+
<b>policy</b>
773+
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
774+
<div style="font-size: small">
775+
<span style="color: purple">dictionary</span>
776+
</div>
777+
</td>
778+
<td><em>state=present</em></td>
779+
<td>
780+
<div>S3 bucket&#x27;s policy.</div>
781+
<br/>
782+
<div style="font-size: smaller"><b>Sample:</b></div>
783+
<div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">{&#x27;Statement&#x27;: [{&#x27;Action&#x27;: &#x27;s3:GetObject&#x27;, &#x27;Effect&#x27;: &#x27;Allow&#x27;, &#x27;Principal&#x27;: &#x27;*&#x27;, &#x27;Resource&#x27;: &#x27;arn:aws:s3:::2d3ce10a8210d36d6b4d23b822892074complex/*&#x27;, &#x27;Sid&#x27;: &#x27;AddPerm&#x27;}], &#x27;Version&#x27;: &#x27;2012-10-17&#x27;}</div>
784+
</td>
785+
</tr>
786+
<tr>
787+
<td colspan="1">
788+
<div class="ansibleOptionAnchor" id="return-"></div>
789+
<b>requester_pays</b>
790+
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
791+
<div style="font-size: small">
792+
<span style="color: purple">string</span>
793+
</div>
794+
</td>
795+
<td><em>state=present</em></td>
796+
<td>
797+
<div>Indicates that the requester was successfully charged for the request.</div>
798+
<br/>
799+
</td>
800+
</tr>
801+
<tr>
802+
<td colspan="1">
803+
<div class="ansibleOptionAnchor" id="return-"></div>
804+
<b>tags</b>
805+
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
806+
<div style="font-size: small">
807+
<span style="color: purple">dictionary</span>
808+
</div>
809+
</td>
810+
<td><em>state=present</em></td>
811+
<td>
812+
<div>S3 bucket&#x27;s tags.</div>
813+
<br/>
814+
<div style="font-size: smaller"><b>Sample:</b></div>
815+
<div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">{&#x27;Tag1&#x27;: &#x27;tag1&#x27;, &#x27;Tag2&#x27;: &#x27;tag2&#x27;}</div>
816+
</td>
817+
</tr>
818+
<tr>
819+
<td colspan="1">
820+
<div class="ansibleOptionAnchor" id="return-"></div>
821+
<b>versioning</b>
822+
<a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
823+
<div style="font-size: small">
824+
<span style="color: purple">dictionary</span>
825+
</div>
826+
</td>
827+
<td><em>state=present</em></td>
828+
<td>
829+
<div>S3 bucket&#x27;s versioning configuration.</div>
830+
<br/>
831+
<div style="font-size: smaller"><b>Sample:</b></div>
832+
<div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">{&#x27;MfaDelete&#x27;: &#x27;Disabled&#x27;, &#x27;Versioning&#x27;: &#x27;Enabled&#x27;}</div>
833+
</td>
834+
</tr>
835+
</table>
836+
<br/><br/>
837+
708838

709839
Status
710840
------

‎galaxy.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
namespace: amazon
22
name: aws
3-
version: 2.1.0
3+
version: 2.2.0
44
readme: README.md
55
authors:
66
- Ansible (https://github.com/ansible)

0 commit comments

Comments
 (0)