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

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:8f0098d60a8139139f99ea1d548e2ce9fcdf57ae40e8e89e208daf82dd92e4a2
Published
2026-11-10T10:10:33Z
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:9bd69b3849e2f834bf9c38c463c7f4c072cde4377dbabbe90e39b1a8da422254

Reference at this version

oci://hub.aggrega.ai/component/core/datastore/documentdb:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

NameTypeDefaultRequiredDescription
userstringpostgresnoApplication database user created on startup (POSTGRES_USER).
databasestringpostgresnoLogical database name created on startup (POSTGRES_DB).

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
portinteger (min 1024, max 65535)5432noServer listen port. Most operators should omit this and let the Recipe assign the default (5432).
engine_versionstring17-0.107.0-ferretdb-2.7.0noBackend image tag (PostgreSQL major version plus the DocumentDB extension build).
computeobject—no—
storageobject—no—
overridesobject (open)—noProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Output contract

Values this component publishes to consumers over the uses topology.

NameTypeDefaultRequiredDescription
hoststring—yesAddress a client opens its database connection to. On the in-cluster realizations it is the Service's DNS name.
portinteger—yesTCP 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.
userstring—noName 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.
databasestring—noName 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.
protocolstring—noWire protocol the published address speaks — `postgres`, so a consumer chooses a PostgreSQL client even though what it stores is documents.

Uses sockets

The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.

No uses sockets declared.

Attachment slots

Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.

SlotSelectorRequiredInjectSensitiveDescription
passwordfeature.aggrega.ai/kind=secretnoenvyesOptional 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.

Self-inject allowlist

env

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

This entity uses nothing in the catalog.

Used by

Component 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