Try the 25.1 Beta of the Redpanda Operator
beta
Deploy the 25.1 beta release of the Redpanda Operator or Redpanda Helm chart. This version of the Redpanda Operator no longer requires FluxCD or its custom resource definitions. In this version, the Redpanda Operator is responsible for reconciling the Redpanda cluster.
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 Redpanda Community Slack.
Prerequisites
Make sure that your Kubernetes cluster meets the requirements.
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).
-
Make sure that you have permission to install custom resource definitions (CRDs):
kubectl auth can-i create CustomResourceDefinition --all-namespaces
bashYou should see
yes
in the output.You need these cluster-level permissions to install cert-manager and Redpanda Operator CRDs in the next steps.
-
Install cert-manager:
helm repo add jetstack https://charts.jetstack.io helm repo update helm install cert-manager jetstack/cert-manager \ --set crds.enabled=true \ --namespace cert-manager \ --create-namespace
bashTLS is enabled by default and cert-manager is used to manage TLS certificates.
-
Install the Redpanda Operator CRDs:
kubectl kustomize "https://github.com/redpanda-data/redpanda-operator//operator/config/crd?ref=v25.1.1-beta3" \ | kubectl apply --server-side -f -
bash -
Deploy the Redpanda Operator.
helm repo add redpanda https://charts.redpanda.com helm upgrade --install redpanda-controller redpanda/operator \ --namespace <namespace> \ --create-namespace \ --version v25.1.1-beta3
bash -
Ensure that the Deployment is successfully rolled out:
kubectl --namespace <namespace> rollout status --watch deployment/redpanda-controller-operator
bashdeployment "redpanda-controller-operator" successfully rolled out
-
Install a Redpanda custom resource to deploy a Redpanda cluster and Redpanda Console v3.
redpanda-cluster.yaml
apiVersion: cluster.redpanda.com/v1alpha2 kind: Redpanda metadata: name: redpanda
yaml -
If you want to use enterprise features in Redpanda, add the details of a Secret that stores your Enterprise Edition license key.
redpanda-cluster.yaml
apiVersion: cluster.redpanda.com/v1alpha2 kind: Redpanda metadata: name: redpanda spec: clusterSpec: enterprise: licenseSecretRef: name: <secret-name> key: <secret-key>
yamlFor details, see Add an Enterprise Edition License to Redpanda in Kubernetes.
-
Apply the Redpanda resource:
kubectl apply -f redpanda-cluster.yaml --namespace <namespace>
bashThe Redpanda resource must be deployed in the same namespace as the Redpanda Operator.
-
Wait for the Redpanda Operator to deploy the cluster:
kubectl get redpanda --namespace <namespace> --watch
bashNAME READY STATUS redpanda True Redpanda reconciliation succeeded
This step may take a few minutes. You can watch for new Pods to make sure that the deployment is progressing:
kubectl get pod --namespace <namespace>
bashIf it’s taking too long, see Troubleshooting.
Install the Redpanda Helm chart v25.1.1-beta1
-
Install cert-manager using Helm:
helm repo add jetstack https://charts.jetstack.io helm repo update helm install cert-manager jetstack/cert-manager \ --set crds.enabled=true \ --namespace cert-manager \ --create-namespace
bashThe Redpanda Helm chart enables TLS by default and uses cert-manager to manage TLS certificates.
-
If you want to use enterprise features in Redpanda, add the details of a Secret that stores your Enterprise Edition license key.
redpanda-values.yaml
enterprise: licenseSecretRef: name: <secret-name> key: <secret-key>
yamlFor details, see Add an Enterprise Edition License to Redpanda in Kubernetes.
-
Install the Redpanda Helm chart to deploy a Redpanda cluster and Redpanda Console v3.
helm repo add redpanda https://charts.redpanda.com helm repo update helm install redpanda redpanda/redpanda \ --version v25.1.1-beta1 --namespace <namespace> --create-namespace \ --values redpanda-values.yaml
bash -
Wait for the Redpanda cluster to be ready:
kubectl --namespace <namespace> rollout status statefulset redpanda --watch
bashWhen the Redpanda cluster is ready, the output should look similar to the following:
statefulset rolling update complete 3 pods at revision redpanda-8654f645b4...
Next steps
To give feedback about this beta version, reach out to the Redpanda team in Redpanda Community Slack.