FeatureRecipe

dotenv-referenced-secret

Compose realization of core/referenced-secret, for local development. It delivers origin — from values or infra, whichever carries it — under values.key on the consuming component's inject pipe, and a compose Recipe reading the slot writes that value into the emitted docker-compose file, exactly as authored. A literal origin therefore lands in the file as the credential itself. An origin written as a Compose variable reference, such as ${DIFY_DB_PASSWORD}, lands as that reference instead, and Docker Compose substitutes it when the stack starts — from the shell environment, a file named with --env-file, or a .env file in the project directory — and substitutes an empty string, with a warning, for a variable it cannot resolve and that names no default. The compiler neither reads nor writes a .env file; whoever starts the stack maintains it. Docker Compose has no secret resource for a consumer to reference, so this realization emits none and the name it publishes is empty; the key it publishes is values.key, the name the value travels under. origin is therefore the value, never the name of a Secret. Reach for it under Docker Compose; on Kubernetes reach for helm/k8s-existing-secret, helm/k8s-external-secret or helm/k8s-secret-from-parameter.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:7cc51fb65e6c4d82ec3769431f19b232866b8a1d26e65096260a9ee458f95c3d
Published
2026-11-15T08:09:01Z
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:766053a6e3147f4fc5d6bf3add0fdfc6ae603e7136295a7c7e17efda385694ef

Reference at this version

oci://hub.aggrega.ai/featurerecipe/compose/dotenv-referenced-secret:1.0.0
Target
—
Implements
core/referenced-secret:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
name
key{{ .values.key }}

Inject mapping

{{ .values.key | toJson }}: {{ optional .values "origin" (optional .infra "origin" "") | toJson }}

Workload

No workload template declared.

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/referenced-secret: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.

FeatureRecipe 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