Recipe

postgres-cloudnative-pg

PostgreSQL realized as a Cluster custom resource the CloudNativePG control plane reconciles, rather than a directly synthesized StatefulSet — the controller-driven realization of the same PostgreSQL component, selectable in the Manifest alongside the synthesis recipe and the reference recipe. The recipe emits one Cluster conformant to the postgresql.cnpg.io/v1 API; the controller turns it into a running server, the Services that reach it and the Secret holding the database owner's password, and creates the initial database and its owning role from the developer's own values. provides.host is the read-write Service, so a consumer wires to it exactly as it would to the synthesized realization. The Cluster, and the ConfigMap carrying any bootstrap scripts, are written into the namespace the Release, or else the Aggregate, names through the aggrega.ai/namespace annotation, where one is set. Credential custody is the operator's choice: infra.credentials generated leaves the owner's password with the controller, and supplied points it at an existing Secret named in infra.credentials_secret. The CloudNativePG control plane is a runtime prerequisite: the build halts unless the operator affirms it is installed (infra.control_plane_present), so no custom resource is emitted into a cluster that cannot reconcile it. Reach for this realization where the control plane is already in place; reach for the synthesis recipe where it is not, and for the reference recipe where the server already exists outside the deployment. A core/backup attachment bound to helm/backup-cloudnative-pg is realized through the Barman Cloud plugin.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:a50a07029dd0472d4b616f0a2f5afb88c0127fbc1178a9bc709ebe52be7e8486
Published
2026-11-10T10:26:25Z
Signing identity
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Signature

  • Officialapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:fef15b8e5dc310d5230a64beef0e0603c16d81d17a48e78b6a5aae30ac835aae

Reference at this version

oci://hub.aggrega.ai/recipe/helm/postgres-cloudnative-pg:1.0.0
Target
—
Implements
core/datastore/postgres:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.instance_id }}-rw
port{{ .locals.server_port }}
user{{ .values.user }}
database{{ .values.database }}
protocolpostgres
metrics_pod_selectorcnpg.io/cluster={{ .context.instance_id }},cnpg.io/podRole=instance
metrics_pod_portmetrics
metrics_path/metrics

Workload

No workload template declared.

Locals

NameTemplate
server_port5432
barman_cloud_pluginbarman-cloud.cloudnative-pg.io

Values mapping

No values mapping declared.

Relationships

Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.

Uses

  • implementsimplementscontract compatible

    core/datastore/postgres:1.0.0

    All required outputs are satisfied and every provided output is named in the contract.

Used by

Nothing in the catalog depends on this entity.

Recipe concept reference →

The Aggrega catalog — an open index of components, features, recipes, and the plugins that render them.

Built with the shared Aggrega design system.

Privacy