Skip to content

Update the Kubernetes versioning scheme #1066

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.

Sign up for GitHub

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

Merged
JakeSCahill merged 1 commit into from
Apr 8, 2025
Merged

Update the Kubernetes versioning scheme #1066

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
4 changes: 2 additions & 2 deletions antora.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,8 @@ asciidoc:
latest-console-tag: 'v2.8.5'
latest-release-commit: 'afe1a3f'
latest-operator-version: 'v2.3.8-24.3.6'
operator-beta-tag: 'v25.1-k8s1-beta1'
helm-beta-tag: 'v25.1-k8s1-beta1'
operator-beta-tag: 'v25.1.1-beta1'
helm-beta-tag: 'v25.1.1-beta1'
latest-redpanda-helm-chart-version: 5.10.1
redpanda-beta-version: '25.1.1-rc3'
redpanda-beta-tag: '25.1.1-rc3'
Expand Down
4 changes: 2 additions & 2 deletions modules/deploy/pages/deployment-option/self-hosted/kubernetes/k-25.1-beta.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ This beta version is available for testing and feedback. It is not supported by

Make sure that your Kubernetes cluster meets the xref:./k-requirements.adoc[requirements].

== Install Redpanda Operator v25.1-k8s1-beta1
== Install Redpanda Operator v25.1.1-beta1

The Redpanda Operator is namespace scoped. You must install the Redpanda Operator in the same namespace as your Redpanda resource (Redpanda cluster).

Expand Down Expand Up @@ -126,7 +126,7 @@ kubectl get pod --namespace <namespace>
If it's taking too long, see xref:manage:kubernetes/troubleshooting/k-troubleshoot.adoc[Troubleshooting].


== Install the Redpanda Helm chart v25.1-k8s1-beta1
== Install the Redpanda Helm chart v25.1.1-beta1

. Install cert-manager using Helm:
+
Expand Down
2 changes: 1 addition & 1 deletion modules/get-started/pages/release-notes/helm-charts.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ See also:
* xref:upgrade:k-compatibility.adoc[]
* xref:upgrade:k-rolling-upgrade.adoc[]

== Redpanda chart v25.1-k8s1-beta1
== Redpanda chart v25.1.1-beta1

link:https://github.com/redpanda-data/redpanda-operator/blob/release/v25.1.x/charts/redpanda/CHANGELOG.md[Changelog^].

Expand Down
2 changes: 1 addition & 1 deletion modules/get-started/pages/release-notes/operator.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ See also:
* xref:upgrade:k-compatibility.adoc[]
* xref:upgrade:k-rolling-upgrade.adoc[]

== Redpanda Operator v25.1-k8s1-beta1
== Redpanda Operator v25.1.1-beta1

link:https://github.com/redpanda-data/redpanda-operator/blob/release/v25.1.x/operator/CHANGELOG.md[Changelog^].

Expand Down
18 changes: 10 additions & 8 deletions modules/upgrade/pages/k-compatibility.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,15 @@ include::partial$versioning.adoc[]

The Redpanda Helm chart and Redpanda Operator are versioned and tested alongside specific Redpanda core releases, Kubernetes, and Helm.

Starting from version v25.1-k8s1-beta1, the Redpanda Operator and Redpanda Helm chart follow a new versioning scheme aligned with Redpanda core releases:
Starting from version v25.1.1-beta1, the Redpanda Operator and Redpanda Helm chart follow a new versioning scheme aligned with Redpanda core releases:

- `v25.1` refers to the Redpanda core feature release deployed by default.

- The suffix `-k8s<number>` denotes the Kubernetes-specific version, where `<number>` is the unique patch version for either the operator or Helm chart.
- The patch version denotes the patch version for either the operator or Helm chart. It is not the patch version of Redpanda core.

Each Redpanda Operator and Helm chart version supports the corresponding Redpanda core version plus one minor version above and one below. This approach ensures flexibility and ease during upgrades. For example, Redpanda Operator version 25.1-k8sx supports Redpanda core versions 25.2.x, 25.1.x, and 24.3.x.
- The beta version is used for pre-release versions of the Redpanda Operator and Helm chart. These versions are not intended for production use.

Each Redpanda Operator and Helm chart version supports the corresponding Redpanda core version plus one minor version above and one below. This approach ensures flexibility during upgrades. For example, Redpanda Operator version 25.1.1 supports Redpanda core versions 25.2.x, 25.1.x, and 24.3.x.

Redpanda Operator and Helm chart versions are supported only while their associated Redpanda core version remains supported. If the core version reaches End-of-Life (EoL), the corresponding Operator and Helm chart versions also reach EoL.

Expand All @@ -36,9 +38,9 @@ NOTE: Beta versions are available only for testing and feedback. They are not su
// |1.30.x - 1.33.x

|25.1.x
|25.1-k8s-beta, 5.10.x, 5.9.x
|25.1-k8s-beta, 0.4.41, 0.4.36
|25.1-k8s-beta, 2.4.x, 2.3.x
|25.1.1-beta1, 5.10.x, 5.9.x
|25.1.1-beta1, 0.4.41, 0.4.36
|25.1.1-beta1, 2.4.x, 2.3.x
|3.12+
|1.29.x - 1.32.x

Expand Down Expand Up @@ -72,8 +74,8 @@ This interdependency is established when you add or update the Redpanda chart re
|Redpanda Console |Helm Chart |Operator

|v3.x.x
|v25.1-k8s-beta
|v25.1-k8s-beta
|v25.1.1-beta1
|v25.1.1-beta1

|v2.x.x
| 5.10.1, 5.9.x, 5.8.x
Expand Down