KafkaCluster CR Examples

The following KafkaCluster custom resource examples show you some basic use cases. You can use these examples as a base for your own Kafka cluster.

KafkaCluster CR with detailed explanation

This is our most descriptive KafkaCluster CR. You can find a lot of valuable explanation about the settings.

Kafka cluster with monitoring

This is a very simple KafkaCluster CR with Prometheus monitoring enabled.

Kafka cluster with ACL, SSL, and rack awareness

You can read more details about rack awareness here.

Kafka cluster with broker configuration

Kafka cluster with custom SSL certificates for external listeners

You can specify custom SSL certificates for listeners.
For details about SSL configuration, see Securing Kafka With SSL.

Kafka cluster with SASL

You can use SASL authentication on the listeners. For details, see Expose the Kafka cluster to external applications.

Kafka cluster with load balancers and brokers in the same availability zone

You can create a broker-ingress mapping to eliminate traffic across availability zones between load balancers and brokers by configuring load balancers for brokers in same availability zone.

Kafka cluster with Istio

You can use Istio as the ingress controller for your external listeners. Koperator now uses standard Istio resources (Gateway, VirtualService) instead of the deprecated banzaicloud istio-operator, providing better compatibility and working with any Istio installation.

Kafka cluster with custom advertised address for external listeners and brokers

You can set custom advertised IP address for brokers.
This is useful when you’re advertising the brokers on an IP address different from the Kubernetes node IP address.
You can also set custom advertised address for external listeners.
For details, see Expose the Kafka cluster to external applications.

Kafka cluster with Kubernetes scheduler affinity settings

You can set node affinity for your brokers.

Kafka cluster with custom storage class

You can configure your brokers to use custom storage classes.

Kafka cluster with KRaft mode (ZooKeeper-free)

You can deploy Kafka clusters using KRaft mode, which eliminates the need for ZooKeeper by using Kafka’s built-in consensus mechanism. This is the future of Kafka and is recommended for new deployments.

For detailed information about KRaft configuration and deployment, see KRaft Mode (ZooKeeper-free Kafka).

Last modified October 13, 2025: Update gh-pages build setup (6fad93e)