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.
Procedencia
- Digest del contenido
- sha256:a50a07029dd0472d4b616f0a2f5afb88c0127fbc1178a9bc709ebe52be7e8486
- Publicado
- 2026-11-10T10:26:25Z
- Identidad de firma
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Firma
- Oficialapplication/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
Referencia en esta versión
oci://hub.aggrega.ai/recipe/helm/postgres-cloudnative-pg:1.0.0- Destino
- —
- Implementa
- core/datastore/postgres:1.0.0
Proporciona
Plantillas de punteros deterministas que esta receta cablea para los consumidores.
| Nombre | Plantilla |
|---|---|
| host | {{ .context.instance_id }}-rw |
| port | {{ .locals.server_port }} |
| user | {{ .values.user }} |
| database | {{ .values.database }} |
| protocol | postgres |
| metrics_pod_selector | cnpg.io/cluster={{ .context.instance_id }},cnpg.io/podRole=instance |
| metrics_pod_port | metrics |
| metrics_path | /metrics |
Workload
No se declaró ninguna plantilla de carga de trabajo.
Variables locales
| Nombre | Plantilla |
|---|---|
| server_port | 5432 |
| barman_cloud_plugin | barman-cloud.cloudnative-pg.io |
Mapeo de valores
No se declaró ningún mapeo de valores.
Relaciones
Aristas tipadas hacia y desde otras entidades publicadas. Una referencia sin un destino publicado se muestra como una arista rota en lugar de como un enlace.
Usa
- implementaimplementacontrato compatible
core/datastore/postgres:1.0.0
Todas las salidas obligatorias se satisfacen y cada salida proporcionada está nombrada en el contrato.
Usado por
Nada en el catálogo depende de esta entidad.