24.1 beta 23.3 23.2 23.1

rpk redpanda admin brokers decommission

This command is not supported on macOS, Windows.

Decommission the given broker.

Decommissioning a broker removes it from the cluster.

A decommission request is sent to every broker in the cluster, only the cluster leader handles the request.

For safety on v22.x clusters, this command will not run if the requested broker is in maintenance mode. As of v23.x, Redpanda supports decommissioning a node that is currently in maintenance mode. If you are on a v22.x cluster and need to bypass the maintenance mode check (perhaps your cluster is unreachable), use the hidden --force flag.

Usage

rpk redpanda admin brokers decommission [BROKER ID] [flags]

Flags

Value Type Description

-h, --help

-

Help for decommission.

--config

string

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

-X, --config-opt

stringArray

Override rpk configuration settings. See rpk -X or execute rpk -X help for inline detail or rpk -X list for terser detail.

--profile

string

Profile to use. See rpk profile for more details.

-v, --verbose

-

Enable verbose logging.