rpk shadow create

Creates a Redpanda shadow link.

This command creates a shadow link using a configuration file that defines the connection details and synchronization settings.

Before you create a shadow link, generate a configuration file with rpk shadow config generate and update it with your source cluster details. The command prompts you to confirm the creation. Use the --no-confirm flag to skip the confirmation prompt.

When creating a shadow link in Redpanda Cloud, use the --for-cloud flag.

First log in and select the cluster where you want to create the shadow link before running this command. See rpk cloud login and rpk cloud select. For SCRAM authentication, store your password in the shadow cluster’s secrets store (using either the cluster’s secret store or rpk security secret), then reference it in your configuration file using ${secrets.SECRET_NAME} syntax.

After you create the shadow link, use rpk shadow status to monitor the replication progress.

Usage

rpk shadow create [flags]

Examples

Create a shadow link using a configuration file:

rpk shadow create --config-file shadow-link.yaml

Create a shadow link without a confirmation prompt:

rpk shadow create -c shadow-link.yaml --no-confirm

Flags

Value Type Description

-c, --config-file

string

Path to configuration file to use for the shadow link; use --help for details.

--no-confirm

-

Disable confirmation prompt.

-h, --help

-

Help for create.

--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.