|
| 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^]. |
0 commit comments