Streaming

rpk cluster storage unmount

Unmount a topic from the Redpanda cluster and secure it in Tiered Storage.

This command performs an operation that: 1. Rejects all writes to the topic 2. Flushes data to Tiered Storage 3. Removes the topic from the cluster.

Key Points:

  • During unmounting, any attempted writes or reads will receive an UNKNOWN_TOPIC_OR_PARTITION error.

  • The unmount operation works independently of other topic configurations like remote.delete=false.

  • After unmounting, the topic can be remounted to this cluster or a different cluster if the log segments are moved to that cluster’s Tiered Storage.

Usage

rpk cluster storage unmount <topic> [flags]

Examples

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

Unmount topic '<my-topic>' from the cluster in the '<my-namespace>'.

rpk cluster storage unmount <my-namespace>/<my-topic>

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.