Azure File CSI Driver for Kubernetes

About

This driver allows Kubernetes to access Azure File volumes using SMB and NFS protocols.

• CSI plugin name: file.csi.azure.com
• Project status: GA

[!NOTE] Deploying this driver manually is not an officially supported Microsoft product. For a fully managed and supported experience on Kubernetes, use AKS with the managed Azure File CSI driver.

Container Images & Kubernetes Compatibility

Driver Parameters

Please refer to driver parameters.

Prerequisites

Option 1: Provide cloud provider config with Azure credentials

This option depends on a cloud provider config file (config example). Config file paths on different clusters:

kubectl create configmap azure-cred-file \
  --from-literal=path="/etc/kubernetes/cloud.conf" \
  --from-literal=path-windows="C:\\k\\cloud.conf" \
  -n kube-system

• Cloud provider config can also be specified via a Kubernetes Secret — see details.
• Ensure the identity used by the driver has the Contributor role on the node resource group and virtual network resource group.

Option 2: Bring your own storage account (SMB only)

This option does not depend on the cloud provider config file and supports cross-subscription and on-premise cluster scenarios. Refer to detailed steps.

Installation

Install the driver on a Kubernetes cluster:

• Install by Helm charts
• Install by kubectl

Install Open source CSI driver:

Install Managed CSI driver:

Examples

• Basic usage

Features

• Windows
• NFS
• Volume Snapshot and Restore
• Volume Expansion
• Volume Cloning
• Mount with workload identity
• Mount with managed identity

Troubleshooting

• CSI driver troubleshooting guide

Support

Please see our support policy.

Development

Please refer to the development guide.

CI Results

Check the TestGrid provider-azure-azurefile-csi-driver dashboard.

Links

• Kubernetes CSI Documentation
• CSI Drivers
• Container Storage Interface (CSI) Specification
• Use Azure Files with Linux