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

OfficialSigned by a signing identity this catalog recognizes as an official publisher.
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.

NameTemplate
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.

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