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
- Empreinte du contenu
- sha256:a50a07029dd0472d4b616f0a2f5afb88c0127fbc1178a9bc709ebe52be7e8486
- Publié
- 2026-11-10T10:26:25Z
- Identité de signature
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officielapplication/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
Référence à cette version
oci://hub.aggrega.ai/recipe/helm/postgres-cloudnative-pg:1.0.0- Cible
- —
- Implémente
- core/datastore/postgres:1.0.0
Fournit
Modèles de pointeurs déterministes que cette recette câble pour les consommateurs.
| Nom | Modèle |
|---|---|
| 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
Aucun modèle de charge de travail déclaré.
Variables locales
| Nom | Modèle |
|---|---|
| server_port | 5432 |
| barman_cloud_plugin | barman-cloud.cloudnative-pg.io |
Correspondance des valeurs
Aucune correspondance des valeurs déclarée.
Relations
Arêtes typées vers et depuis d’autres entités publiées. Une référence sans cible publiée s’affiche comme une arête rompue plutôt que comme un lien.
Utilise
- implémenteimplémentecontrat compatible
core/datastore/postgres:1.0.0
Toutes les sorties obligatoires sont satisfaites et chaque sortie fournie est nommée dans le contrat.
Utilisé par
Rien dans le catalogue ne dépend de cette entité.