Component
core/datastore/ferretdb
A document-database proxy that speaks the MongoDB wire protocol and stores data in a PostgreSQL backend with the DocumentDB extension. It is typed as a stateful server because the endpoint it presents to consumers is a durable document database: standard database consumers bind it through their database socket exactly as they would a native datastore. The proxy process itself holds no local state — its Recipe renders a stateless workload — but the service contract it exposes is a database, so the type label reflects the consumer-facing contract rather than the internal workload form. It fronts a PostgreSQL/DocumentDB backend wired through its `backend` uses-socket: the backend host, port, user, and database arrive on the injection context and are composed into the proxy's PostgreSQL connection. Exports its host, port, and protocol to consumers via the uses topology. With `values.metrics_enabled` true each Recipe makes FerretDB's own metrics, served at /debug/metrics on its debug listener, port 8088, reachable and publishes that address as `metrics_endpoint`; false, that key is empty. That listener checks no caller and also serves /debug/pprof, with CPU profiles and execution traces on request, /debug/vars, /debug/archive and /debug/graphs. On Kubernetes the value moves it from the pod's loopback address onto every interface of the pod and names its port on the Service, newly opening it to every in-cluster caller that reaches the pod; on Docker Compose the value newly opens it to every peer on the network.
Nguồn gốc
- Digest nội dung
- sha256:bd3375d60235bfff68b81e6f6bdf789dcfe3a506cf77a03a80c3aba13c12cbbf
- Đã xuất bản
- 2026-11-10T10:10:42Z
- Danh tính ký
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Chữ ký
- Chính thứcapplication/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:1fb1023e5afe692195099eabce8cb8fb76855155007b04488ae50867baf42322
Tham chiếu ở phiên bản này
oci://hub.aggrega.ai/component/core/datastore/ferretdb:1.0.0Tham số của nhà phát triển
Các giá trị mà nhà phát triển đặt trong Aggregate.
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| metrics_enabled | boolean | false | không | Makes FerretDB's own metrics, in the Prometheus format at /debug/metrics on port 8088, reachable and publishes their address as `metrics_endpoint`; while false that key is empty. The port checks no caller and also serves /debug/pprof (CPU profiles and execution traces on request), /debug/vars, /debug/archive and /debug/graphs. On Kubernetes the value moves the listener from the pod's loopback address onto every interface and names its port on the Service, newly opening it to every in-cluster caller that reaches the pod; on Docker Compose the value newly opens it to every peer on the network. |
Định cỡ của người vận hành
Định cỡ hạ tầng mà người vận hành tinh chỉnh theo từng môi trường.
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| port | integer (min 1024, max 65535) | 27017 | không | Document-database wire port the proxy listens on. Most operators should omit this and let the Recipe assign the default (27017). |
| engine_version | string | 2.7.0 | không | Proxy container image tag. |
| compute | object | — | không | — |
| overrides | object (open) | — | không | Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads. |
Hợp đồng đầu ra
Các giá trị mà thành phần này xuất bản cho bên tiêu thụ qua cấu trúc liên kết uses.
| Tên | Kiểu | Mặc định | Bắt buộc | Mô tả |
|---|---|---|---|---|
| host | string | — | có | Address a client opens its document-database connection to. On the in-cluster realizations it is the Service's DNS name. |
| port | integer | — | có | TCP port the proxy accepts connections on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default. |
| protocol | string | — | không | Wire protocol the published address speaks — `mongodb`, so a consumer uses a MongoDB driver and never has to know a PostgreSQL backend is behind it. |
| metrics_endpoint | string | — | không | The full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:8088/debug/metrics`, the host being the proxy's Service name. Empty while values.metrics_enabled is false. |
Các socket uses
Các socket phụ thuộc mà thành phần này kết nối qua. Đích của mọi kết nối được nối qua một socket phải thỏa mãn bộ chọn nhãn của socket đó, và mỗi kết nối có thể mang theo phần đính kèm trong các slot mà socket khai báo. Một slot bắt buộc phải được đáp ứng bởi mỗi kết nối mà Aggregate hoặc Release nối qua socket.
backend
- Bộ chọn
- component.aggrega.ai/type=stateful-server
- Tiêm
- env
Các slot mà mỗi kết nối qua socket này có thể lấp đầy
| Slot | Bộ chọn | Bắt buộc | Tiêm | Nhạy cảm | Mô tả |
|---|---|---|---|---|---|
| credential | feature.aggrega.ai/kind=secret | không | env | có | Optional password the proxy presents to the backend this connection reaches, shared with that backend. When attached, supplies the backend password via the credential subsystem. Unattached, compose/ferretdb and helm/ferretdb present the development literal `apppass`, which this catalog publishes, so every Release that leaves the slot unattached shares that password. |
Slot đính kèm
Các điểm liên kết có tên mà tại đó một Feature được gắn vào thành phần này. Bộ chọn của một slot giới hạn Feature nào có thể lấp đầy nó, và danh sách tiêm của slot nêu cách nội dung của Feature có thể được chuyển giao. Một slot bắt buộc phải được liên kết trên mọi thể hiện, bằng một phần đính kèm trên thể hiện đó hoặc ở một phạm vi phía trên nó, và một slot nhạy cảm được khai báo để xử lý nội dung bí mật. Một Feature cũng có thể được gắn dưới một tên mà không slot nào khai báo.
Chưa khai báo slot đính kèm nào.
Danh sách cho phép tự tiêm
env
Quan hệ
Các cạnh có kiểu đi tới và đi từ các thực thể đã xuất bản khác. Một tham chiếu không có đích đã xuất bản được hiển thị là một cạnh bị đứt thay vì một liên kết.
Sử dụng
- sử dụngsử dụng socket «backend»
component.aggrega.ai/type=stateful-server
Slot đính kèm: credential
core/ai-agent/dify-plugin-daemon v1.0.0 →core/ai-tool/filesystem v1.0.0 →core/datastore/chroma v1.0.0 →core/datastore/cognee v1.0.0 →core/datastore/documentdb v1.0.0 →core/datastore/elasticsearch v1.0.0 →core/datastore/etcd v1.0.0 →core/datastore/mariadb v1.0.0 →core/datastore/milvus v1.0.0 →core/datastore/mysql v1.0.0 →core/datastore/mysql-innodb-cluster v1.0.0 →core/datastore/opensearch v1.0.0 →core/datastore/pgvector v1.0.0 →core/datastore/postgres v1.0.0 →core/datastore/qdrant v1.0.0 →core/datastore/timescaledb v1.0.0 →core/datastore/weaviate v1.0.0 →core/devtool/harbor v1.0.0 →core/messaging/kafka v1.0.0 →core/messaging/rabbitmq v1.0.0 →core/observability/fluentd v1.0.0 →core/observability/jaeger v1.0.0 →core/observability/loki v1.0.0 →core/observability/prometheus v1.0.0 →core/observability/tempo v1.0.0 →core/security/openbao v1.0.0 →
Được sử dụng bởi
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «queue»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «queue»
sử dụng socket «backend»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «queue»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «queue»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «queue»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «state_store»
sử dụng socket «checkpointer_db»
sử dụng socket «checkpointer_db»
sử dụng socket «backend»
sử dụng socket «backend»
sử dụng socket «backend»
sử dụng socket «storage»
sử dụng socket «metadata_store»
sử dụng socket «target_datastore»
sử dụng socket «databases»
sử dụng socket «etcd»
sử dụng socket «backend»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «state_store»
sử dụng socket «forward_target»
sử dụng socket «backend»
sử dụng socket «cache»
sử dụng socket «chunk_cache»
sử dụng socket «scrape_target»
sử dụng socket «backend»
sử dụng socket «backend»
sử dụng socket «database»
áp dụng cho
áp dụng cho
áp dụng cho
triển khai
triển khai