14.3. Listener naming conventions
From the listener configuration, the resulting listener bootstrap and per-broker service names are structured according to the following naming conventions:
| Listener type | Bootstrap service name | Per-Broker service name |
|---|---|---|
|
| <cluster_name>-kafka-bootstrap | Not applicable |
|
| <cluster_name>-kafka-<listener-name>-bootstrap | <cluster_name>-kafka-<listener-name>-<idx> |
For example, my-cluster-kafka-bootstrap, my-cluster-kafka-external1-bootstrap, and my-cluster-kafka-external1-0. The names are assigned to the services, routes, load balancers, and ingresses created through the listener configuration.
You can use certain backwards compatible names and port numbers to transition listeners initially configured under the retired KafkaListeners schema. The resulting external listener naming convention varies slightly. These specific combinations of listener name and port configuration values are backwards compatible:
| Listener name | Port | Bootstrap service name | Per-Broker service name |
|---|---|---|---|
|
|
| <cluster_name>-kafka-bootstrap | Not applicable |
|
|
| <cluster-name>-kafka-bootstrap | Not applicable |
|
|
| <cluster_name>-kafka-bootstrap | <cluster_name>-kafka-bootstrap-<idx> |