Configure Cluster Properties in Kubernetes

When you install Redpanda, it automatically generates a cluster configuration with default settings assigned to each cluster property. You might want to change some of the default settings, particularly if you plan to use features such as rack awareness or Tiered Storage, which are disabled by default.

To configure cluster properties, you must override the defaults in the Redpanda Helm chart’s values using the helm upgrade --install command. Some cluster configuration properties require a restart. By using the helm upgrade --install command, you allow Helm to restart the Pods for you automatically to make the changes take effect. Using Helm to make cluster configuration changes also allows you to replicate, reproduce, and recover your cluster.

To view all cluster properties, along with their descriptions and default settings, see cluster configuration properties and tunable properties. Some cluster configuration properties are nested within other objects in the Helm chart’s values. For example, cloud_storage_access_key is nested inside storage.tieredStorage.

Tunable properties, such as internal buffer sizes, have default settings that you typically do not need to modify during normal operations. You should only change these properties after collecting sufficient data to warrant a change.

Edit cluster properties

To change any property settings, edit the default configuration using the --values or --set flags in the helm upgrade --install command. For example, to set the cloud_storage_access_key cluster configuration:

  • Helm + Operator

  • Helm

kind: Redpanda
  name: redpanda
  chartRef: {}
        cloud_storage_access_key: <access-key>
kubectl apply -f redpanda-cluster.yaml --namespace <namespace>
  • --values

  • --set

    cloud_storage_access_key: <access-key>
helm upgrade --install redpanda redpanda/redpanda --namespace <namespace> --create-namespace \
  --values cloud-storage.yaml --reuse-values
helm upgrade --install redpanda redpanda/redpanda --namespace <namespace> --create-namespace \
  --set storage.tieredConfig.cloud_storage_access_key=<access-key>

View the current value of a property

To see the current value of a property for a broker, you can run rpk cluster config get <property_name> inside a container that’s running Redpanda.

In this example, the command is executed on a Pod called redpanda-0 in the redpanda namespace. You can provide your own namespace in the --namespace flag.

kubectl exec redpanda-0 --namespace <namespace> -c redpanda -- \
  rpk cluster config get log_compression_type

Example output:


Export a Redpanda configuration file

To see all Redpanda configurations for a broker, you can use the rpk cluster config export command to save the current Redpanda configuration to a file. For example, you may want to use the configuration file during debugging.

To get more detailed information about your Redpanda deployment, generate a diagnostics bundle, which includes the Redpanda configuration files for all brokers in the cluster.
  1. Execute the rpk cluster config export command inside a Pod container that’s running a Redpanda broker.

    kubectl exec redpanda-0 --namespace <namespace> -c redpanda -- \
    rpk cluster config export --filename <filename>.yaml

    To save the configuration file outside of your current working directory, provide an absolute path to the --filename flag. Otherwise, the file is saved in your current working directory.

    Example output

    Wrote configuration to file "/tmp/config_625125906.yaml".
  2. On your host machine, make a directory in which to save the configuration file:

    mkdir configs
  3. Copy the configuration file from the Pod to your host machine:

    Replace <path-to-file> with the path to your exported file.

    kubectl cp redpanda/redpanda-0:<path-to-file> configs/redpanda-0-configuration-file.yaml
  4. Remove the exported file from the Redpanda container:

    kubectl exec redpanda-0 -c redpanda --namespace <namespace> -- rm <path-to-file>

When you’ve finished with the file, remove it from your host machine:

rm -r configs