Streaming

rpk cluster upgrade

Check and finalize major-version upgrades. When the cluster configuration features_auto_finalization is disabled, an upgrade stays pending after all brokers are on the new version, so you can downgrade while soak-testing.

Usage

rpk cluster upgrade [flags]

Subcommands

Command Description

rpk cluster upgrade finalize

Finalize a deferred cluster upgrade. This commits the cluster to the version all brokers report, activating version-gated features and advancing the active cluster version.

rpk cluster upgrade status

Show the cluster upgrade finalization status. This reports where the cluster sits in the upgrade-finalization lifecycle as seen by the controller leader: the high-level state (finalized, ready to finalize, or upgrade in progress), the active and post-finalization logical versions, whether auto-finalization is enabled, and a per-broker breakdown of reported versions and liveness.

Global flags

Value Type Description

--config

string

Redpanda or rpk config file; default search paths are ~/.config/rpk/rpk.yaml, $PWD/redpanda.yaml, and /etc/redpanda/redpanda.yaml.

-X, --config-opt

stringArray

Override rpk configuration settings; -X help for detail or -X list for terser detail.

--ignore-profile

bool

Ignore rpk.yaml and redpanda.yaml; use default settings.

--profile

string

rpk profile to use.

-v, --verbose

bool

Enable verbose logging.