Cloud

rpk shadow config generate

Generate a configuration file for creating a Shadow Link.

By default, this command creates a sample configuration file with placeholder values that you can customize for your environment. If you are generating a Shadow Link for Redpanda Cloud, use the --for-cloud flag.

Use the --print-template flag to generate a configuration template with detailed field documentations.

By default, this command prints the configuration to standard output. Use the --output flag to save the configuration to a file.

After you generate the configuration file, update the placeholder values with your actual connection details and settings. Then use rpk shadow create to create the Shadow Link.

Use the --for-cloud flag when generating your configuration.

Usage

rpk shadow config generate [flags]

Examples

This section provides examples of how to use rpk shadow config generate.

Generate a sample configuration and print it to standard output:

rpk shadow config generate

Generate a configuration template with all the field documentation:

rpk shadow config generate --print-template

Save the sample configuration to a file:

rpk shadow config generate -o `shadow-link.yaml`

Save the template with documentation to a file:

rpk shadow config generate --print-template -o `shadow-link.yaml`

Flags

Value Type Description

--for-cloud

bool

Generate configuration suitable for Redpanda Cloud.

-o, --output

string

File path to save the generated configuration file. If not specified, prints to standard output.

--print-template

bool

Generate a configuration template with field descriptions instead of a sample configuration.

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.

Suggested reading