Skip to content

Commit 887de40

Browse files
k8s: Add 25.2 beta docs for the Redpanda Operator (#1307)
Co-authored-by: Chris Seto <chriskseto@gmail.com>
1 parent 5a571e2 commit 887de40

3 files changed

Lines changed: 138 additions & 0 deletions

File tree

modules/ROOT/nav.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@
6666
** xref:deploy:redpanda/index.adoc[Redpanda]
6767
*** xref:deploy:redpanda/kubernetes/index.adoc[Kubernetes]
6868
**** xref:deploy:redpanda/kubernetes/k-deployment-overview.adoc[Overview]
69+
**** xref:deploy:deployment-option/self-hosted/kubernetes/k-25.2-beta.adoc[Try v25.2]
6970
**** xref:deploy:redpanda/kubernetes/get-started-dev.adoc[Get Started]
7071
***** xref:deploy:redpanda/kubernetes/aks-guide.adoc[Azure AKS]
7172
***** xref:deploy:redpanda/kubernetes/eks-guide.adoc[Amazon EKS]
Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
= Try the 25.2 Beta of the Redpanda Operator
2+
:page-beta: true
3+
:description: Deploy the 25.2 beta release of the Redpanda Operator. This version of the Redpanda Operator is cluster scope so a single instance of the Operator can manage multiple Redpanda resources in different namespaces.
4+
5+
{description}
6+
7+
This beta version is available for testing and feedback. It is not supported by Redpanda and should not be used in production environments. To give feedback on beta releases, reach out to the Redpanda team in https://redpanda.com/slack[Redpanda Community Slack^].
8+
9+
== Prerequisites
10+
11+
Make sure that your Kubernetes cluster meets the xref:./k-requirements.adoc[requirements].
12+
13+
== Install Redpanda Operator v25.2.1-beta1
14+
15+
. Make sure that you have permission to install custom resource definitions (CRDs):
16+
+
17+
```bash
18+
kubectl auth can-i create CustomResourceDefinition --all-namespaces
19+
```
20+
+
21+
You should see `yes` in the output.
22+
+
23+
You need these cluster-level permissions to install glossterm:cert-manager[^] and Redpanda Operator CRDs in the next steps.
24+
25+
. Install cert-manager:
26+
+
27+
```bash
28+
helm repo add jetstack https://charts.jetstack.io
29+
helm repo update
30+
helm install cert-manager jetstack/cert-manager \
31+
--set crds.enabled=true \
32+
--namespace cert-manager \
33+
--create-namespace
34+
```
35+
+
36+
TLS is enabled by default and cert-manager is used to manage TLS certificates.
37+
38+
. Deploy the Redpanda Operator.
39+
+
40+
[,bash,subs="attributes+"]
41+
----
42+
helm repo add redpanda https://charts.redpanda.com
43+
helm upgrade --install redpanda-controller redpanda/operator \
44+
--namespace <namespace> \
45+
--create-namespace \
46+
--version {operator-beta-tag} \
47+
--set crds.enabled=true
48+
----
49+
50+
. Ensure that the Deployment is successfully rolled out:
51+
+
52+
```bash
53+
kubectl --namespace <namespace> rollout status --watch deployment/redpanda-controller-operator
54+
```
55+
+
56+
[.no-copy]
57+
----
58+
deployment "redpanda-controller-operator" successfully rolled out
59+
----
60+
61+
. Install a xref:reference:k-crd.adoc[Redpanda custom resource] to deploy a Redpanda cluster.
62+
+
63+
.`redpanda-cluster.yaml`
64+
[,yaml,subs="attributes+"]
65+
----
66+
apiVersion: cluster.redpanda.com/v1alpha2
67+
kind: Redpanda
68+
metadata:
69+
name: redpanda
70+
----
71+
72+
. If you want to use enterprise features in Redpanda, add the details of a Secret that stores your Enterprise Edition license key.
73+
+
74+
.`redpanda-cluster.yaml`
75+
[,yaml,subs="attributes+"]
76+
----
77+
apiVersion: cluster.redpanda.com/v1alpha2
78+
kind: Redpanda
79+
metadata:
80+
name: redpanda
81+
spec:
82+
clusterSpec:
83+
enterprise:
84+
licenseSecretRef:
85+
name: <secret-name>
86+
key: <secret-key>
87+
----
88+
+
89+
For details, see xref:get-started:licensing/add-license-redpanda/kubernetes.adoc[].
90+
91+
. Apply the Redpanda resource:
92+
+
93+
```bash
94+
kubectl apply -f redpanda-cluster.yaml --namespace <namespace>
95+
```
96+
97+
. Wait for the Redpanda Operator to deploy the cluster:
98+
+
99+
```bash
100+
kubectl get redpanda --namespace <namespace> --watch
101+
```
102+
+
103+
[.no-copy]
104+
----
105+
NAME READY STATUS
106+
redpanda True Redpanda reconciliation succeeded
107+
----
108+
+
109+
This step may take a few minutes. You can watch for new Pods to make sure that the deployment is progressing:
110+
+
111+
```bash
112+
kubectl get pod --namespace <namespace>
113+
```
114+
+
115+
If it's taking too long, see xref:manage:kubernetes/troubleshooting/k-troubleshoot.adoc[Troubleshooting].
116+
117+
include::deploy:partial$kubernetes/guides/uninstall.adoc[leveloffset=+1]
118+
119+
== Next steps
120+
121+
To give feedback about this beta version, reach out to the Redpanda team in https://redpanda.com/slack[Redpanda Community Slack^].

modules/get-started/pages/release-notes/operator.adoc

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,22 @@ See also:
99
* xref:upgrade:k-compatibility.adoc[]
1010
* xref:upgrade:k-rolling-upgrade.adoc[]
1111
12+
== Redpanda Operator v25.2.x (beta)
13+
14+
link:https://github.com/redpanda-data/redpanda-operator/blob/release/v25.2.x/operator/CHANGELOG.md[Changelog^].
15+
16+
See also: xref:deploy:deployment-option/self-hosted/kubernetes/k-25.2-beta.adoc[].
17+
18+
=== Cluster scope by default
19+
20+
Starting in v25.2, the Redpanda Operator defaults to cluster scope instead of namespace scope. This change provides several benefits:
21+
22+
* **Simplified management**: A single operator instance can manage multiple Redpanda clusters across different namespaces.
23+
* **Reduced resource overhead**: No need to deploy separate operator instances for each namespace.
24+
* **Centralized upgrades**: Upgrade the operator once to benefit all managed Redpanda clusters.
25+
* **Cross-namespace management**: Deploy the operator in a dedicated namespace (such as `redpanda-system`) while managing clusters in application namespaces.
26+
* **Simplified RBAC for debug bundles**: The Redpanda Operator now provides all required permissions for `rpk` debug bundle collection by default. The `rbac.createRPKBundleCRs` flag is no longer needed.
27+
1228
== Redpanda Operator v25.1.x (GA)
1329

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

0 commit comments

Comments
 (0)