CloudNativePG

CloudNativePG (CNPG) is an open-source operator designed to manage PostgreSQL workloads on any supported Kubernetes cluster. It fosters cloud-neutrality through seamless deployment in private, public, hybrid, and multi-cloud environments via its distributed topology feature.
Built around DevOps principles, CloudNativePG embraces declarative configuration and immutable infrastructure, ensuring reliability and automation in database management.
At its core, CloudNativePG introduces a custom Kubernetes resource called Cluster, representing a PostgreSQL cluster with:
These instances reside within a Kubernetes namespace, allowing applications to connect seamlessly using operator-managed services. Failovers and switchovers occur transparently, eliminating the need for manual intervention.
For applications inside the Kubernetes cluster, CNPG provides a microservice database approach, enabling co-location of PostgreSQL clusters and applications in the same namespace for optimized access. For applications outside the cluster, CNPG offers flexible connectivity through service templates and LoadBalancer services for direct TCP exposure. Additionally, web applications can take advantage of the native connection pooler based on PgBouncer.
CloudNativePG was originally built by EDB, then released open source under Apache License 2.0. The source code repository is in GitHub.
Based on the Operator Capability Levels model, users can expect a "Level V - Auto Pilot" subset of capabilities from the CloudNativePG Operator.
Each minor release of CloudNativePG is designed to work with a range of Kubernetes versions, usually the ones supported by the CNCF at the time the minor version was first released.
Please refer to the "Supported releases" page for details.
The CloudNativePG community maintains container images for both the operator and PostgreSQL (the operand).
The CloudNativePG operator container images are available on the cloudnative-pg project's GitHub Container Registry in two different flavors:
Red Hat UBI images are primarily intended for OLM consumption.
All container images are signed and include SBOM and provenance attestations, provided separately for each architecture.
The CloudNativePG project provides and maintains PostgreSQL operand container images, built on top of the official Debian slim base image, for both linux/amd64 and linux/arm64 architectures.
Images are published for all Debian supported releases (stable, oldstable) and for PostgreSQL versions supported by PGDG. They are distributed via the postgres-containers GitHub Container Registry.
Three image flavors are available, each extending the previous one:
The system images are deprecated and will be removed once in-core Barman Cloud support is phased out. They remain usable for now, but you may want to plan a future migration to minimal or standard images with the Barman Cloud plugin, or another supported backup solution.
By default, this version of CloudNativePG deploys ghcr.io/cloudnative-pg/postgresql:18.7-system-trixie.
All images are signed and shipped with SBOM and provenance attestations. Weekly automated builds ensure that critical vulnerabilities (CVEs) are promptly fixed.
For details and support, see the postgres-containers project.
CloudNativePG does not use StatefulSets for managing data persistence. Instead, it directly manages Persistent Volume Claims (PVCs). See "Custom Pod Controller" for more details.
Follow the instructions in the "Quickstart" to test CloudNativePG on a local Kubernetes cluster using Kind, or Minikube.
In case you are not familiar with some basic terminology on Kubernetes and PostgreSQL, please consult the "Before you start" section.
The CloudNativePG documentation is licensed under a Creative Commons Attribution 4.0 International License.
Postgres, PostgreSQL, and the Slonik Logo are trademarks or registered trademarks of the PostgreSQL Community Association of Canada, and used with their permission.
CloudNativePG is a Cloud Native Computing Foundation Incubating project.