FeatureRecipe

k8s-existing-secret

Points a workload at a Kubernetes Secret that already exists in the namespace it runs in. origin — from values or infra, whichever carries it — is read as that Secret's name and values.key as the data key inside it, and both are published exactly as written, as the locator a consuming workload references with a secretKeyRef or a chart reads through its existing-secret setting, so an operator can name the Secret in the Release. It renders no resource of its own, so the credential material never passes through an authored file or a rendered artifact: whoever deploys creates the Secret, and a workload referencing a Secret that does not exist fails to start rather than starting with a default. Because the name is published as written, it must already be a valid Kubernetes object name, and an empty origin names no Secret, so the build halts on it, naming the component. Reach for this realization where the Secret already exists in the target namespace — created by hand, by a pipeline, or by a tool outside the Release. Reach for k8s-external-secret where a secret-store operator runs in the cluster and should fetch the credential from its store, and for k8s-secret-from-parameter where neither holds and the material may sit in the rendered output, as it may for evaluation.

Version

1.0.01.0.1

Provenance

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

Reference at this version

oci://hub.aggrega.ai/featurerecipe/helm/k8s-existing-secret:1.0.1
Target
—
Implements
core/referenced-secret:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
name{{ optional .values "origin" (optional .infra "origin" "") }}
key{{ .values.key }}

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