rpk k8s multicluster status

Check the health of the multicluster operators that run a Stretch Cluster: 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. Also inspects Deployment configuration and TLS secrets for correctness.

Usage

rpk k8s multicluster status [flags]

Examples

This section provides examples of how to use rpk k8s multicluster status.

Check status across all clusters in a kubeconfig:

rpk k8s multicluster status --kubeconfig /path/to/kubeconfig

Check specific clusters:

rpk k8s multicluster status \
  --context cluster-a --context cluster-b --context cluster-c

Override the TLS secret prefix per context (when Helm release names differ from context names):

rpk k8s multicluster status \
  --context cluster-a --context cluster-b \
  --name-override cluster-a=redpanda-operator \
  --name-override cluster-b=rp-operator

Flags

Value Type Description

--context

strings

Kubernetes contexts. Repeatable. If omitted with --kubeconfig, all contexts in the file are used.

--kubeconfig

string

Path to a kubeconfig file (all contexts in the file are used unless --context is also specified).

--name-override

stringArray

Override the TLS secret prefix for a context, in context=prefix format. Defaults to the context name. Repeatable.

--namespace

string

Namespace for operator resources (default redpanda).

--service-name

string

Operator deployment label selector value (app.kubernetes.io/name) (default operator).

Global flags

Value Type Description

--config

string

Redpanda or rpk config file; default search paths are ~/Library/Application Support/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.