Recipe
timescaledb-cloudnative-pg
The time-series database realized as a Cluster custom resource the CloudNativePG control plane reconciles, rather than a directly synthesized StatefulSet. The product has no control plane of its own, so this realization runs it under the PostgreSQL controller this catalog already uses for core/datastore/postgres: the server image stays a stock PostgreSQL one and the time-series extension arrives as a second image the controller mounts into it. The recipe emits one Cluster naming both images and the preload list the extension needs; the controller turns it into a running server, its Services and the owner's Secret, 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 as it would to a synthesized realization. infra.credentials generated leaves the owner's password with the controller, and supplied points it at the Secret named in infra.credentials_secret. The Cluster is written into the namespace the Release, or else the Aggregate, names through the aggrega.ai/namespace annotation, where one is set, and provides publishes the pod label, port name and path a scraper discovers the instances' metrics by. Two runtime prerequisites are declared, and the build halts on either: the control plane is installed (infra.control_plane_present), and the cluster can mount an image as a volume (infra.image_volumes_supported). Reach for this realization where that control plane is already in place and the cluster can mount an image as a volume; reach for the synthesized timescaledb recipe where it is not — that one needs nothing installed, reaches no chart repository, and builds with nothing fetched.
Provenance
- Content digest
- sha256:6bd294dd7d2985f743910159fe0264c86f683a7e2d1f7d38c6123fe4907705de
- Published
- 2026-11-10T10:27:35Z
- 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:5a10f28abcfb5e6f456b1e7d7b7efd3a7a516588608987f90f62f7be115c0481
Reference at this version
oci://hub.aggrega.ai/recipe/helm/timescaledb-cloudnative-pg:1.0.0- Target
- —
- Implements
- core/datastore/timescaledb:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
| Name | Template |
|---|---|
| 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 workload template declared.
Locals
| Name | Template |
|---|---|
| server_port | 5432 |
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/timescaledb: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.