pgedge-cnpg-dist

README

pgEdge Enterprise Postgres for Kubernetes

Helm charts, manifests, container images, and testing infrastructure for running pgEdge Enterprise Postgres on Kubernetes using the CloudNativePG operator.

Overview

This repository provides:

• Rebuilt Operator Images: CloudNativePG operator images rebuilt from source and published to pgEdge's container registry
• Configured Helm Charts, Manifests, and Plugins: Redistributes CloudNativePG charts, manifests, and plugins with modifications to use pgEdge-built operator images
• kubectl Plugin: The kubectl-cnpg plugin is built from source, configured for pgEdge-built operator images, and distributed via Krew
• End-to-End Testing: Automated validation against the upstream CloudNativePG test suite with pgEdge Enterprise Postgres images
• Multi-Version Support: Testing across PostgreSQL versions, Kubernetes distributions, and operator versions

Relationship to CloudNativePG

This project builds upon CloudNativePG, a CNCF Sandbox project for managing PostgreSQL on Kubernetes.

This project is not affiliated with, endorsed by, or sponsored by the CloudNativePG project or the Cloud Native Computing Foundation.

Container Images

We rebuild and publish CloudNativePG operator images from upstream source:

Image	Source	Registry
CloudNativePG Operator	cloudnative-pg/cloudnative-pg	ghcr.io/pgedge/cloudnative-pg
Barman Cloud Plugin	cloudnative-pg/plugin-barman-cloud	ghcr.io/pgedge/plugin-barman-cloud-*

Images are built via GitHub Actions workflows from upstream source tags with the following modifications:

• Go toolchain pinning: GOTOOLCHAIN is set to a minimum patched version at build time to fix Go stdlib CVEs present in the upstream toolchain. This does not change any source code — only the Go toolchain version used to compile the binaries.

kubectl Plugin

We build and distribute the kubectl-cnpg plugin from upstream CloudNativePG source with modifications to use pgEdge operator images as defaults.

Component	Source	Distribution
kubectl-cnpg	cloudnative-pg/cloudnative-pg	GitHub Releases

Modification: Default operator image references changed to ghcr.io/pgedge/cloudnative-pg.

Helm Charts

We redistribute CloudNativePG Helm charts with modifications to use pgEdge-built operator images:

Chart	Latest Version	Upstream Source
charts/cloudnative-pg/	v0.29.0	cloudnative-pg/charts
charts/plugin-barman-cloud/	v0.7.0	cloudnative-pg/plugin-barman-cloud

Modification: Default image references changed to ghcr.io/pgedge/ registry.

Installing from pgEdge Helm Repository

Charts are published to the pgEdge Helm repository for easy installation:

# Add the pgEdge Helm repository
helm repo add pgedge https://pgedge.github.io/charts
helm repo update

# Install CloudNativePG operator
helm install cnpg pgedge/cloudnative-pg \
  --namespace cnpg-system \
  --create-namespace

# Install Barman Cloud plugin
helm install barman pgedge/plugin-barman-cloud \
  --namespace cnpg-system

To see available chart versions:

# Search for CloudNativePG charts
helm search repo pgedge/cloudnative-pg --versions

# Search for Barman Cloud plugin charts
helm search repo pgedge/plugin-barman-cloud --versions

Manifests

We redistribute CloudNativePG installation manifests with modifications to use pgEdge-built operator images. These are the currently supported versions:

Version	Upstream Source
v1.29.1	cloudnative-pg v1.29.1
v1.30.0	cloudnative-pg v1.30.0

Modification: Operator image references changed to ghcr.io/pgedge/ registry.

Quick Start

Prerequisites

# macOS
make install-tools

# Verify Docker is running
docker ps

Run Tests

# Check prerequisites
make check-prereqs

# Run infrastructure validation
make test-infra

# Run operator deployment test
make test-operator

# Run smoke tests
make test-smoke

# Run comprehensive tests
make test-comprehensive

Testing

Test Categories

Test	Description	Command
Infrastructure	Kubernetes cluster provisioning and CSI storage	make test-infra
Operator	Operator deployment with pgEdge images	make test-operator
Image Validation	Admission control blocks non-pgEdge images	make test-image-validation
Smoke	Quick upstream E2E test subset	make test-smoke
Comprehensive	Full upstream E2E test suite	make test-comprehensive

EKS

Prerequisites

• AWS CLI v2
• Terraform >= 1.0
• kubectl (invoked directly by terratest)
• AWS credentials configured (aws configure or AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY env vars)

Run Tests

# Infrastructure validation on EKS
CLUSTER_PROVIDER=eks go test ./tests -run TestInfra -v -timeout 60m

# Upstream E2E tests on EKS
CLUSTER_PROVIDER=eks go test ./tests -run TestUpstream -v -timeout 4h

Version-Specific Tests

make test-cnpg-1.29.0       # Specific operator version
make test-pg-18             # Specific PostgreSQL version
make test-all-cnpg          # All operator versions
make test-all-postgres      # All PostgreSQL versions

Image Validation Policy

All test clusters enforce pgEdge Enterprise Postgres image usage via Kubernetes ValidatingAdmissionPolicy:

Allowed:

• ghcr.io/pgedge/pgedge-postgres:*
• ghcr.io/pgedge/pgedge-postgres-internal:*

Blocked:

• ghcr.io/cloudnative-pg/postgresql:* (upstream CNPG images)
• postgres:* (Docker Hub images)
• Any other PostgreSQL image

This prevents accidental use of non-pgEdge images during testing.

Configuration

Tests are configured via tests/config/versions.yaml:

cnpg_versions:
  - version: "1.29.1"
    chart_version: "0.28.3"
    git_tag: "v1.29.1"
    operator_image: "ghcr.io/pgedge/cloudnative-pg:1.29.1"
    postgres_versions: ["18", "17", "16"]
    providers:
      kind:
        kubernetes_versions: ["1.33", "1.34", "1.35"]

postgres_images:
  registries:
    public:
      base: "ghcr.io/pgedge/pgedge-postgres"
  variants:
    - name: "standard"
      tag_suffix: "-standard"

License

This repository contains components under different licenses:

Component	License	Location
pgEdge tests and tooling	PostgreSQL License	tests/, .github/, Makefile
CloudNativePG charts	Apache License 2.0	charts/
CloudNativePG manifests	Apache License 2.0	manifests/

See NOTICE for full attribution and trademark details.

This project is not affiliated with, endorsed by, or sponsored by CloudNativePG, the Cloud Native Computing Foundation, or the PostgreSQL Global Development Group.