Ansible-3.0.0 released

1,161 views
Skip to first unread message

Toshio Kuratomi

unread,
Feb 18, 2021, 11:07:56 AM2/18/21
to ansible-devel, ansible...@googlegroups.com, ansible-...@googlegroups.com
Hi all,

We're happy to announce that the ansible-3.0.0 package is now
available! This update is based on the ansible-base-2.10.x package
just like ansible-2.10 was so the changes shouldn't be too major.
However, it does contain new major versions of many collections which
means that there will be some backwards incompatible changes in the
modules and plugins.

If you would like to learn about how and why we got to version 3.0.0,
we invite you to visit our blog for the background as well as a Q&A:

- https://www.ansible.com/blog/announcing-the-community-ansible-3.0.0-package
- https://www.ansible.com/blog/ansible-3.0.0-qa

How to get it
-------------

Due to a limitation in pip, if you are upgrading from Ansible 2.9 (or
earlier), you need to uninstall ansible before installing the 3.0.0
version:

```
$ pip uninstall ansible
$ pip install ansible==3.0.0 --user
```

The tar.gz of the release can be found here:

* Ansible 3.0.0:
https://pypi.python.org/packages/source/a/ansible/ansible-3.0.0.tar.gz
SHA256: 843aa807813318b0c8a6684a2895c74a4ccfb3c01d2bb41a53856b2434ebaaec

What's new in Ansible 3.0.0
---------------------------

* The Ansible package has moved to semantic versioning
(https://semver.org/). This standard allows you to tell if a new
version of Ansible contains incompatibilities by looking at the
version number. Read the semver specification for more information.

* The `cisco.nxos`, `community.crypto`, `community.docker`,
`community.general`, `community.network`, and `community.sops`
collections had multiple modules updated to specify that the
parameters should not be logged as they could contain secret
information. Collectively, these problems are listed in the Common
Vulnerabilities database as CVE-2021-20191, CVE-2020-25646,
CVE-2021-20180, and CVE-2021-20178

* Collections which have opted into being a part of the Ansible-3.0.0
unified changelog will have an entry on this page:
https://github.com/ansible-community/ansible-build-data/blob/main/3/CHANGELOG-v3.rst

* For collections which have not opted into the unified changelog,
consult the list of included collections in the link below and check
their entry on https://galaxy.ansible.com for information about their
changes.
* https://github.com/ansible-community/ansible-build-data/blob/main/3/ansible-3.0.0.deps

* You can find more information for those on
https://galaxy.ansible.com/. For instance, the community.crypto
collection listed in the ansible-3.0.0.deps file has a galaxy page at
https://galaxy.ansible.com/community/crypto/

* Changelog for ansible-base-2.10.5 which this release of ansible
installs: https://github.com/ansible/ansible/blob/stable-2.10/changelogs/CHANGELOG-v2.10.rst

What's the schedule for new Ansible releases after 3.0.0?
---------------------------------------------------------

* Except for ansible-2.9.x, older versions of ansible are not seeing
maintenance releases. If there is a desire for maintenance releases
of older versions, drop by a Community Working Group Meeting to
discuss how you can help. (
https://github.com/ansible/community/tree/main/meetings#wednesdays )

* Minor releases of ansible-3.0.0 will be released approximately every
three weeks. Since we're now using semantic versioning, these new
releases will be 3.1.0, 3.2.0, etc. They will contain bugfixes and
new features but no backwards incompatibilities.

* We're currently planning to release Ansible-4.0.0 in the middle of
May, roughly a month after Ansible-core-2.11 releases. See the
Ansible 4 Roadmap for details:
https://docs.ansible.com/ansible/devel/roadmap/COLLECTIONS_4.html

Porting Help
-------------

There's a unified porting guide for collections which have opted-in.
You can find that at:
https://github.com/ansible/ansible/blob/devel/docs/docsite/rst/porting_guides/porting_guide_3.rst


Thanks!
-Toshio

Reply all
Reply to author
Forward
0 new messages