Azure Disk CSI driver for Kubernetes

About

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

Project status: GA

Container Images & Kubernetes Compatibility

Driver Version	Image	supported k8s version
master branch	mcr.microsoft.com/k8s/csi/azuredisk-csi:latest	1.18+
v1.5.1	mcr.microsoft.com/k8s/csi/azuredisk-csi:v1.5.1	1.18+
v1.4.0	mcr.microsoft.com/k8s/csi/azuredisk-csi:v1.4.0	1.18+
v1.2.0	mcr.microsoft.com/k8s/csi/azuredisk-csi:v1.2.0	1.17+

Driver parameters

Please refer to disk.csi.azure.com driver parameters

storage class disk.csi.azure.com parameters are compatible with built-in azuredisk plugin

Set up CSI driver on AKS cluster (only for AKS users)

follow guide here

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
Set up CSI driver on Azure RedHat OpenShift(ARO)

Install driver on a Kubernetes cluster

install via kubectl on public Azure (please use helm for Azure Stack, RedHat/CentOS)
install via helm charts on public Azure, Azure Stack, RedHat/CentOS