Skip to content

magnologan/azurefile-csi-driver

 
 

Repository files navigation

Azure File CSI Driver for Kubernetes

linux build status windows build status Coverage Status FOSSA Status

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.20+
v1.21.0 mcr.microsoft.com/oss/kubernetes-csi/azurefile-csi:v1.21.0 1.20+
v1.20.0 mcr.microsoft.com/oss/kubernetes-csi/azurefile-csi:v1.20.0 1.20+
v1.19.0 mcr.microsoft.com/oss/kubernetes-csi/azurefile-csi:v1.19.0 1.20+

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

    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 and vnet resource group

  • How to set up CSI driver on Azure RedHat OpenShift(ARO)

Option#2: Bring your own storage account (only for SMB protocol)

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

Kubernetes Development

Please refer to development guide

View CI Results

Check testgrid provider-azure-azurefile-csi-driver dashboard.

Links

About

Azure File CSI Driver

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 86.1%
  • Shell 7.3%
  • Mustache 4.3%
  • Makefile 1.2%
  • Other 1.1%