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

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

csi plugin name: blob.csi.azure.com

Project status: GA

Container Images & Kubernetes Compatibility:

driver version	Image	supported k8s version	built-in blobfuse v1 version	built-in blobfuse v2 version
master branch	mcr.microsoft.com/k8s/csi/blob-csi:latest	1.21+	1.4.5	2.0.1
v1.19.0	mcr.microsoft.com/oss/kubernetes-csi/blob-csi:v1.19.0	1.21+	1.4.5	2.0.1
v1.18.0	mcr.microsoft.com/oss/kubernetes-csi/blob-csi:v1.18.0	1.21+	1.4.5	2.0.0-preview.3
v1.17.0	mcr.microsoft.com/oss/kubernetes-csi/blob-csi:v1.17.0	1.21+	1.4.5	n/a

Driver parameters

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

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

follow guide here

Prerequisites

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

• 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 via kubectl on public Azure (please use helm for Azure Stack, RedHat/CentOS)
• install via helm charts on public Azure, Azure Stack, RedHat/CentOS
  • configure with blobfuse-proxy to make blobfuse mount still available after driver restart

Usage

• Basic usage
• NFSv3
• fsGroupPolicy

Troubleshooting

• CSI driver troubleshooting guide

Support

• Please see our support policy

Limitations

• Please refer to Azure Blob Storage CSI Driver Limitations

Kubernetes Development

• Please refer to development guide

View CI Results

• Check testgrid provider-azure-blobfuse-csi-driver dashboard.

Links

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