ansible/docs/docsite/rst/roadmap/COLLECTIONS_4.rst

Ansible project 4.0

This release schedule includes dates for the ansible package, with a few dates for the ansible-core package as well. All dates are subject to change. See base_roadmap_2_11 for the most recent updates on ansible-core.

Release schedule

2021-01-26

New Collections will be reviewed for inclusion in Ansible 4.

2021-03-03

Ansible-4.0.0 alpha1 (biweekly ansible alphas. These are timed to coincide with the start of the ansible-core-2.11 pre-releases).

2021-03-16

Ansible-4.0.0 alpha2

2021-03-30

Ansible-4.0.0 alpha3

2021-04-13

Last day for new collections to be submitted for inclusion in Ansible 4. Note that collections MUST be reviewed and approved before being included. There is no guarantee that we will review every collection. The earlier your collection is submitted, the more likely it will be that your collection will be reviewed and the necessary feedback can be addressed in time for inclusion.

2021-04-13

Ansible-4.0.0 alpha4

2021-04-14

Community IRC Meeting topic: list any new collection reviews which block release. List any backwards incompatible collection releases that beta1 should try to accommodate.

2021-04-21

Community IRC Meeting topic: Decide what contingencies to activate for any blockers that do not meet the deadline.

2021-04-26

Last day for new collections to be reviewed and approved for inclusion in Ansible 4.

2021-04-26

Last day for collections to make backwards incompatible releases that will be accepted into Ansible 4.

2021-04-27

Ansible-4.0.0 beta1 -- feature freeze¹ (weekly beta releases. Collection owners and interested users should test for bugs).

2021-05-04

Ansible-4.0.0 beta2

2021-05-11

Ansible-4.0.0 rc1²³ (weekly release candidates as needed. Test and alert us to any blocker bugs).

2021-05-18

Ansible-4.0.0 release

2021-06-08

Release of Ansible-4.1.0 (bugfix + compatible features: every three weeks)

Note

Breaking changes will be introduced in Ansible 4.0.0, although we encourage the use of deprecation periods that will show up in at least one Ansible release before the breaking change happens, this is not guaranteed.

Ansible minor releases

Ansible 4.x minor releases will occur approximately every three weeks if changes to collections have been made or if it is deemed necessary to force an upgrade to a later ansible-core-2.11.x. Ansible 4.x minor releases may contain new features but not backwards incompatibilities. In practice, this means we will include new collection versions where either the patch or the minor version number has changed but not when the major number has changed. For example, if Ansible-4.0.0 ships with community-crypto-2.1.0; Ansible-4.1.0 may ship with community-crypto-2.2.0 but would not ship with community-crypto-3.0.0).

For more information, reach out on a mailing list or an IRC channel - see communication for more details.

---

1. No new modules or major features accepted after this date. In practice this means we will freeze the semver collection versions to compatible release versions. For example, if the version of community.crypto on this date was community-crypto-2.1.0; ansible-3.0.0 could ship with community-crypto-2.1.1. It would not ship with community-crypto-2.2.0.↩︎

2. After this date only changes blocking a release are accepted. Accepted changes require creating a new rc and may slip the final release date.↩︎

3. Collections will only be updated to a new version if a blocker is approved. Collection owners should discuss any blockers at a community IRC meeting (before this freeze) to decide whether to bump the version of the collection for a fix. See the Community IRC meeting agenda.↩︎