# Versions, Platforms, and Deprecation

Buoyant provides formal support commitments for BEL releases to our customers.
This page describes types and scope of those commitments.

## Release channels

Buoyant provides two release channels for BEL releases: _stable_ and _preview_.

**Stable releases** (e.g. `enterprise-2.20.6`) are intended for
production use. Stable releases strict "semantic versioning" guarantees that
provide explicit control over the level of risk introduced by upgrades. (See
below.)

**Preview releases** (e.g. `preview-26.5.2`) are not intended for production use
and may not provide the same set of functionality or guarantees as enterprise
releases. Preview releases are not stable releases and do not follow semantic
versioning. You generally should not use preview releases unless explicitly
instructed by Buoyant support personnel.

## Stable release versions

### Semantic versioning

BEL stable release version numbers follow the form
`enterprise-2.<major>.<minor>`. In other words, `2` is a static prefix, followed
by the major version, then the minor. For example, `enterprise-2.20.0` denotes a
stable release with major version 20, minor version 0.

Changes in version number have the following implications:

- **Major version changes** will typically introduce large new features, and
  _may_ introduce breaking changes if necessary.
- **Minor version changes** are intended to be backwards compatible with the
  previous minor version and will not introduce breaking changes. These releases
  will primary provide bugfixes, and will rarely introduce new features unless
  they are exceedingly low risk.

For example:

- `enterprise-2.19.0` to `enterprise-2.19.1`: minor version upgrade. Should not
  introduce breaking changes.
- `enterprise-2.19.1` to `enterprise-2.20.0`: major version upgrade. May
  introduce breaking changes that require action on your part; see release notes
  for details.

### Hotpatch versions

For versions of BEL prior to 2.19, we occasionally published _hotpatch
releases_. These releases were marked with an additional patch level suffix. For
example:

- `enterprise-2.18.0-0`: major version 18, minor version 0, no hotpatch
- `enterprise-2.18.0-1`: major version 18, minor version 0, hotpatch 1

In BEL 2.19 and beyond, we have consolidated hotpatch releases into minor
releases.

## Support and deprecation

Buoyant provides four levels of support for BEL releases: Active, Maintenance,
EOL, and Archived. Each level provides different guarantees.

### Support levels

| State       | On-call support | CVE releases | Bugfix releases |
| ----------- | --------------- | ------------ | --------------- |
| Active      | **Yes**         | **Yes**      | **Yes**         |
| Maintenance | **Yes**         | **Yes**      | No              |
| EOL         | **Yes**         | No           | No              |
| Archived    | No              | No           | No              |

_Bugfix releases_: These are non-breaking, minor version releases that provide
bugfixes, security fixes, or introduce new minor features.

_CVE releases_: These are hygienic releases that address CVEs found in
dependencies. These do not represent known security vulnerabilities in Linkerd,
but are designed to ease compliance with automated security scanners. These may
take the form of minor version releases or (for versions of BEL prior to 2.19)
hotpatch releases.

_On-call support_: This is support with response time SLAs. Note that this is
only available on some plans; see
[Plans and Pricing](https://buoyant.io/pricing/) for details.

### Bugfix policy

Buoyant typically maintains multiple simultaneous active releases. While we make
every effort to backport bugfixes to all active versions, sometimes the cost
this is prohibitive. Thus, our bugfix policy for Active support versions is
two-pronged:

- For the most recent major version, we will provide bugfixes in the form of
  minor version releases.
- For versions under active support that are _not_ the most recent major
  version, we will provide backports if at all possible, but may exclude certain
  bugfixes if the cost is prohibitive.

### Support lifetimes

| BEL version | Release date | Active | Maintenance | EOL | Archived |
| - | - | - | - | - | - |
| 2.14 | Aug 8, 2023 | -- | -- | -- | **Current** |
| 2.15 | Feb 21, 2024 | -- | -- | -- | **Current** |
| 2.16 | Aug 13, 2024 | -- | -- | -- | **Current** |
| 2.17 | Dec 5, 2024 | -- | -- | **Current** | Dec 5, 2026 |
| 2.18 | Apr 28, 2025 | -- | -- | **Current** | Apr 28, 2027 |
| 2.19 | Oct 31, 2025 | -- | **Current** | May 1, 2027 | Oct 31, 2027 |
| 2.20 | Jun 23, 2026 | **Current** | Jun 23, 2027 | Dec 23, 2027 | Jun 23, 2028 |

## Supported Kubernetes versions

The officially supported Kubernetes versions for BEL releases are as follows:

| BEL version | Minimum Kubernetes Version | Maximum Kubernetes Version |
| - | - | - |
| 2.14 | 1.21 | 1.28 |
| 2.15 | 1.22 | 1.31 |
| 2.16 | 1.22 | 1.31 |
| 2.17 | 1.22 | 1.32 |
| 2.18 | 1.22 | 1.32 |
| 2.19 | 1.29 | 1.37 |
| 2.20 | 1.31 | 1.37 |

## Gateway API compatibility

The compatible Gateway API for Linkerd versions are as follows:

| Linkerd version | Gateway API version compatibility |
| - | - |
| 2.15 – 2.17 | 0.7 – 1.1.1 |
| 2.18 – 2.19 | 1.1.1 – 1.2.1 |
| 2.20 | 1.2.1 – 1.5.1 |

## Tested Kubernetes platforms

BEL should work on any relatively modern Kubernetes distribution. We actively
test the latest release of BEL against specific platforms and environments.

Tested platforms for **BEL enterprise-2.20.6** include:

| Provider/Distribution | Platform Details                          | Test status                                |
| --------------------- | ----------------------------------------- | ------------------------------------------ |
| Amazon EKS            | 1.36 (m6i.xlarge, cilium)                 | ✅ |
| Amazon EKS            | 1.36 (m7g.xlarge, linux/arm64)            | ✅ |
| Google GKE            | 1.36 (n2-standard-4)                      | ✅ |
| Microsoft Azure AKS   | 1.36 (Standard_B4ms)                      | ✅ |
| Microsoft Azure AKS   | 1.36.2 (Standard_E8s_v6, Standard_D8s_v5) | ✅ |
| Microsoft Azure AKS   | 1.36.3 (Standard_D4s_v5)                  | ✅ |
| Oracle OKE            | 1.35.2 (VM.Standard2.8)                   | ✅ |
| Rancher RKE2          | 1.35.7 (r1.xlarge)                        | ✅ |
| Red Hat OpenShift     | 4.22.0-okd (r1.xlarge)                    | ✅ |
