Mariadb Operator Agent Skill

<p align="center" width="100%"> <img src="https://mariadb-operator.github.io/mariadb-operator/assets/mariadb_centered_whitebg.svg" alt="mariadb" width="500"/> </p> <p align="center"> <a href="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/ci.yml"><img src="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/release.yml"><img src="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/release.yml/badge.svg" alt="Release"></a> <a href="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/helm.yml"><img src="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/helm.yml/badge.svg" alt="Helm"></a> <a href="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/helm-release.yml"><img src="https://github.com/mariadb-operator/mariadb-operator/actions/workflows/helm-release.yml/badge.svg" alt="Helm release"></a> </p> <p align="center"> <a href="https://github.com/mariadb-operator/mariadb-operator"><img alt="GitHub" src="https://img.shields.io/github/stars/mariadb-operator/mariadb-operator"></a> <a href="https://github.com/mariadb-operator/mariadb-operator/tree/main/docs/README.md"><img src="https://img.shields.io/badge/docs-latest-blue?logo=readthedocs&logoColor=white" alt="Docs"></a> <a href="https://github.com/mariadb-operator/mariadb-operator/pkgs/container/mariadb-operator"><img src="https://img.shields.io/badge/ghcr.io-mariadb--operator-blue?logo=docker&logoColor=white" alt="Container image"></a> <a href="https://r.mariadb.com/join-community-slack"><img alt="Slack" src="https://img.shields.io/badge/slack-join_chat-blue?logo=Slack&label=slack&style=flat"></a> </p> <p align="center"> <a href="https://pkg.go.dev/github.com/mariadb-operator/mariadb-operator/v26"><img src="https://pkg.go.dev/badge/github.com/mariadb-operator/mariadb-operator.svg" alt="Go Reference"></a> <a href="https://artifacthub.io/packages/helm/mariadb-operator/mariadb-operator"><img src="https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/mariadb-operator" alt="Artifact Hub"></a> <a href="https://operatorhub.io/operator/mariadb-operator"><img src="https://img.shields.io/badge/Operator%20Hub-mariadb--operator-red" alt="Operator Hub"></a> </p>

🦭 mariadb-operator

Run and operate MariaDB in a cloud native way. Declaratively manage your MariaDB using Kubernetes CRDs rather than imperative commands.

• Easily provision standalone MariaDB servers in Kubernetes.
• Multiple highly available topologies supported:
  • Asynchronous replication
  • Synchronous multi-master via Galera
  • Multi-cluster✨: cross-cluster replication for multi-region deployments, disaster recovery, and blue-green upgrades.
  • MaxScale as database proxy to load balance requests and perform failover/switchover operations
• Flexible storage configuration. Volume expansion.
• Physical backups based on mariadb-backup and Kubernetes VolumeSnapshots.
• Logical backups based on mariadb-dump.
• Multiple backup storage types: S3 compatible, Azure Blob Storage, PVCs, Kubernetes volumes and VolumeSnapshots.
• Flexible backup configuration: scheduling, compression, encryption, retention policy, target policy, timeout, staging area...
• Target recovery time: restore the closest available backup to the specified time.
• Bootstrap new instances from: Physical backups, logical backups, S3, Azure Blob Storage, PVCs, VolumeSnapshots...
• Point-In-Time-Recovery: Archive binary logs to enable point-in-time restoration and significantly reduce RPO.
• Cluster-aware rolling update: roll out replica Pods one by one, wait for each of them to become ready, and then proceed with the primary Pod, using ReplicasFirstPrimaryLast.
• Zero-downtime blue-green updates: leverage the multi-cluster topology to maintain two identical cluster topologies, upgrade one in the background, and switch between them without downtime.
• Manual update strategies: OnDelete and Never.
• Automated data-plane updates.
• my.cnf change detection. Automatically trigger updates when my.cnf changes.
• Suspend operator reconciliation for maintenance operations.
• Maintenance mode for safe operational windows: cordon, drain connections, and read-only modes.
• Issue, configure and rotate TLS certificates and CAs.
• Automated root password rotation by updating the referenced Secret.
• Native integration with cert-manager. Automatically create Certificate resources.
• Prometheus metrics via mysqld-exporter and maxscale-exporter.
• Native integration with prometheus-operator. Automatically create ServiceMonitor resources.
• Declaratively manage SQL resources: users, grants and logical databases.
• Declaratively manage resources in external MariaDB instances.
• Configure connections for your applications.
• Orchestrate and schedule sql scripts.
• Validation webhooks to provide CRD immutability.
• Additional printer columns to report the current CRD status.
• CRDs designed according to the Kubernetes API conventions.
• Install it using helm, OLM or static manifests.
• Multiple deployment modes: cluster-wide and single namespace.
• Helm charts published as OCI artifacts.
• Helm chart to deploy MariaDB clusters and its associated CRs.
• Multi-arch distroless image.
• GitOps friendly.

Documentation

For the user manual, getting started, guides, and API reference, please see the 📚docs directory.

Examples catalog

For example Custom Resources (CRs) demonstrating how to use the operator, refer to the 🛠️examples directory.

Helm installation

Helm charts are available as OCI images on GitHub Container Registry:

helm install mariadb-operator-crds oci://ghcr.io/mariadb-operator/charts/mariadb-operator-crds
helm install mariadb-operator oci://ghcr.io/mariadb-operator/charts/mariadb-operator
helm install mariadb-cluster oci://ghcr.io/mariadb-operator/charts/mariadb-cluster

Refer to the helm documentation for further detail.

Upgrading from older releases

When upgrading from an older version of the operator, it’s important to understand how both operator and operand resources are affected. Ensure you read both the updates section of the helm docs, and the release notes for any additional version-specific steps that may be required. Do not attempt to skip intermediate version upgrades. Upgrade progressively through each version to the next.

Openshift installation

The Openshift installation is managed separately in the mariadb-operator-helm repository, which contains a helm based operator that allows you to install mariadb-operator via OLM.

Image compatibility

mariadb-operator is only compatible with official MariaDB images. Refer to the images documentation for further detail.

MariaDB compatibility

• MariaDB Community >= 10.6

MaxScale compatibility

• MaxScale >= 23.08

Kubernetes compatibility

• Kubernetes >= 1.31
• OpenShift >= 4.18

Migrate your MariaDB instance to Kubernetes

This migration guide will streamline your onboarding process and assist you in migrating your data into a MariaDB instance running on Kubernetes.

Roadmap

We are actively working on the following features, which will be released in upcoming versions. Stay tuned!

• Point In Time Recovery (PITR)
• Multi-cluster topology

Adopters

Please create a PR and add your company or project to our ADOPTERS.md file if you are using our project!

Contributing

We welcome and encourage contributions to this project! Please check our contributing and development guides. PRs welcome!

Community

• MariaDB Operator: HA MySQL the Modern Way - Pascal Töpke, July 2026
• Run and Operate MariaDB in a Cloud Native Way Using the MariaDB Operator - @mmontes11 @ BuildDevCon: DB Mastery Series, June 2026
• Running MariaDB Server on Kubernetes - Frédéric Descamps @ BuildDevCon: DB Mastery Series, June 2026
• Why MariaDB Operator 25.10 Is a Big Deal for Stateful Workloads on Kubernetes - Mr.PlanB blog, October 2025
• The MariaDB Operator for Kubernetes - kubeadm.org
• Can You Run a MariaDB Cluster on a $150 Kubernetes Lab? I Gave It a Shot - Alejandro Duarte @ DZone, May 2025
• We Tested and Compared 6 Database Operators. The Results are In! - KubeCon EU, March 2024
• Get Started with MariaDB in Kubernetes and mariadb-operator - MariaDB Corporation blog, February 2024
• Run and operate MariaDB in Kubernetes with mariadb-operator - MariaDB Foundation blog, July 2023
• L'enfer des DB SQL sur Kubernetes face à la promesse des opérateurs - KCD France, March 2023

Join us on Slack: MariaDB Community Slack.

Enterprise

For enterprise users, see the MariaDB Enterprise Operator, a commercially supported Kubernetes operator from MariaDB with additional enterprise-grade features.