SMB CSI Driver for Kubernetes

About

This driver allows Kubernetes to access SMB server on both Linux and Windows nodes, csi plugin name: smb.csi.k8s.io. The driver requires existing and already configured SMB server, it supports dynamic provisioning of Persistent Volumes via Persistent Volume Claims by creating a new sub directory under SMB server.

Project status: GA

Container Images & Kubernetes Compatibility:

Driver Version	supported k8s version	supported Windows csi-proxy version
master branch	1.21+	v0.2.2+
v1.14.0	1.21+	v0.2.2+
v1.13.0	1.21+	v0.2.2+
v1.12.0	1.21+	v0.2.2+

Driver parameters

Please refer to smb.csi.k8s.io driver parameters

Install driver on a Kubernetes cluster

• install via helm charts
• install via kubectl

Examples

• How to Use the Windows CSI Proxy and CSI SMB Driver for Kubernetes
• Set up a Samba Server on a Kubernetes cluster
• Basic usage
• Windows
• Volume cloning

Troubleshooting

• CSI driver troubleshooting guide

Kubernetes Development

Please refer to development guide

View CI Results

• testgrid sig-storage-csi-smb dashboard.
• Driver image build pipeline: post-csi-driver-smb-push-images

Links

• SMB FlexVolume driver
• Kubernetes CSI Documentation
• CSI Drivers
• Container Storage Interface (CSI) Specification