Cloud

rpk cluster storage mount

This command is only supported in BYOC and Dedicated clusters.

Mount a topic to the Redpanda cluster from Tiered Storage.

This command mounts a topic in the Redpanda cluster using log segments stored in Tiered Storage. The topic may be optionally renamed with the --to flag.

Requirements:

  • Tiered Storage must be enabled.

  • Log segments for the topic must be available in Tiered Storage.

  • A topic with the same name must not already exist in the cluster.

Usage

rpk cluster storage mount <topic> [flags]

Examples

This section provides examples of how to use rpk cluster storage mount.

Mounts topic <my-topic> from Tiered Storage to the cluster in the <my-namespace>.

rpk cluster storage mount <my-topic>

Mount topic <my-topic> from Tiered Storage to the cluster in the <my-namespace> with <my-new-topic> as the new topic name.

rpk cluster storage mount <my-namespace>/<my-topic> --to <my-namespace>/<my-new-topic>

Flags

Value Type Description

--to

string

New namespace/topic name for the mounted topic (optional).

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.