[jira] [Created] (KAFKA-14941) Document which configuration options are applicable only to processes with broker role or controller role

["Jakub Scholz (Jira)" <ji...@apache.org>]

Jakub Scholz created KAFKA-14941:
------------------------------------

             Summary: Document which configuration options are applicable only to processes with broker role or controller role
                 Key: KAFKA-14941
                 URL: https://issues.apache.org/jira/browse/KAFKA-14941
             Project: Kafka
          Issue Type: Improvement
            Reporter: Jakub Scholz


When running in KRaft mode, some of the configuration options are applicable only to nodes with the broker process role and some are applicable only to the nodes with the controller process roles. It would be great if this information was part of the documentation (e.g. in the [Broker Configs|https://kafka.apache.org/documentation/#brokerconfigs] table on the website), but if it was also part of the config classes so that it can be used in situations when the configuration is dynamically configured to for example filter the options applicable to different nodes. This would allow having configuration files with only the actually used configuration options and for example, help to reduce unnecessary restarts when rolling out new configurations etc.

For some options, it seems clear and the Kafka node would refuse to start if they are set - for example the configurations of the non-controler-listeners in controller-only nodes. For others, it seems a bit less clear (Does {{compression.type}} option apply to controller-only nodes? Or the configurations for the offset topic? etc.).



--
This message was sent by Atlassian Jira
(v8.20.10#820010)