This repository contains the official Helm chart for CNMSQL - CloudNative for MySQL, a Kubernetes operator for Percona Server for MySQL.
The chart lives under charts/cnmsql. It can install the operator in two ways:
- Cluster-wide (default): the operator watches every namespace and manages
Clusterresources anywhere in the cluster. - Namespaced: the operator watches only the release namespace, which lets multiple independent operators coexist on the same cluster.
- Kubernetes 1.29 or newer
- Helm 3.13 or newer
- cert-manager installed in the target cluster (the chart creates
CertificateandIssuerobjects for webhook TLS)
Add this repository or use the chart directly from the local path.
helm install cnmsql ./charts/cnmsql \
--namespace cnmsql-system \
--create-namespaceThe operator image defaults to ghcr.io/cnmsql/cnmsql:<chart-appVersion>.
helm install cnmsql ./charts/cnmsql \
--namespace tenant-a \
--create-namespace \
--set rbac.namespaced=trueIn namespaced mode the release is constrained to tenant-a. The chart creates a Role instead of a ClusterRole, injects the WATCH_NAMESPACE environment variable, and scopes the validating webhook with a namespace selector.
To point the chart at a custom image:
helm install cnmsql ./charts/cnmsql \
--namespace cnmsql-system \
--create-namespace \
--set manager.image.repository=ghcr.io/cnmsql/cnmsql \
--set manager.image.tag=mainhelm uninstall cnmsql -n cnmsql-systemCRDs are kept by default (crd.keep=true) so uninstalling a release does not remove existing Cluster or Backup resources.
The chart is packaged and pushed to GitHub Container Registry on every pushed tag that starts with v and on workflow dispatch. Install from OCI:
helm install cnmsql oci://ghcr.io/cnmsql/charts/cnmsql \
--namespace cnmsql-system \
--create-namespacecharts/
└── cnmsql/ # the Helm chart
├── Chart.yaml
├── values.yaml
├── README.md
└── templates/
Follow the operator repository conventions. Before committing, run:
helm lint ./charts/cnmsql
helm lint ./charts/cnmsql --set rbac.namespaced=trueChanges to templates should be validated against both installation modes.
Apache 2.0. See the operator repository for the full license.