Recipe

ferretdb

A MongoDB-wire-compatible document-database proxy on Kubernetes via the helm provider's Workload synthesis. The proxy process holds no local state, so it renders a stateless Deployment plus a ClusterIP Service on the wire port. The PostgreSQL backend identity resolved from the `backend` uses-edge (host, port, user, database) arrives on .context.inject.env and is composed into the proxy's PostgreSQL connection URL; the URL is rendered password-free and the password is supplied separately on the standard libpq PGPASSWORD environment variable, which the driver merges into the connection. provides.host is the bare, self-contained in-cluster service name of the synthesized Service — it carries no namespace, so the recipe is independent of where it is deployed. A consumer in another namespace qualifies the host with the target namespace on its own side (caller-side routing). FerretDB's debug listener, port 8088, checks no caller and serves /debug/pprof, /debug/vars, /debug/archive and /debug/graphs beside its metrics at /debug/metrics. While `values.metrics_enabled` is false the Recipe binds it to the pod's loopback address, which no other pod reaches, and provides.metrics_endpoint is empty. True, it binds it on every interface of the pod, its port joins the ClusterIP Service, and provides.metrics_endpoint publishes its /debug/metrics there, so every in-cluster caller that reaches the pod reaches the whole listener. Neither probe uses it: readiness runs `ferretdb ping` inside the container, and liveness checks that the wire port accepts connections.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:5978134fd7fb6706012aaad35346fb64785cd34d3cefd7e1bca4b5ebe58ecba0
Published
2026-11-10T10:23: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:169d627e0f0d55d7884733705ab4ac5b2bd052b06081f101a7c544b27b25b212

Reference at this version

oci://hub.aggrega.ai/recipe/helm/ferretdb:1.0.0
Target
—
Implements
core/datastore/ferretdb:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.rendered_name }}-default
port{{ .infra.port }}
protocolmongodb
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.rendered_name }}-default:8088/debug/metrics{{ end }}

Workload

Workload · replicas: 1 · containers: main

Locals

No locals declared.

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/ferretdb: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.

Recipe 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