michaelcourcy / azurefile-csi-driver

Azure File Container Storage Interface (CSI) Storage Plugin

Azure File CSI Driver for Kubernetes

About

This driver allows Kubernetes to use Azure File volume, csi plugin name: file.csi.azure.com

Container Images & Kubernetes Compatibility:

Driver Version	Image	1.15+
master branch	mcr.microsoft.com/k8s/csi/azurefile-csi:latest	yes
v0.10.0	mcr.microsoft.com/k8s/csi/azurefile-csi:v0.10.0	yes
v0.9.0	mcr.microsoft.com/k8s/csi/azurefile-csi:v0.9.0	yes
v0.8.0	mcr.microsoft.com/k8s/csi/azurefile-csi:v0.8.0	yes

Driver parameters

Please refer to driver parameters

Prerequisite

• The driver depends on cloud provider config file, usually it's /etc/kubernetes/azure.json on all kubernetes nodes deployed by AKS or aks-engine, here is azure.json example.

To specify a different cloud provider config file, create azure-cred-file configmap before driver installation, e.g. for OpenShift, it's /etc/kubernetes/cloud.conf (make sure config file path is in the volumeMounts.mountPath)

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

• This driver also supports read cloud config from kuberenetes secret.
• If cluster identity is Managed Service Identity(MSI), make sure user assigned identity has Contributor role on node resource group

Install driver on a Kubernetes cluster

• install by kubectl
• install by helm charts

Examples

• Basic usage

Features

• VHD disk
• Windows
• NFS
• Snapshot
• Resize

Troubleshooting

• CSI driver troubleshooting guide

Support

• Please see our support policy

Kubernetes Development

Please refer to development guide

View CI Results

Check testgrid provider-azure-azurefile-csi-driver dashboard.

Links

• Kubernetes CSI Documentation
• CSI Drivers
• Container Storage Interface (CSI) Specification