Releases — Ansible Documentation

- AnsibleFest
- Products
- Community
- Webinars & Training
- Blog

Documentation

# Releases

Topics

- Support for older releases
- Release schedule
- Release methods
- Release feature freeze

## Support for older releases

Ansible supports the two most recent major, stable releases. Security- and bug-related fixes may be implemented in older versions, but this support is not guaranteed.

If you are on a release older than the last two major, stable releases, please see our Porting Guide.

## Release schedule

Ansible is on a ‘flexible’ 4 month release schedule. Sometimes the release cycle can be extended if there is a major change that requires more time (for example, a core rewrite). Recently the main Ansible repo merged the separated ansible-modules-core and ansible-modules-extras repos, as such modules get released at the same time as the main Ansible repo.

The major features and bugs fixed in a release should be reflected in the CHANGELOG.md. Minor features and bug fixes will be shown in the commit history. For example, issue #19057 is reflected only in the commit history. When a fix orfeature gets added to the devel branch it will be part of the next release. Some bugfixes can be backported to previous releases and will be part of a minor point release if such a release is deemed necessary.

Sometimes a release candidate can be extended by a few days if a bug fix makes a change that can have far-reaching consequences, so users have enough time to find any new issues that may stem from this.

## Release methods

Ansible normally goes through a ‘release candidate’, issuing an RC1 for a release. If no major bugs are discovered in the release candidate after 5 business days, we’ll get a final release. Otherwise, fixes will be applied and an RC2 will be provided for testing. If no bugs are discovered in RC2 after 2 days, the final release will be made, iterating this last step and incrementing the candidate number as we find major bugs.

## Release feature freeze

During the release candidate process, the focus will be on bugfixes that affect the RC, new features will be delayed while we try to produce a final version. Some bugfixes that are minor or don’t affect the RC will also be postponed until after the release is finalized.

See also

Python API
  Python API to Playbooks and Ad Hoc Task Execution
Developing Modules
  How to develop modules
Developing Plugins
  How to develop plugins
Ansible Tower
  REST API endpoint and GUI for Ansible, syncs with dynamic inventory
Development Mailing List
  Mailing list for development topics
irc.freenode.net
  #ansible IRC chat channel