This repository contains the governance documents for the CloudNativePG project:
- Code of Conduct
- Governance Policy
- Contributing guidelines
- AI Policy
- List of Maintainers
- List of Component owners
- List of Contributors
- License
The primary components for deploying and managing the project lifecycle.
| Repository | Description |
|---|---|
| governance | Central hub for project policies, AI policy, and general guidelines. |
| cloudnative-pg | The main Kubernetes Operator for PostgreSQL. |
| charts | Official Helm charts for the operator, database clusters and the Barman Cloud plugin. |
| artifacts | Storage for generated manifests, checksums, metadata, and image catalogs. |
| cnpg-template | A template repository for creating new CloudNativePG-related projects. |
Standardized images built for security, minimal footprint, and CNPG compatibility.
| Repository | Description |
|---|---|
| postgres-containers | Operand images for all community-supported PostgreSQL versions. |
| postgres-extensions-containers | Images for community extensions used as pluggable image volumes. |
| pgbouncer-containers | Optimized images for PgBouncer connection pooling. |
| postgis-containers | PostgreSQL images bundled with PostGIS extensions. |
| postgres-trunk-containers | Images built from PostgreSQL main branch for early testing. |
| pgcrash-containers | Container images for pg_crash to test PostgreSQL resilience. |
User-facing resources, observability, and distribution.
| Repository | Description |
|---|---|
| docs | The documentation project and Hugo source for the operator docs. |
| cloudnative-pg.github.io | The main project landing page/website. |
| cnpg-playground | Local learning environment scripts using Docker/Kind. |
| grafana-dashboards | Standardized Grafana dashboards for monitoring CNPG clusters. |
| community-operators | Fork for publishing the operator to OperatorHub.io. |
| webtest | Internal tooling for website and documentation testing. |
Shared logic, API definitions, and CI/CD modules consumed by other components.
| Repository | Description |
|---|---|
| api | The CloudNativePG API definitions and types. |
| machinery | Common Go library for internal logic (extracted from the operator). |
| barman-cloud | Go library for interacting with Barman Cloud object stores. |
| daggerverse | Dagger modules for portable CI/CD workflows. |
The extensibility layer that allows for custom backups and additional logic.
| Repository | Description |
|---|---|
| cnpg-i | The CloudNativePG Interface (CNPG-I) gRPC specification. |
| cnpg-i-machinery | Shared Go code for developing CNPG-I compatible plugins. |
| plugin-barman-cloud | The reference CNPG-I backup/restore plugin for Barman Cloud. |
| cnpg-i-hello-world | A simplified template/example for building new plugins. |
Software designed to run inside or alongside the PostgreSQL database engine.
| Repository | Description |
|---|---|
| postgres-keycloak-oauth-validator | A PostgreSQL module for OAuth2/Keycloak token validation. |
Tools dedicated to CI/CD, resilience testing, and GitHub Actions development.
| Repository | Description |
|---|---|
| ciclops | The Continuous Integration Circular Operations tool for the project. |
| chaos-testing | Infrastructure and scripts for running chaos experiments against CNPG. |
| github-test | Playground and testing ground for GitHub Actions and automation workflows. |