This driver allows Kubernetes to use Azure Disk volume, csi plugin name: disk.csi.azure.com
V1: GA
V2: Preview
Driver Version | Image | supported k8s version |
---|---|---|
master branch |
mcr.microsoft.com/k8s/csi/azuredisk-csi:latest | 1.21+ |
v1.22.0 | mcr.microsoft.com/oss/kubernetes-csi/azuredisk-csi:v1.22.0 | 1.21+ |
v1.21.0 | mcr.microsoft.com/oss/kubernetes-csi/azuredisk-csi:v1.21.0 | 1.20+ |
v1.20.0 | mcr.microsoft.com/oss/kubernetes-csi/azuredisk-csi:v1.20.0 | 1.20+ |
Driver Version | Image | supported k8s version |
---|---|---|
main_v2 branch |
1.21+ | |
v2.0.0-alpha.1 | mcr.microsoft.com/oss/kubernetes-csi/azuredisk-csi:v2.0.0-alpha.1 | 1.21+ |
Please refer to disk.csi.azure.com
driver parameters
storage class
disk.csi.azure.com
parameters are compatible with built-in azuredisk plugin
follow guide here
- The driver depends on cloud provider config file, usually it's
/etc/kubernetes/azure.json
on agent nodes deployed by AKS or aks-engine, here is azure.json example.specify a different cloud provider config file
createazure-cred-file
configmap before driver installation, e.g. for OpenShift, it's/etc/kubernetes/cloud.conf
(make sure config file path is in thevolumeMounts.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 kubernetes secret as first priority
- Make sure identity used by driver has
Contributor
role on node resource group- When installing side-by-side with an earlier version of the driver on an AKS cluster, ensure the agentpool service principal or managed service identity is assigned to the
Contributor
role on the resource groups used to store managed disks.
- When installing side-by-side with an earlier version of the driver on an AKS cluster, ensure the agentpool service principal or managed service identity is assigned to the
- Set up CSI driver on Azure RedHat OpenShift(ARO)
- 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
- install via helm charts
- Topology (Availability Zone)
- Snapshot
- Volume Cloning
- Volume Expansion
- Raw Block Volume
- Windows
- Shared Disk
- Volume Limits
- fsGroupPolicy
- Tune disk performance on Linux
- Attachments Replicas for Faster Pod Failover (Preview)
- See pod failover demo for example configuration.
- Advanced disk performance tuning (Preview)
- Please see our support policy
- Please refer to Azure Disk CSI Driver Limitations
- Please refer to development guide
- Check testgrid provider-azure-azuredisk-csi-driver dashboard.