Recipe

keycloak-chart

Keycloak, a database-backed identity and access-management server, on Kubernetes via the codecentric Keycloak.X Helm chart, served from that project's HTTPS chart repository. What it encodes that a hand-assembled workload does not is the cluster-forming configuration: a StatefulSet with ordered pod management behind a headless Service, the database-backed cache stack the server replicates sessions over, and probes aimed at the server's own management endpoint. The chart's Ingress, Route, autoscaler, network policy and monitoring resources are left switched off, and the server image and the chart version are pinned. Reach for this realization where a chart repository is reachable at build time and the server will be run as more than one replica; reach for `keycloak`, the workload-synthesis realization, where the build must complete with nothing fetched. With `infra.external_base_url` set, the server's hostname is that full URL, delivered through the chart's `extraEnv`, so the issuer and every address the server advertises follow it; unset, the server takes its address from each incoming request. The chart serves the server under the path `/auth`, so an ingress in front of it maps the address's path onto that one. The chart serves the server's metrics, at /auth/metrics on the management port its console Service carries, whatever `values.metrics_enabled` says; that port checks no caller. True publishes the address as provides.metrics_endpoint; false leaves that key empty. That Service, and the management port with it, stays inside the cluster whatever `infra.overrides.service_type` says; LoadBalancer or NodePort publishes the console alone on `<rendered_name>-external`.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:221e2f6e7748d931566aa51ce7f51386f9183c2be38f3ecd79152f486ae65141
Published
2026-11-10T10:24:29Z
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:9c2a3406a57436e483ca1ddd60c271b859f0dd221b47082270df1dca1f25a601

Reference at this version

oci://hub.aggrega.ai/recipe/helm/keycloak-chart:1.0.0
Target
—
Implements
core/security/keycloak:1.0.0

Provides

Deterministic pointer templates this recipe wires for consumers.

NameTemplate
host{{ .context.rendered_name }}-http
port{{ .infra.http_port }}
protocolhttp
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.rendered_name }}-http:9000/auth/metrics{{ end }}

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/security/keycloak: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