Environment variables take precedence over YAML configuration.
You can find all possible configuration and the default values in the kuma-cp reference doc.
When using kumactl, you can override the configuration with the --env-var flag. For example, to configure the refresh interval for configuration of the data plane proxy, specify:
When using helm, you can override the configuration with the envVars field. For example, to configure the refresh interval for configuration with the data plane proxy, specify:
KUMA_XDS_SERVER_DATAPLANE_CONFIGURATION_REFRESH_INTERVAL=5s \KUMA_XDS_SERVER_DATAPLANE_STATUS_FLUSH_INTERVAL=5s \
kuma-cp run
1 2 3
If you configure kuma-cp with a YAML file, make sure to provide only values that you want to override.
Otherwise, upgrading Kuma might be harder, because you need to keep track of your changes when replacing this file on every upgrade.
Configuration of kuma-cp is logged when kuma-cp runs.
You can also get the configuration with a call to the Kuma API server:
curl http://<CP_ADDRESS>:5681/config
1
It's also displayed on the Diagnostic tab in the GUI, in the lower left corner.
In a multi-zone deployment, the zone control plane sends its config to the global control plane. This lets you inspect all configurations with kumactl inspect zones -oyaml or in the GUI.
In Kubernetes, kuma-dp is automatically configured and injected by Kubernetes.
The data plane proxy configuration is determined by the control plane. You can review the config details in the runtime.kubernetes.injector.sidecarContainer section of the kuma-cp config.
kuma-dp is configured with command line arguments. Run kuma-dp run -h to inspect all available settings.
The configuration is stored in $HOME/.kumactl/config, which is created when you run kumactl for the first time.
When you add a new control plane with kumactl config control-planes add, the config file is updated.
To change the path of the config file, run kumactl with --config-file /new-path/config.