blob-csi-driver

README

Azure Blob Storage CSI driver for Kubernetes

About

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

• azure-storage-fuse
• NFSv3

csi plugin name: blob.csi.azure.com

Breaking change

Since v0.7.0, driver name changed from blobfuse.csi.azure.com to blob.csi.azure.com, volume created by v0.6.0(or prior version) could not be mounted by v0.7.0 driver. If you have volumes created by v0.6.0 version, just keep the driver running in your cluster.

Container Images & Kubernetes Compatibility:

Azure Blob Storage CSI driver Version	Image	1.14+
master branch	mcr.microsoft.com/k8s/csi/blob-csi:latest	yes
v0.7.0	mcr.microsoft.com/k8s/csi/blob-csi:v0.7.0	yes

Driver parameters

Please refer to blob.csi.azure.com driver parameters

Prerequisite

• The driver depends on cloud provider config file, usually it's /etc/kubernetes/azure.json on all kubernetes 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.
• If cluster identity is Managed Service Identity(MSI), make sure user assigned identity has Contributor role on node resource group

Install Azure Blob Storage CSI driver on a kubernetes cluster

Please refer to install Azure Blob Storage CSI driver

Usage

• Basic usage
• NFSv3

Troubleshooting

• CSI driver troubleshooting guide

Kubernetes Development

Please refer to development guide

Links

• azure-storage-fuse
• Kubernetes CSI Documentation
• CSI Drivers
• Container Storage Interface (CSI) Specification
• Blobfuse FlexVolume driver