Recipe

keycloak

Keycloak, a database-backed identity and access-management server, on Kubernetes via the helm provider's Workload synthesis (a stateless Deployment plus a ClusterIP Service on the HTTP port). Keycloak holds no local state — the PostgreSQL backend is the system of record — so it renders stateless, and it provisions and migrates its own schema on startup. Reach for this realization where the build must complete with nothing fetched, or where no chart repository is reachable from it; reach for `keycloak-chart`, which renders the codecentric Keycloak.X chart, where the server will be scaled out — that realization carries the ordered pods, the headless Service and the replicated cache stack a single synthesized Deployment does not. With `infra.external_base_url` set, the server's hostname is that full URL, so the issuer and every address the server advertises follow it; unset, the server takes its address from each incoming request. With no credential attached — on the backend connection for the database password, on the admin_password slot for the bootstrap admin password — each takes an inline development default; with one attached, each is supplied via the credential subsystem. With `values.metrics_enabled` true, the server's metrics are switched on and the management port joins the Service, so its metrics and health endpoints, which check no caller, answer at the Service name; the address is published as provides.metrics_endpoint. False, that key is empty and the port stays off the Service.

Provenance

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
Content digest
sha256:72e0265a4315e211699320a4d7f1e5335926c6ab1bfd172c47f4455d071fb238
Published
2026-11-10T10:24:31Z
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:da0d4322db9c430c234dfe1b05422caf65e07dbc428981d5c6a00b9e5f4e0573

Reference at this version

oci://hub.aggrega.ai/recipe/helm/keycloak: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 }}-default
port{{ .infra.http_port }}
protocolhttp
metrics_endpoint{{ if .values.metrics_enabled }}http://{{ .context.rendered_name }}-default:{{ .infra.management_port }}/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/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