Alauda Streaming Service for Kafka

Upgrade

NOTE

This document provides the upgrade path principles and supported version compatibility for Alauda Streaming Service for Kafka.

TOC

Compatibility Matrix

The table below lists supported versions of the Alauda Streaming Service for Kafka and its key components:

Alauda Kafka VersionKafka VersionsKubernetes Versions
v4.1.x3.8.1, 2.8.2 (with plugin)1.25+
v4.0.x3.8.1, 2.8.2 (with plugin)1.25+
Optional Deployment

For versions that support Kafka 2 (marked as with plugin in the table), you can manage Kafka 2.x instances by installing the Alauda build of the Kafka 2 plugin.

Prerequisites

Before initiating an upgrade, please ensure the following:

  1. Version Compatibility: Your current version falls within a supported upgrade path.
  2. Component Health: Kafka instances are in a Ready state.
  3. Resource Availability: The cluster has sufficient resources to support the upgrade process.

For version-specific changes, new features, and deprecations, see the 📝 Release Notes.

Upgrade Path Guidelines

  • Description: Upgrade step-by-step through consecutive minor versions.
  • Example: 4.1.x → 4.2.x

Patch-Level Upgrade

  • Description: Upgrades between any patch versions within the same minor version are fully compatible and can be performed directly.
  • Example: 4.1.0 → 4.1.x

Kafka Version Alignment

  • Description: Ensure Kafka version upgrades follow the operator's compatibility matrix.
  • Example: Alauda Streaming Service for Kafka 4.1.0 supports Kafka 3.8.1 or Kafka 2.8.2 (with plugin).

Upgrade strategy

Alauda Streaming Service for Kafka will execute upgrades based on the configured upgrade strategy:

  • Automatic : Auto-upgrades are triggered immediately upon detecting new component versions.
  • Manual : Requires manual approval before initiating the upgrade process.