Upgrade

NOTE

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

Compatibility Matrix

The table below lists supported versions of the Alauda Streaming Service for RabbitMQ :

Alauda RabbitMQ VersionRabbitMQ VersionsKubernetes Versions
v4.1.x3.8.16, 3.12.x1.25+
v4.0.x3.8.16, 3.12.x1.25+

Prerequisites

Before initiating an upgrade, please ensure the following:

  1. Version Compatibility: Your current version falls within a supported upgrade path.
  2. Component Health: RabbitMQ clusters are in a Ready state and all pods are healthy.
  3. Resource Availability: The cluster has sufficient resources to support the upgrade process.
Note

Some RabbitMQ versions may require specific feature flags to be enabled. Please refer to the release notes for version-specific instructions.

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

RabbitMQ Version Alignment

  • Description: Ensure RabbitMQ version upgrades follow the operator's compatibility matrix.

Upgrade strategy

Alauda Streaming Service for RabbitMQ 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.