Component
core/datastore/documentdb
A PostgreSQL-backed document store: PostgreSQL 17 with the DocumentDB extension. It presents the standard PostgreSQL wire contract (POSTGRES_USER / POSTGRES_PASSWORD / POSTGRES_DB) and persists data on a volume, so it is a stateful server. It is the storage backend for a document proxy that speaks a document-database wire protocol on top of it; the proxy connects over the exported host, port, user, and database. Exports its host, port, user, database, and protocol to consumers via the uses topology.
Provenance
- Empreinte du contenu
- sha256:8f0098d60a8139139f99ea1d548e2ce9fcdf57ae40e8e89e208daf82dd92e4a2
- Publié
- 2026-11-10T10:10:33Z
- 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:9bd69b3849e2f834bf9c38c463c7f4c072cde4377dbabbe90e39b1a8da422254
Référence à cette version
oci://hub.aggrega.ai/component/core/datastore/documentdb:1.0.0Paramètres du développeur
Valeurs que le développeur définit dans l’Aggregate.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| user | string | postgres | non | Application database user created on startup (POSTGRES_USER). |
| database | string | postgres | non | Logical database name created on startup (POSTGRES_DB). |
Dimensionnement de l’opérateur
Dimensionnement de l’infrastructure que l’opérateur ajuste pour chaque environnement.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 5432 | non | Server listen port. Most operators should omit this and let the Recipe assign the default (5432). |
| engine_version | string | 17-0.107.0-ferretdb-2.7.0 | non | Backend image tag (PostgreSQL major version plus the DocumentDB extension build). |
| compute | object | — | non | — |
| storage | object | — | non | — |
| overrides | object (open) | — | non | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Contrat de sortie
Valeurs que ce composant publie vers les consommateurs via la topologie uses.
| Nom | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
| host | string | — | oui | Address a client opens its database connection to. On the in-cluster realizations it is the Service's DNS name. |
| port | integer | — | oui | TCP port the server accepts connections on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default. |
| user | string | — | non | Name of the application login role created at startup. A consumer authenticates as this role; the matching password arrives through the credential attached to the component, never through this contract. |
| database | string | — | non | Name of the logical database created at startup. A consumer names it in its connection string to land in the right database rather than the server's default. |
| protocol | string | — | non | Wire protocol the published address speaks — `postgres`, so a consumer chooses a PostgreSQL client even though what it stores is documents. |
Sockets uses
Les sockets de dépendance par lesquels ce composant se connecte. La cible de chaque connexion câblée via un socket doit satisfaire son sélecteur d’étiquettes, et chaque connexion peut porter une attache dans les emplacements que le socket déclare. Un emplacement obligatoire doit être rempli par chaque connexion que l’Aggregate ou la Release câble via le socket.
Aucun socket uses déclaré.
Emplacements d’attache
Points de liaison nommés auxquels une Feature s’attache à ce composant. Le sélecteur d’un emplacement restreint la Feature qui peut le remplir, et sa liste inject indique comment le matériel de la Feature peut être livré. Un emplacement obligatoire doit être lié sur chaque instance, par une attache sur l’instance ou à une portée supérieure, et un emplacement sensible est déclaré pour traiter du matériel secret. Une Feature peut aussi s’attacher sous un nom qu’aucun emplacement ne déclare.
| Emplacement | Sélecteur | Obligatoire | Injection | Sensible | Description |
|---|---|---|---|---|---|
| password | feature.aggrega.ai/kind=secret | non | env | oui | Optional database password credential. When attached, supplies POSTGRES_PASSWORD via the credential subsystem. Unattached, compose/documentdb and helm/documentdb set POSTGRES_PASSWORD to the development literal `apppass`, which this catalog publishes, so every Release that leaves the slot unattached shares that password. |
Liste d’autorisation d’auto-injection
env
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
Cette entité n’utilise rien du catalogue.
Utilisé par
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « queue »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « queue »
utilise le socket « backend »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « queue »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « queue »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « queue »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « state_store »
utilise le socket « checkpointer_db »
utilise le socket « checkpointer_db »
utilise le socket « backend »
utilise le socket « backend »
utilise le socket « backend »
utilise le socket « storage »
utilise le socket « metadata_store »
utilise le socket « target_datastore »
utilise le socket « backend »
utilise le socket « databases »
utilise le socket « etcd »
utilise le socket « backend »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « state_store »
utilise le socket « forward_target »
utilise le socket « backend »
utilise le socket « cache »
utilise le socket « chunk_cache »
utilise le socket « scrape_target »
utilise le socket « backend »
utilise le socket « backend »
utilise le socket « database »
s’applique à
s’applique à
s’applique à
implémente
implémente