Settings ConfigMap

Values consumed by the Klustre CSI node daemonset via ConfigMap.

ConfigMap/klustre-csi-settings provides runtime configuration to the node daemonset. Each key maps to either an environment variable or a command-line argument.

KeyDescriptionDefault
csiEndpointUNIX socket path used by the node plugin. Must align with kubelet’s plugin directory.unix:///var/lib/kubelet/plugins/lustre.csi.klustrefs.io/csi.sock
driverRegistrationArgArgument passed to the node-driver-registrar sidecar.--kubelet-registration-path=/var/lib/kubelet/plugins/lustre.csi.klustrefs.io/csi.sock
logLevelVerbosity for the Klustre CSI binary (info, debug, etc.).info
nodeImageContainer image for the Klustre CSI node plugin.ghcr.io/klustrefs/klustre-csi-plugin:0.0.1
pluginDirHostPath where CSI sockets live./var/lib/kubelet/plugins/lustre.csi.klustrefs.io
priorityClassNamePriority class applied to the daemonset pods.system-node-critical
registrarImageContainer image for the node-driver-registrar sidecar.registry.k8s.io/sig-storage/csi-node-driver-registrar:v2.10.1
registrationDirHostPath where kubelet expects CSI driver registration files./var/lib/kubelet/plugins_registry

To update any field:

kubectl -n klustre-system edit configmap klustre-csi-settings
kubectl rollout restart daemonset/klustre-csi-node -n klustre-system

Ensure any customized paths (e.g., pluginDir) match the volumes mounted in the daemonset spec.


Last modified November 30, 2025: docs: restructure docs, disable blog (62b401e)