Helm chart to install the CloudNativePG operator, designed by EnterpriseDB to manage PostgreSQL workloads on any supported Kubernetes cluster running in private, public, or hybrid cloud environments.

helm repo add cnpg https://cloudnative-pg.github.io/charts
helm upgrade --install cnpg \
  --namespace cnpg-system \
  --create-namespace \
  cnpg/cloudnative-pg

To deploy the operator from sources you can run the following command:

helm upgrade --install cnpg \
  --namespace cnpg-system \
  --create-namespace \
  charts/cloudnative-pg

CloudNativePG Sandbox, aka cnpg-sandbox, is a Helm chart that sets up the following components inside a Kubernetes cluster:

• Prometheus
• Grafana
• CloudNativePG (CNPG) a Kubernetes operator for PostgreSQL and EDB Postgres Advanced, with:
  • a selection of PostgreSQL metrics for the native Prometheus exporter in CNPG (see the metrics.yaml template file)
  • a custom Grafana dashboard developed by EDB for CloudNativePG

IMPORTANT: cnpg-sandbox must be run in a staging or pre-production environment. Do not use cnpg-sandbox in a production environment, as we expect that Prometheus and Grafana are already part of that infrastructure: there you can install CloudNativePG, the suggested metrics and the provided Grafana dashboard.

• CloudNativePG 1.10.0
• GNU Make 3.8
• Helm 3.7
• A supported Kubernetes cluster with enough RBAC permissions to deploy the required resources

Deployment using the latest release:

helm repo add cnpg https://cloudnative-pg.github.io/charts
helm repo update
helm upgrade --install cnpg-sandbox \
  cnpg/cnpg-sandbox

Then simply follow the instructions that will appear on the terminal once the installation is completed.

You can deploy CloudNativePG Sandbox from local source with:

make sandbox-deploy

You can remove the installed sandbox by running:

make sandbox-uninstall

From the Grafana interface, you can find the dashboard by selecting: Dashboards > Manage > CloudNativePg.

You can use cnpg-sandbox in conjuction with cnp-bench to benchmark your PostgreSQL environment and observe its behaviour in real-time.

Please read the code of conduct and the guidelines to contribute to the project.

cnpg-sandboxis open source software and comes "as is". Please carefully read the license before you use this software, in particular the "Disclaimer of Warranty" and "Limitation of Liability" items.

cnpg-sandbox is distributed under Apache License 2.0. cnpg is distributed under Apache License 2.0.