A software upgrade replaces Kafka software or related components with newer versions to improve security, stability, functionality, or compatibility. In a managed cloud service, providers often handle upgrades and broker management; self-managed clusters require teams to plan and execute them safely. section 11.0 section 11.6
Treat a Kafka upgrade as an ecosystem change rather than an isolated broker replacement:
- Verify operating-system support, Java runtime compatibility, and supported versions for Kafka brokers, Kafka Connect, Schema Registry, REST Proxy, and client libraries. section 11.1
- Consult the compatibility matrix and migration guide, paying attention to inter.broker.protocol.version, message-format changes, and client compatibility. section 11.1
- Stage the change carefully and automate production procedures with Ansible or Terraform where appropriate. section 11.1
- Avoid indefinite postponement: version gaps increase the effort and disruption of catching up while leaving clusters exposed to known bugs and missed improvements. section 11.1 section 11.6
Self-managed Kafka upgrade
Before upgrading a production cluster, an operations team checks the host operating system and JRE, verifies broker and ecosystem versions against the compatibility matrix, reviews the release migration guide, and automates the approved procedure. The team treats Kafka Connect, Schema Registry, REST Proxy, and clients as part of the same compatibility boundary. section 11.1




