Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add Versions section #1784

Merged
merged 7 commits into from
Jun 6, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
66 changes: 41 additions & 25 deletions linkerd.io/content/releases/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,51 +4,67 @@ aliases = [ "edge" ]
weight = 18
+++

Releases of Linkerd are available in several different forms.
Linkerd publishes and announces *versions* that correspond to specific project
milestones and sets of new features. These versions are available in different
types of *release artifacts*.

## Stable releases
## Recent versions

Stable release artifacts of Linkerd follow semantic versioning, whereby changes
in major version denote large feature additions and possible breaking changes
and changes in minor versions denote safe upgrades without breaking changes.
### Linkerd 2.15

Linkerd 2.15 was announced on February 21, 2024.

As of February 2024, Linkerd no longer provides stable release artifacts in the
open source project itself. Instead, the vendor community around Linkerd is
responsible for creating stable release artifacts. Known distributions of
Linkerd with stable release artifacts include:
- **Announcement**: [Announcing Linkerd 2.15 with mesh expansion, native
sidecars, and SPIFFE](/2024/02/21/announcing-linkerd-2.15/)
- **Code tag**:
[version-2.15](https://github.com/linkerd/linkerd2/releases/tag/version-2.15)
- **Corresponding edge release**: [edge-24.2.4](https://github.com/linkerd/linkerd2/releases/tag/edge-24.2.4)

- [Buoyant Enterprise for Linkerd](https://docs.buoyant.io/buoyant-enterprise-linkerd)
from Buoyant, creators of Linkerd.
Latest version: **enterprise-2.15.3**
[[release notes](https://docs.buoyant.io/release-notes/buoyant-enterprise-linkerd/enterprise-2.15.3/)].
Known distributions of Linkerd 2.15:

## Edge releases
- [Buoyant Enterprise for
Linkerd](https://docs.buoyant.io/buoyant-enterprise-linkerd) from Buoyant,
creators of Linkerd. Latest version: **enterprise-2.15.3** ([release
notes](https://docs.buoyant.io/release-notes/buoyant-enterprise-linkerd/enterprise-2.15.3/)).

## Types of release artifacts

### Edge releases

<!-- markdownlint-disable MD034 -->
Edge release artifacts are published on a weekly or near-weekly basis as part of
the open source project. The full list of edge release artifacts can be found on
[the Linkerd GitHub releases
page](https://github.com/linkerd/linkerd2/releases).
the open source project. The latest edge release is [{{% latestedge
%}}](https://github.com/linkerd/linkerd2/releases/tag/{{% latestedge %}}).
and the full list of edge release artifacts can be found on [the Linkerd GitHub
releases page](https://github.com/linkerd/linkerd2/releases).

Edge release artifacts contain the code in from the _main_ branch at the point
in time when they were cut. This means they always have the latest features and
fixes, and have undergone automated testing as well as maintianer code review.
fixes, and have undergone automated testing as well as maintainer code review.
Edge releases may involve partial features that are later modified or backed
out. They may also involve breaking changes—of course, we do our best to avoid
this.

Edge releases are generally considered *production ready*, and the project will
mark specific releases as "not recommended" if bugs are discovered after
release.

Edge release versioning follows the form `edge-y.m.n`, where `y` is the last two
digits of the year, `m` is the numeric month, and `n` is numeric edge release
count for that month. For example:

- `edge-23.9.1`: the first edge release shipped in September 2023
- `edge-24.1.3`: the third edge release shipped in January 2024
count for that month. For example, `edge-24.1.3` is the third edge release
shipped in January 2024.

Using edge release artifacts and reporting bugs helps us ensure a rapid pace of
development and is a great way to help Linkerd. We publish edge release guidance
as part of the release notes and strive to always provide production-ready
artifacts.

<!-- markdownlint-disable MD034 -->
### Stable releases

Stable release artifacts of Linkerd follow semantic versioning, whereby changes
in major version denote large feature additions and possible breaking changes
and changes in minor versions denote safe upgrades without breaking changes.

Latest version: **{{% latestedge %}}** [[release
notes](https://github.com/linkerd/linkerd2/releases/tag/{{% latestedge %}})].
As of February 2024, the Linkerd open source project itself no longer provides
stable release artifacts. Instead, the vendor community around Linkerd is
responsible for creating stable release artifacts.
Loading