3.4.0

Latest release in branch 3
Released 4 years ago (May 13, 2021)

Software Ansible
Branch 3
Status
End of life
End of life May 11, 2021
First official release version 3.0.0
First official release date 5 years ago (February 18, 2021)
Environment
requirements
ansible-core: 2.10
Control Py: 2.7 / 3.5 - 3.9
Target Py: 2.6 - 2.7 / 3.5 - 3.9
PowerShell: 3 - 5.1
Release notes https://github.com/ansible-community/ansible-build-data/blob/main/3/CHANGELOG-v3.rst
Source code https://github.com/ansible-community/ansible-build-data
Documentation https://docs.ansible.com/ansible/latest/index.html
Download https://pypi.org/project/ansible/#history
Ansible 3 Releases View full list

What Is New in Ansible 3

Ansible 3 is a maintenance release focusing on stability, bug fixes, and key updates to its underlying components. It primarily bundles the latest Ansible Core 2.12 release and other collection updates to provide a more reliable automation experience.

Category Description
Ansible Core Includes Ansible Core 2.12.6, which contains numerous bug fixes and minor improvements.
Ansible Runner Updated to version 2.3.1, enhancing the environment and process management for running playbooks.
Included Collections Pins updated versions of key collections like amazon.aws, google.cloud, and ansible.windows for compatibility.
Python Support Maintains support for Python 3.8 and 3.9, ensuring stability for existing environments.
Bug Fixes Addresses various issues from previous versions, improving overall reliability and user experience.

What's the big deal with the bundled Ansible Core 2.12?

The core of this release is the integration of Ansible Core 2.12.6. This isn't about flashy new features; it's about solidifying the foundation. The update backports critical fixes that improve module reliability and playbook execution consistency.

In practice, this means fewer unexpected failures during inventory parsing or variable resolution. The focus is on smoothing out the rough edges from the previous major release, making your automation runs more predictable.

How have the core component updates changed?

Ansible Runner 2.3.1 is a key under-the-hood upgrade. It handles the low-level execution of Ansible playbooks, and this version improves process isolation and artifact handling. This matters because it directly impacts the stability of runs, especially in containerized or CI/CD environments.

The component versions are now pinned to specific releases. This eliminates the "moving target" problem you might have faced with constantly updating dependencies, guaranteeing a known-good configuration.

Which collection versions are included and why does it matter?

This release locks in tested versions of major collections. You get a stable set of modules for cloud platforms like AWS (amazon.aws) and GCP (google.cloud), as well as for Windows management (ansible.windows).

This approach ensures that the entire package--core, runner, and collections--has been tested together. You avoid the common headache of a core update breaking a module from a separately updated collection, which is a significant win for production stability.

Is my existing Python environment still supported?

Yes, Ansible 3 continues full support for Python 3.8 and 3.9. There's no forced migration to a newer Python version in this release. This is a maintenance update, not a platform shift.

For engineers, this means you can deploy Ansible 3 into your existing automation infrastructure without needing to rebuild your Python environments, which simplifies the upgrade path considerably.

FAQ

Is Ansible 3 a major feature release?
No. Think of it as a stabilization release. It bundles the latest bug-fix versions of Ansible Core and key collections to provide a more reliable and tested package than the initial Ansible 2.10 release.

Should I upgrade from Ansible 2.9 directly to Ansible 3?
If you're on 2.9, you should review the changes in Ansible 2.10/2.11 first, as the collections migration is the biggest shift. Upgrading to 3 is recommended if you are already on the 2.10+ track and want the latest stable set of fixes.

Does this release add support for Python 3.10?
No, Ansible 3 maintains the same Python support as its predecessors (3.8 and 3.9). Support for newer Python versions would be introduced in a future major release of Ansible Core.

What is the most important reason to upgrade?
The bundled bug fixes. If you've encountered specific module failures or quirks in your playbooks that were logged as fixed in Ansible Core 2.12.x, then upgrading to Ansible 3 is the easiest way to get those fixes in a pre-tested package.

Are any modules deprecated in this release?
Ansible 3 itself doesn't introduce new deprecations. However, it includes collections that may have their own deprecation cycles. Always check the changelogs of the specific collections you use (e.g., amazon.aws) for details.

Releases In Branch 3

Version Release date
3.4.0 4 years ago
(May 13, 2021)
3.3.0 4 years ago
(April 21, 2021)
3.2.0 5 years ago
(March 30, 2021)
3.1.0 5 years ago
(March 11, 2021)
3.0.0 5 years ago
(February 18, 2021)
3.0.0rc1 5 years ago
(February 09, 2021)
3.0.0b1 5 years ago
(February 02, 2021)