Repository files navigation

This driver allows Kubernetes to access Azure Storage through one of following methods:

• azure-storage-fuse
• NFSv3

Disclaimer: Deploying this driver manually is not an officially supported Microsoft product. For a fully managed and supported experience on Kubernetes, useAKS with the managed blob csi driver.

Please refer toblob.csi.azure.comdriver parameters

• This option depends oncloud provider config file (here isconfig example), config file path on different clusters:
  • AKS,capz,aks-engine:/etc/kubernetes/azure.json
  • Azure RedHat OpenShift:/etc/kubernetes/cloud.conf
• specify a different config file path via configmap

  
  create configmap "azure-cred-file" before driver starts up
  

  kubectl create configmap azure-cred-file --from-literal=path="/etc/kubernetes/cloud.conf" --from-literal=path-windows="C:\\k\\cloud.conf" -n kube-system

• Cloud provider config can also be specified via kubernetes secret, check detailshere
• Make sure identity used by driver hasContributor role on node resource group and virtual network resource group

This option does not depend on cloud provider config file, supports cross subscription and on-premise cluster scenario. Refer todetailed steps.

Execute following command to install a specific version of blobfuse v2 once driver is running on the agent node:

kubectl patch daemonset csi-blob-node -n kube-system -p '{"spec":{"template":{"spec":{"initContainers":[{"env":[{"name":"INSTALL_BLOBFUSE2","value":"true"},{"name":"BLOBFUSE2_VERSION","value":"2.5.1"}],"name":"install-blobfuse-proxy"}]}}}}'

If you want to install a lower version of blobfuse2 than the current version, you can add --allow-downgrades to theBLOBFUSE2_VERSION value, e.g.

kubectl patch daemonset csi-blob-node -n kube-system -p '{"spec":{"template":{"spec":{"initContainers":[{"env":[{"name":"INSTALL_BLOBFUSE2","value":"true"},{"name":"BLOBFUSE2_VERSION","value":"2.3.0 --allow-downgrades"}],"name":"install-blobfuse-proxy"}]}}}}'

• install byhelm charts
• install bykubectl
• install open source CSI driver on following platforms:
  • AKS
  • Azure RedHat OpenShift
• install managed CSI driver on following platforms:
  • AKS

• Basic usage

• NFSv3
• fsGroupPolicy
• Volume cloning
• Workload identity
• Mount Azure blob storage with managed identity

• CSI driver troubleshooting guide

• Please see oursupport policy

• Please refer toAzure Blob Storage CSI Driver Limitations

• Please refer todevelopment guide

• Check testgridprovider-azure-blobfuse-csi-driver dashboard.

• azure-storage-fuse
• Kubernetes CSI Documentation
• CSI Drivers
• Container Storage Interface (CSI) Specification
• Blobfuse2 Known issues