rpk k8s multicluster

Commands for bootstrapping and managing the multicluster operators that run a Redpanda Stretch Cluster: a single logical Redpanda cluster distributed across multiple Kubernetes clusters. One operator runs in each Kubernetes cluster, and the operators coordinate through Raft consensus to manage the Stretch Cluster as a single unit.

This command was introduced in k8s version 26.2.1.

Usage

rpk k8s multicluster [flags]

Subcommands

Command Description

rpk k8s multicluster bootstrap

Bootstrap the TLS certificates and kubeconfig secrets that the multicluster operators of a Redpanda Stretch Cluster need to communicate across Kubernetes clusters. This command connects to each specified Kubernetes context, generates a shared CA certificate, and distributes per-cluster TLS certificates and kubeconfig secrets so that the multicluster operator can communicate across clusters.

rpk k8s multicluster bundle

Collects environment data from each Kubernetes cluster in a Redpanda Stretch Cluster deployment and packages it into a ZIP file for support. This is the operator-side counterpart to rpk debug bundle, which collects data from the Redpanda brokers themselves.

rpk k8s multicluster status

Checks the health of the multicluster operators that run a Redpanda Stretch Cluster: each cluster’s operator pod health, raft consensus state, TLS certificate validity, and cross-cluster consistency. Connects to each specified Kubernetes context, finds the multicluster operator pod, port-forwards to its gRPC transport, and queries raft status.

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.