Component

core/security/external-secrets

An external-secrets operator that synchronizes secrets from external secret-management systems into native Kubernetes Secrets. external-secrets is a cluster-scoped add-on that reads material from providers such as HashiCorp Vault, AWS Secrets Manager, Google Secret Manager, or Azure Key Vault and materializes it as in-cluster Secrets, keeping them in sync as the source changes. It extends the cluster with its own ExternalSecret, SecretStore, ClusterSecretStore, and related custom resources; applications obtain their secrets by declaring those resources rather than by wiring a topology edge, so the component takes no `uses` edge, and what it publishes is where Prometheus finds its metrics. A controller reconciles ExternalSecret resources, a webhook validates and defaults the custom resources, and a certificate controller manages the webhook's serving certificate. external-secrets is realized on Kubernetes through its Helm Recipe (the official chart); it has no standalone local-container form, so no Compose Recipe is provided. Each of the three serves its own metrics on a port no Service carries, so the Recipe publishes the pod label selecting all three, the name of their metrics port and the path, for a scraper that discovers those pods directly.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:d76b736baf7e613554f419281acbd968363230eaa378795645e02d8b7f32c372
Published
2026-11-10T10:13:26Z
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:75f07e452eb25e6d58cd42ab853a21ec192741c07aa4c208e70005db47becbde

Reference at this version

oci://hub.aggrega.ai/component/core/security/external-secrets:1.0.0

Developer parameters

Values the developer sets in the Aggregate.

NameTypeDefaultRequiredDescription
install_crdsbooleantruenoWhether this component installs external-secrets' custom resource definitions (ExternalSecret, SecretStore, ClusterSecretStore, and the related push and generator resources). Leave on to bring the external-secrets API into the cluster; set false when the CRDs are managed out of band or already present.

Operator sizing

Infrastructure sizing the operator tunes per environment.

NameTypeDefaultRequiredDescription
source_versionstring—noSource artifact version (Helm chart). Overrides the Recipe's default source version. Changing from default does not guarantee value mapping compatibility.
computeobject—no—
overridesobject (open)—noProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Output contract

Values this component publishes to consumers over the uses topology.

NameTypeDefaultRequiredDescription
metrics_pod_selectorstring—noKubernetes label selector matching the controller, webhook and certificate controller pods, for a scraper that discovers those pods directly rather than scraping one address. Published beside `metrics_pod_port` and `metrics_path`.
metrics_pod_portstring—noName of the container port on those pods that carries the metrics, `metrics`.
metrics_pathstring—noPath the metrics are served at on that port, `/metrics`.

Uses sockets

The dependency sockets this component connects through. The target of every connection wired through a socket must satisfy its label selector, and each connection may carry an attachment in the slots the socket declares. A required slot is owed by each connection the Aggregate or the Release wires through the socket.

No uses sockets declared.

Attachment slots

Named binding points at which a Feature attaches to this component. A slot's selector constrains which Feature may fill it and its inject list names how the Feature's material may be delivered. A required slot must be bound on every instance, by an attachment on the instance or at a scope above it, and a sensitive slot is declared to handle secret material. A Feature may also attach under a name no slot declares.

No attachment slots declared.

Self-inject allowlist

No self-inject pipes 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

This entity uses nothing in the catalog.

Used by

Component 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