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.19+
v1.8.0	mcr.microsoft.com/k8s/csi/azurefile-csi:v1.8.0	1.19+
v1.7.0	mcr.microsoft.com/k8s/csi/azurefile-csi:v1.7.0	1.18+
v1.6.0	mcr.microsoft.com/k8s/csi/azurefile-csi:v1.6.0	1.18+

Driver parameters

Please refer to driver parameters

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

follow guide here

Prerequisite

Option#1: Provide cloud provider config with Azure credentials

This option depends on cloud provider config file, usually it's /etc/kubernetes/azure.json on 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-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.
Make sure identity used by driver has Contributor role on node resource group and vnet 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

Basic usage

Features

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.

ivankostic85 / azurefile-csi-driver Goto Github PK

azurefile-csi-driver's Introduction