In this release we promoted many community modules to Red Hat supported status. Those modules have been moved from the community.aws to amazon.aws collection. This release also brings some new features, bugfixes, breaking changes and deprecated features.
The amazon.aws collection has dropped support for botocore<1.21.0
and boto3<1.18.0
. Support for ansible-core<2.11
has also been dropped.
Major Changes
- autoscaling_group - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.autoscaling_group
. - autoscaling_group_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 useamazon.aws.autoscaling_group_info
. - cloudtrail - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.cloudtrail
. - cloudwatch_metric_alarm - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.cloudwatch_metric_alarm
. - cloudwatchevent_rule - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.cloudwatchevent_rule
. - cloudwatchlogs_log_group - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.cloudwatchlogs_log_group
. - cloudwatchlogs_log_group_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 useamazon.aws.cloudwatchlogs_log_group_info
. - cloudwatchlogs_log_group_metric_filter - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.cloudwatchlogs_log_group_metric_filter
. - ec2_eip - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.ec2_eip
. - ec2_eip_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 useamazon.aws.ec2_eip_info
. - elb_application_lb - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.elb_application_lb
. - elb_application_lb_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 useamazon.aws.elb_application_lb_info
. - execute_lambda - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.execute_lambda
. - iam_policy - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.iam_policy
. - iam_policy_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 useamazon.aws.iam_policy_info
. - iam_user - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.iam_user
. - iam_user_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 useamazon.aws.iam_user_info
. - kms_key - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.kms_key
. - kms_key_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 useamazon.aws.kms_key_info
. - lambda - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.lambda
. - lambda_alias - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.lambda_alias
. - lambda_event - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.lambda_event
. - lambda_execute - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.lambda_execute
. - lambda_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 useamazon.aws.lambda_info
. - lambda_policy - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.lambda_policy
. - rds_cluster - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.rds_cluster
. - rds_cluster_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 useamazon.aws.rds_cluster_info
. - rds_cluster_snapshot - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.rds_cluster_snapshot
. - rds_instance - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.rds_instance
. - rds_instance_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 useamazon.aws.rds_instance_info
. - rds_instance_snapshot - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.rds_instance_snapshot
. - rds_option_group - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.rds_option_group
. - rds_option_group_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 useamazon.aws.rds_option_group_info
. - rds_param_group - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.rds_param_group
. - rds_snapshot_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 useamazon.aws.rds_snapshot_info
. - rds_subnet_group - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.rds_subnet_group
. - route53 - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.route53
. - route53_health_check - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.route53_health_check
. - route53_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 useamazon.aws.route53_info
. - route53_zone - The module has been migrated from the
community.aws
collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to useamazon.aws.route53_zone
.
Minor Changes
- Ability to record and replay the API interaction of a module for testing purpose. Show case the feature with an example (#998).
- Remove the empty init.py file from the distribution, they were not required anymore (#1018).
- amazon.aws modules - the
ec2_url
parameter has been renamed toendpoint_url
for consistency,ec2_url
remains as an alias (#992). - aws_caller_info - minor linting fixes (#968).
- aws_ec2 - introduce the
allow_duplicated_hosts
configuration key (#1026). - cloudformation - avoid catching
Exception
, catch more specific errors instead (#968). - cloudwatch_metric_alarm_info - Added a new module that describes the cloudwatch metric alarms (#988).
- ec2_group - The
ec2_group
module has been renamed toec2_security_group
,ec2_group
remains as an alias (#897). - ec2_group_info - The
ec2_group_info
module has been renamed toec2_security_group_info
,ec2_group_info
remains as an alias (#897). - ec2_instance - Add hibernation_options and volumes->ebs->encrypted keys to support stop-hibernate instance (#972).
- ec2_instance - expanded the use of the automatic retries to
InsuffienctInstanceCapacity
(#1038). - ec2_metadata_facts - avoid catching
Exception
, catch more specific errors instead (#968). - ec2_security_group - minor linting fixes (#968).
- ec2_vpc_endpoint - avoid catching
Exception
, catch more specific errors instead (#968). - ec2_vpc_nat_gateway - minor linting fixes (#968).
- ec2_vpc_net_info - handle classic link check for shared VPCs by throwing a warning instead of an error (#984).
- module_utils/acm - Move to jittered backoff (#946).
- module_utils/elbv2 - ensures that
ip_address_type
is set on creation rather than re-setting it after creation (#940). - module_utils/elbv2 - uses new waiters with retries for temporary failures (#940).
- module_utils/waf - Move to jittered backoff (#946).
- module_utils/waiters - Add waiters to manage eks_nodegroup module (ansible-collections/community.aws#1415).
- s3_bucket -
rgw
was added as an alias for theceph
parameter for consistency with thes3_object
module (#994). - s3_bucket - the
s3_url
parameter was merged into theendpoint_url
parameter,s3_url
remains as an alias (#994). - s3_object - added the
sig_v4
paramater, enbling the user to opt in to signature version 4 for download/get operations. (#1014) - s3_object - minor linting fixes (#968).
- s3_object - the
rgw
parameter was renamed toceph
for consistency with thes3_bucket
module,rgw
remains as an alias (#994). - s3_object - the
s3_url
parameter was merged into theendpoint_url
parameter,s3_url
remains as an alias (#994). - s3_object - updated module to add support for handling file upload to a bucket with ACL disabled (#921).
- s3_object_info - Added a new module that describes S3 Objects (#977).
Breaking Changes / Porting Guide
- amazon.aws collection - Support for ansible-core < 2.11 has been dropped (#1087).
- amazon.aws collection - The amazon.aws collection has dropped support for
botocore<1.21.0
andboto3<1.18.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 (#934). - doc_fragments - remove minimum collection requirements from doc_fragments/aws.py and allow pulling those from doc_fragments/aws_boto3.py instead (#985).
- ec2_ami - the default value for
purge_tags
has been changed fromFalse
toTrue
(#916). - ec2_ami - the parameter aliases
DeviceName
,VirtualName
andNoDevice
were previously deprecated and have been removed, please usedevice_name
,virtual_name
andno_device
instead (#913). - ec2_eni_info - the mutual exclusivity of the
eni_id
andfilters
parameters is now enforced, previouslyfilters
would be ignored ifeni_id
was set (#954). - ec2_instance - the default value for
purge_tags
has been changed fromFalse
toTrue
(#916). - ec2_key - the default value for
purge_tags
has been changed fromFalse
toTrue
(#916). - ec2_vol - the default value for
purge_tags
has been changed fromFalse
toTrue
(#916). - ec2_vpc_dhcp_option_info - the parameter aliases
DhcpOptionIds
andDryRun
were previously deprecated and have been removed, please usedhcp_options_ids
andno_device
instead (#913). - ec2_vpc_endpoint - the default value for
purge_tags
has been changed fromFalse
toTrue
(#916). - ec2_vpc_net - the default value for
purge_tags
has been changed fromFalse
toTrue
(#916). - ec2_vpc_route_table - the default value for
purge_tags
has been changed fromFalse
toTrue
(#916). - s3_bucket - the previously deprecated alias
S3_URL
for thes3_url
parameter has been removed. Playbooks shuold be updated to uses3_url
(#908). - s3_object - the previously deprecated alias
S3_URL
for thes3_url
parameter has been removed. Playbooks should be updated to uses3_url
(#908).
Deprecated Features
- amazon.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 has been deprecated and will be removed in a release after 2023-05-31 (#935).
- inventory/aws_ec2 - the
include_extra_api_calls
is now deprecated, its value is silently ignored (#1097).
Bugfixes
- aws_ec2 - address a regression introduced in 4.1.0 (#862) that cause the presnse of duplicated hosts in the inventory.
- cloudtrail - Fix key error TagList to TagsList (#1088).
- ec2_instance - Only show the deprecation warning for the default value of
instance_type
whencount
orexact_count
are specified (https://github.com//issues/980). - ec2_metadata_facts - fix
'NoneType' object is not callable
exception when using Ansible 2.13+ (#942). - module_utils/botocore - fix
object has no attribute 'fail'
error in error handling (#1045). - module_utils/elbv2 - fixes
KeyError
when usingUseExistingClientSecret
rather thanClientSecret
(#940). - module_utils/elbv2 - improvements to idempotency when comparing listeners (ansible-collections/community.aws#604).
- s3_object - also use
ignore_nonexistent_bucket
when listing a bucket (#966).
New Modules
- cloudtrail_info - Gather information about trails in AWS Cloud Trail.
- cloudwatch_metric_alarm_info - Gather information about the alarms for the specified metric
- s3_object_info - Gather information about objects in S3