本页面为机器翻译。阅读英文原文。

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.

来源

官方由本目录认定为官方发布者的签名身份签名。
内容摘要
sha256:8f0098d60a8139139f99ea1d548e2ce9fcdf57ae40e8e89e208daf82dd92e4a2
发布时间
2026-11-10T10:10:33Z
签名身份
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

签名

  • 官方application/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

此版本的引用

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

开发者参数

开发者在 Aggregate 中设置的值。

名称类型默认值必需描述
userstringpostgres否Application database user created on startup (POSTGRES_USER).
databasestringpostgres否Logical database name created on startup (POSTGRES_DB).

运维规格

运维人员按环境调整的基础设施规格。

名称类型默认值必需描述
portinteger (min 1024, max 65535)5432否Server listen port. Most operators should omit this and let the Recipe assign the default (5432).
engine_versionstring17-0.107.0-ferretdb-2.7.0否Backend image tag (PostgreSQL major version plus the DocumentDB extension build).
computeobject—否—
storageobject—否—
overridesobject (open)—否Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

输出契约

此组件通过 uses 拓扑向使用方发布的值。

名称类型默认值必需描述
hoststring—是Address a client opens its database connection to. On the in-cluster realizations it is the Service's DNS name.
portinteger—是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.
userstring—否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.
databasestring—否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.
protocolstring—否Wire protocol the published address speaks — `postgres`, so a consumer chooses a PostgreSQL client even though what it stores is documents.

uses 套接字

此组件用于建立连接的依赖套接字。通过某个套接字接入的每个连接,其目标都必须满足该套接字的标签选择器,且每个连接都可以在该套接字声明的槽位中携带附加项。必需槽位须由 Aggregate 或 Release 通过该套接字接入的每个连接来填充。

未声明 uses 套接字。

附加槽位

Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。

槽位选择器必需注入敏感描述
passwordfeature.aggrega.ai/kind=secret否env是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.

自注入允许列表

env

关系

与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。

使用

此实体未使用目录中的任何内容。

被使用

Component 概念参考 →

Aggrega 目录 — 收录组件、功能、配方以及渲染它们的插件的开放索引。

基于共享的 Aggrega 设计系统构建。

隐私