azuredisk-csi-driver

README

Azure Disk CSI driver for Kubernetes

About

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

Disclaimer: 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 disk csi driver.

Project status

V1: GA

V2: Preview

Container Images & Kubernetes Compatibility

V1

Driver Version	Image	supported k8s version
master branch	mcr.microsoft.com/k8s/csi/azuredisk-csi:latest	1.21+
v1.26.0	mcr.microsoft.com/oss/kubernetes-csi/azuredisk-csi:v1.26.0	1.21+
v1.25.0	mcr.microsoft.com/oss/kubernetes-csi/azuredisk-csi:v1.25.0	1.21+
v1.24.0	mcr.microsoft.com/oss/kubernetes-csi/azuredisk-csi:v1.24.0	1.21+

V2

Driver Version	Image	supported k8s version
main_v2 branch		1.21+
v2.0.0-beta.6	mcr.microsoft.com/oss/kubernetes-csi/azuredisk-csi:v2.0.0-beta.6	1.21+

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 agent node deployed by AKS or aks-engine, here is azure.json example.

  edge zone support in cloud provider config file

  
  extendedLocationType and extendedLocationName should be added into cloud provider config file, available values of extendedLocationName are attatlanta1, attdallas1, attnewyork1, attdetroit1
  

  "extendedLocationType": "edgezone", "extendedLocationName": "attatlanta1",

  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 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.

• 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

Install Azure Disk CSI Driver V2 on a Kubernetes cluster (Preview)

• install via helm charts

Examples

• Basic usage

Features

• Topology (Availability Zone)
  • ZRS disk support
• Snapshot
• Volume Cloning
• Volume Expansion
• Raw Block Volume
• Windows
• Shared Disk
• Volume Limits
• fsGroupPolicy
• Advanced disk performance tuning (Preview)

New in V2

• Attachments Replicas for Faster Pod Failover (Preview)
  • See pod failover demo for example configuration.

Troubleshooting

• CSI driver troubleshooting guide

Support

• Please see our support policy

Limitations

• Please refer to Azure Disk CSI Driver Limitations

Kubernetes Development

• Please refer to development guide

View CI Results

• Check testgrid provider-azure-azuredisk-csi-driver dashboard.

Links

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