[jira] [Created] (KAFKA-14720) Tools migration guidelines

["Federico Valeri (Jira)" <ji...@apache.org>]

Federico Valeri created KAFKA-14720:
---------------------------------------

             Summary: Tools migration guidelines
                 Key: KAFKA-14720
                 URL: https://issues.apache.org/jira/browse/KAFKA-14720
             Project: Kafka
          Issue Type: Improvement
            Reporter: Federico Valeri


The tools migration effort is ongoing and being tracked in KAFKA-14525. This is part of a bigger initiative to split the core module into multiple modules (e.g. storage, network, security, tools), which is being tracked in KAFKA-14524.

The plan is to migrate tools and related classes in a fully compatible way from kafka.tools and kafka.admin packages (core module) to org.apache.kafka.tools package (tools module).

While kicking off this activity, we identified a number of potential compatibility issues:

* Missing wrapper: some tools do not have a wrapper script. There are system tests that directly refer to the tool's fully qualified class name (FQCN) and expect the old package name when running on old Kafka releases. They are often used for troubleshooting or automation through the “kafka-run-class.sh” script which takes the FQCN as input parameter.
* SPI argument: some tools have arguments for setting a custom SPI implementation to be used in place of the default implementation. Any custom SPI implementation depends on the old package name.
* Broken tool: some tools do not work on supported releases.
* Core dependency: some tools require access to non-trivial core classes that should be migrated first.

See KIP-906 for more information.



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