Skip to main content

Supported Releases

This page lists the status, timeline and policies for currently supported releases.

info

TL;DR

Each release is supported for a period of six months, and we create a new release every three months.

Update in 2024-02-01:

As we currently haven't had enough maintainers to support the release cycle, We will release new versions from time to time, with a cycle of about 6 months.

Naming Scheme

Our naming scheme mostly follows Semantic Versioning 2.0.0 with v prepended to git tags and docker images:

v<major>.<minor>.<patch>

where <minor> is increased for each release, and <patch> counts the number of patches for the current <minor> release. A patch is usually a small change relative to the <minor> release.

Support Status of Chaos Mesh

note

Support for Kubernetes 1.22 is available starting with version 2.0.4.

info

The 2.6 version also theoretically works fine on the 1.26, 1.27, and 1.28 versions of Kubernetes, but we do not sync the E2E tests for these versions.

VersionCurrently SupportedRelease DateEnd of LifeSupported Kubernetes versions
masterNo, development only--1.26, 1.27, 1.28
2.6    Yes                May 31, 2023-          1.20, 1.21, 1.22, 1.23, 1.24, 1.25, 1.26, 1.27, 1.28
2.5    Yes                Nov 22, 2022-          1.20, 1.21, 1.22, 1.23, 1.24, 1.25
2.4    No                Sep 23, 2022May 31, 20231.20, 1.21, 1.22, 1.23, 1.24, 1.25
2.3NoJul 29, 2022Nov 22, 20221.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22
2.2NoApr 29, 2022Sep 23, 20221.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22
2.1NoNov 30, 2021Jul 29, 20221.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22
2.0NoJul 23, 2021Apr 29, 20221.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.21, 1.22
1.2NoApr 23, 2021Nov 30, 20211.12, 1.13, 1.14, 1.15
1.1NoJan 08, 2021Jul 23, 20211.12, 1.13, 1.14, 1.15
1.0NoSep 25, 2020Apr 23, 20211.12, 1.13, 1.14, 1.15

Upcoming Releases

You could track the upcoming release on GitHub milestones.

Support Policies

Our support window is six months for each release branch. The support window corresponds to the two latest releases, given that we produce a new final release every three months.

For this we offer two type of supports:

Community technical support

You can request support from the community on CNCF Slack (in the #project-chaos-mesh channel), or using the GitHub Discussions.

Security and bug fixes

Security issues are fixed as soon as possible. They get back-ported to the last two releases, and a new patch release is immediately created for them.

For enhancements or bugfixes, we would make a new patch release as required.

How we determine supported Kubernetes versions

After testing the compatibility of various versions of Kubernetes clusters through E2E testing, the Chaos Mesh team determines Supported Status of Chaos Mesh based on its test results.

Below are Kubernetes versions covered by each version of the E2E tests:

VersionTested kubernetes Versions
master1.26.13, 1.27.10, 1.28.6
2.61.20.15, 1.23.4, 1.25.1
2.51.20, 1.23, 1.25
2.41.20, 1.23, 1.25