Azure File CSI Driver for Kubernetes
About
This driver allows Kubernetes to use Azure File volume, csi plugin name: file.csi.azure.com
Project status: GA
Container Images & Kubernetes Compatibility:
| Driver Version | Image | supported k8s version |
|---|---|---|
| master branch | mcr.microsoft.com/k8s/csi/azurefile-csi:latest | 1.18+ |
| v1.3.0 | mcr.microsoft.com/k8s/csi/azurefile-csi:v1.3.0 | 1.18+ |
| v1.2.0 | mcr.microsoft.com/k8s/csi/azurefile-csi:v1.2.0 | 1.17+ |
| v1.1.0 | mcr.microsoft.com/k8s/csi/azurefile-csi:v1.1.0 | 1.16+ |
Driver parameters
Please refer to driver parameters
Prerequisite
Option#1: Provide cloud provider config with Azure cendentials
- This option depends on cloud provider config file, usually it's
/etc/kubernetes/azure.jsonon all Kubernetes agent nodes deployed by AKS or aks-engine, here is azure.json example.
To specify a different cloud provider config file, create
azure-cred-fileconfigmap 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 kuberenetes secret.
- If cluster identity is Managed Service Identity(MSI), make sure user assigned identity has
Contributorrole on node resource group - How to set up CSI driver on Azure RedHat OpenShift(ARO)
Option#2: Bring your own storage account
This option does not depend on cloud provider config file, supports cross subscription and on-premise cluster scenario. Refer to detailed steps.
Install driver on a Kubernetes cluster
- install by kubectl (please use helm for RedHat/CentOS)
- install by helm charts (supports RedHat/CentOS)
Examples
Features
Troubleshooting
Support
- Please see our support policy
Kubernetes Development
Please refer to development guide
View CI Results
Check testgrid provider-azure-azurefile-csi-driver dashboard.