.. meta::
   :description: Read release notes, discover new modules, features and bug fixes.


Release notes
=============

Release 0.9.0 -- Release the Matrix
---------------------------------------

This release brings two new modules and validates support for Ansible versions up to 2.13.

**New features:**

* New module - ``ec2_object``.
* New module - ``ec2_object_info``.
* Version support matrix - we now support a matrix of Ansible/Ansible Core and Python versions. See below for more info.
* ``s3_bucket`` now validates bucket names.
* ``s3_bucket`` can now recursively delete its child objects.
* ``ec2_instance`` can now infer the instance tenancy from the VPC in the module output.

**Bug fixes:**

* ``ec2_network_interface`` now only considers an attachment mandatory when creating or modifying an interface.
* Default values for monitoring and on_instance_initiated_shutdown in ``ec2_instance`` are removed so they do not cause unintended changes.

**Misc**

* Documentation rendering has been improved.
* Code quality updates for developer sanity.

**New version compatibility matrix**

The following combinations of Ansible and Python have been validated through sanity, unit and integration tests.

+-------------+--------------+--------------------+--------------------+--------------------+--------------------+
|             | ansible 2.9  | ansible-base 2.10  | ansible-core 2.11  | ansible-core 2.12  | ansible-core 2.13  |
+=============+==============+====================+====================+====================+====================+
| Python 2.7  | supported    | supported          |                    |                    |                    |
+-------------+--------------+--------------------+--------------------+--------------------+--------------------+
| Python 3.6  | supported    |                    | supported          |                    |                    |
+-------------+--------------+--------------------+--------------------+--------------------+--------------------+
| Python 3.7  | supported    | supported          | supported          |                    |                    |
+-------------+--------------+--------------------+--------------------+--------------------+--------------------+
| Python 3.8  | supported    | supported          | supported          | supported          | supported          |
+-------------+--------------+--------------------+--------------------+--------------------+--------------------+
| Python 3.9  |              | supported          | supported          | supported          | supported          |
+-------------+--------------+--------------------+--------------------+--------------------+--------------------+
| Python 3.10 |              |                    |                    | supported          | supported          |
+-------------+--------------+--------------------+--------------------+--------------------+--------------------+


Release 0.8.4 -- Expanding the horizons
---------------------------------------

This release brings three new modules and expands authentication options
for all plugins in the collection.

And because we would love your feedback, we've set up an
`issue tracker repository on GitHub`_ for the collection. Help us improve by
letting us know if you have any problems using the collection or any ideas for
making it better!

**New features:**

* It is now possible to authenticate with AWS CLI profiles via a new
  ``auth.profile`` parameter.
* New module - ``ec2_volume``.
* New module - ``ec2_volume_info``.
* New module - ``s3_bucket_info``.

**Bug fixes:**

* ``ec2_security_group`` now ignores ICMP type/code parameters instead of
  failing when they are provided with non-ICMP protocols.

**Misc**

* You can now submit a bug report or a feature request at our
  `issue tracker repository on GitHub`_.

.. _issue tracker repository on GitHub: https://github.com/xlab-si/steampunk.aws


Release 0.8.3 -- Enterprise & more
----------------------------------

This release contains the first Enterprise feature of the AWS Ansible
Collection - the EC2 inventory plugin.

**New features:**

* *[Enterprise only]* Inventory plugin ``steampunk.aws.ec2``.
* Support for handling tags in ``ec2_vpc_address`` and ``s3_bucket`` via
  *tags* and *clear_tags* parameters.
* Improved validation checks related to attachments of network interfaces
  to instances in ``ec2_network_interface``.

**Bug fixes:**

* Ignore invalid/non-existing *ips* instead of failing in ``ec2_vpc_address_info``.
* Fail gracefully when trying to create a bucket with a name that is already
  taken in ``s3_bucket``.
* Fixed the logic for choosing the next available device index in
  ``ec2_network_interface``.