Recipe
kafka
Apache Kafka single-node KRaft on Kubernetes via the helm provider's Workload synthesis (a StatefulSet with a per-replica data volume, a ClusterIP Service exposing the client bootstrap port, and a headless governing Service). Nothing has to be installed in the cluster first and no chart repository has to be reachable, so this is the realization to reach for where no Kafka control plane runs and where the build has to complete without network access; reach for the controller-driven recipe where the Strimzi Cluster Operator is already in place. The node runs the broker and controller roles in one process (no ZooKeeper) and stores its commit log on the persistent volume at /var/lib/kafka/data so log data survives restarts. The cluster identity is supplied verbatim through CLUSTER_ID from the developer value, and the image reads it as-is with no random generation, so the rendered manifest is byte-identical across builds. KAFKA_ADVERTISED_LISTENERS advertises the in-cluster Service name so clients reconnect through the stable address rather than the pod's own hostname. provides.host is the bare, self-contained in-cluster service name of the synthesized Service — it carries no namespace, so the recipe is independent of where it is deployed. A consumer in another namespace qualifies the host with the target namespace on its own side (caller-side routing). The image serves no Prometheus metrics, so the metrics keys are published empty and values.metrics_enabled true halts the build. The Java heap is half infra.compute.memory, in whole Mi or Gi. With infra.client_tls true the client port serves TLS alone from the Secret attached to server_certificate, mounted as files, and protocol is kafka-ssl.
Provenance
- Content digest
- sha256:6087a5502ca245a227f58a76e8eb35505cf63412326ce40f259220c770faa5a7
- Published
- 2026-11-10T10:24:23Z
- 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:3ffc8bd8f38fc5ad136b628c1ef9cb741f15fc1c30e3e95c1669bdc87c4c04e2
Reference at this version
oci://hub.aggrega.ai/recipe/helm/kafka:1.0.0- Target
- —
- Implements
- core/messaging/kafka:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
| Name | Template |
|---|---|
| host | {{ .context.rendered_name }}-default |
| port | {{ .infra.broker_port }} |
| bootstrap_servers | {{ .context.rendered_name }}-default:{{ .infra.broker_port }} |
| protocol | {{ if .infra.client_tls }}kafka-ssl{{ else }}kafka{{ end }} |
| metrics_pod_selector | |
| metrics_pod_port | |
| metrics_path |
Workload
Workload · form: stateful · 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/messaging/kafka: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.