Azure 存储 CSI 驱动程序和卷预配

本部分为希望配置一个或多个持久卷的集群管理员提供指导，其中包括可供工作负载使用的Blob storage的详细信息。 永久性卷声明（PVC）使用存储类对象动态预配 Azure Blob 存储容器。

若要使用提供的存储类通过Azure Blob 存储预配持久卷，请执行以下步骤：

1. 通过将以下 YAML 保存到名为 StorageClass 的文件中来创建 blob-fuse-sc.yaml 清单：

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: blob-fuse
   provisioner: blob.csi.azure.com
   parameters:
     skuName: Premium_LRS  # available values: Standard_LRS, Premium_LRS, Standard_GRS, Standard_RAGRS
     protocol: fuse2
     networkEndpointType: privateEndpoint
   reclaimPolicy: Delete
   volumeBindingMode: Immediate
   allowVolumeExpansion: true
   mountOptions:
     - -o allow_other
     - --file-cache-timeout-in-seconds=120
     - --use-attr-cache=true
     - --cancel-list-on-mount-seconds=10  # prevent billing charges on mounting
     - -o attr_timeout=120
     - -o entry_timeout=120
     - -o negative_timeout=120
     - --log-level=LOG_WARNING  # LOG_WARNING, LOG_INFO, LOG_DEBUG
     - --cache-size-mb=1000  # Default will be 80% of available memory, eviction will happen beyond specified value.
   

2. 若要在群集中创建存储类，请应用以下命令以执行 StorageClass：

   kubectl apply -f blob-fuse-sc.yaml
   

使用内置存储类创建PVC

storage类用于定义如何创建Azure Blob storage容器。 存储帐户会自动在节点资源组中创建，以便与存储类一起使用来保存 Azure Blob 存储容器。 为 “skuName” 选择以下 Azure 存储冗余 SKU 之一：

• Standard_LRS：标准本地冗余存储
• Premium_LRS：高级本地冗余存储
• Standard_GRS：标准异地冗余存储
• Standard_RAGRS：标准读取访问地理冗余存储

在 AKS 上使用 CSI 驱动程序时，还有两个内置组件使用 Azure Blob CSI 驱动程序。

这两种存储类的回收策略可确保当删除相应的持久卷时删除底层的 Azure Blob 存储。 默认情况下，storage类还会将容器配置为可扩展，因为 set allowVolumeExpansion 参数设置为 true。

使用 kubectl get sc 命令查看存储类。 以下示例演示 AKS 群集中可用的 azureblob-fuse-premium 和 azureblob-nfs-premium storage 类：

NAME                     PROVISIONER          RECLAIMPOLICY   VOLUMEBINDINGMODE   ALLOWVOLUMEEXPANSION   AGE
azureblob-fuse-premium   blob.csi.azure.com   Delete          Immediate           true                   23h
azureblob-nfs-premium    blob.csi.azure.com   Delete          Immediate           true                   23h

若要使用这些storage类，请创建一个 PVC 和相应的 Pod 来引用和使用它们。 PVC 用于根据存储类自动分配存储。 可以使用内置存储类之一或自定义存储类创建 PVC。 此 PVC 使用您指定的 SKU、大小和协议创建 Azure Blob storage 容器。 创建 Pod 定义时，指定 PVC 以请求所需的存储。

PVC 使用存储类对象动态预配 Azure Blob storage 容器。 以下 YAML 可用于使用内置存储类创建具有ReadWriteMany访问权限的 5 GB PVC。 有关访问模式的详细信息，请参阅 Kubernetes 持久性卷 文档。

1. 创建一个名为 blob-nfs-pvc.yaml 并复制以下 YAML 的文件：

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: azure-blob-storage
   spec:
     accessModes:
     - ReadWriteMany
     storageClassName: azureblob-nfs-premium
     resources:
       requests:
         storage: 5Gi
   

2. 使用 kubectl create 命令创建 PVC：

   kubectl create -f blob-nfs-pvc.yaml
   

完成后，Blob 存储容器已创建。 可以使用 kubectl get 命令查看 PVC 的状态：

kubectl get pvc azure-blob-storage

命令的输出类似于以下示例：

NAME                 STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS                AGE
azure-blob-storage   Bound    pvc-b88e36c5-c518-4d38-a5ee-337a7dda0a68   5Gi        RWX            azureblob-nfs-premium       92m

装载 PVC

以下 YAML 创建一个 Pod，该 Pod 使用 PVC azure-blob-storage 在 /mnt/blob 路径中装载Azure Blob storage。

1. 创建一个名为 blob-nfs-pv的文件，并复制以下 YAML。 请确保 claimName 与上一步中创建的 PVC 匹配。

   kind: Pod
   apiVersion: v1
   metadata:
     name: mypod
   spec:
     containers:
     - name: mypod
       image: mcr.azk8s.cn/oss/nginx/nginx:1.17.3-alpine
       resources:
         requests:
           cpu: 100m
           memory: 128Mi
         limits:
           cpu: 250m
           memory: 256Mi
       volumeMounts:
       - mountPath: "/mnt/blob"
         name: volume
         readOnly: false
     volumes:
       - name: volume
         persistentVolumeClaim:
           claimName: azure-blob-storage
   

2. 使用 kubectl apply 命令创建 Pod：

   kubectl apply -f blob-nfs-pv.yaml
   

3. Pod 处于运行状态后，运行以下命令以创建名为 test.txt 的新文件。

   kubectl exec mypod -- touch /mnt/blob/test.txt
   

4. 若要验证磁盘是否已正确装载，请运行以下命令，并验证是否在 test.txt 输出中看到该文件：

   kubectl exec mypod -- ls /mnt/blob
   

   命令的输出类似于以下示例：

   test.txt
   

本节为群集管理员提供指导，帮助他们创建一个或多个包含用于工作负载的 Blob 存储详细信息的 PV。

创建 Blob 存储容器

在为 AKS 创建 Azure Blob Storage 资源时，可以在节点资源组中创建该资源。 此方法允许 AKS 群集访问和管理 Blob 存储资源。

在本文中，请在节点资源组中创建容器。 首先，使用 az aks show 命令获取资源组名称，并添加 --query nodeResourceGroup 查询参数。 以下示例获取资源组 myResourceGroup 中名为 myAKSCluster 的 AKS 群集的节点资源组：

az aks show --resource-group myResourceGroup --name myAKSCluster --query nodeResourceGroup -o tsv

命令的输出类似于以下示例：

MC_myResourceGroup_myAKSCluster_chinanorth3

接下来，按照 Manage blob storage 中的步骤创建用于存储 blob 的容器，以授权访问权限，然后再创建该容器。

在此示例中，以下清单通过使用 "NFS" 协议配置装载 Blob存储容器。 使用它添加 tags 参数。

1. 创建名为 blob-nfs-sc.yaml 的文件，并粘贴以下示例清单：

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: azureblob-nfs-premium
   provisioner: blob.csi.azure.com
   parameters:
     protocol: nfs
     tags: environment=Development
   volumeBindingMode: Immediate
   allowVolumeExpansion: true
   mountOptions:
     - nconnect=4
   

2. 使用 kubectl apply 命令创建 storage 类：

   kubectl apply -f blob-nfs-sc.yaml
   

   命令的输出类似于以下示例：

   storageclass.storage.k8s.io/blob-nfs-premium created
   

在此示例中，以下清单使用 BlobFuse 配置并挂载 Blob 存储容器。 使用它更新 skuName 参数。

1. 创建一个名为 blobfuse-sc.yaml 并粘贴以下示例清单的文件：

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: azureblob-fuse-premium
   provisioner: blob.csi.azure.com
   parameters:
     skuName: Standard_GRS  # available values: Standard_LRS, Premium_LRS, Standard_GRS, Standard_RAGRS
    reclaimPolicy: Delete
    volumeBindingMode: Immediate
    allowVolumeExpansion: true
    mountOptions:
     - -o allow_other
     - --file-cache-timeout-in-seconds=120
     - --use-attr-cache=true
     - --cancel-list-on-mount-seconds=10  # prevent billing charges on mounting
     - -o attr_timeout=120
     - -o entry_timeout=120
     - -o negative_timeout=120
     - --log-level=LOG_WARNING  # LOG_WARNING, LOG_INFO, LOG_DEBUG
     - --cache-size-mb=1000  # Default will be 80% of available memory, eviction will happen beyond that.
   

2. 使用 kubectl apply 命令创建 storage 类：

   kubectl apply -f blobfuse-sc.yaml
   

   命令的输出类似于以下示例：

   storageclass.storage.k8s.io/blob-fuse-premium created
   

使用 NFS v3 协议装载Blob storage不会使用帐户密钥进行身份验证。 AKS 群集需要与代理节点位于同一虚拟网络或对等虚拟网络中。 保护存储帐户中数据的唯一方法是使用虚拟网络和其他网络安全设置。 有关如何设置 NFS 访问以连到存储账户的详细信息，请参阅使用网络文件系统 (NFS) 3.0 协议来挂载 Blob 存储。

以下示例演示如何使用 NFS 协议将Blob storage容器装载为永久性卷。

1. 创建名为 pv-blob-nfs.yaml 的文件，并将其复制到以下 YAML 中。 在 storageClass 下，更新 resourceGroup、storageAccount 和 containerName。

   注释

   YAML 中的 volumeHandle 值应该是群集中每个相同storage blob 容器的唯一 volumeID。

   字符 # 并 / 保留供内部使用，不能使用。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     annotations:
       pv.kubernetes.io/provisioned-by: blob.csi.azure.com
     name: pv-blob
   spec:
     capacity:
       storage: 1Pi
     accessModes:
       - ReadWriteMany
     persistentVolumeReclaimPolicy: Retain  # If set as "Delete" container would be removed after pvc deletion
     storageClassName: azureblob-nfs-premium
     mountOptions:
       - nconnect=4
     csi:
       driver: blob.csi.azure.com
       # make sure volumeid is unique for every identical storage blob container in the cluster
       # character `#` and `/` are reserved for internal use and cannot be used in volumehandle
       volumeHandle: account-name_container-name
       volumeAttributes:
         resourceGroup: resourceGroupName
         storageAccount: storageAccountName
         containerName: containerName
         protocol: nfs
   

   注释

   虽然Kubernetes API容量属性是必需的，但Azure Blob storage CSI 驱动程序不使用此值，因为可以灵活写入数据，直到达到storage帐户的容量限制。 特性的值 capacity 仅用于 PV 和 PVC 之间的大小匹配。 建议使用虚构的较高数值。 Pod 看到一个装载的卷，其虚构大小为 5 PB。

2. 运行以下命令，使用 kubectl create 命令创建永久性卷，引用前面创建的 YAML 文件：

   kubectl create -f pv-blob-nfs.yaml
   

3. 使用 pvc-blob-nfs.yamlPersistentVolumeClaim 创建文件。 例如：

   kind: PersistentVolumeClaim
   apiVersion: v1
   metadata:
     name: pvc-blob
   spec:
     accessModes:
       - ReadWriteMany
     resources:
       requests:
         storage: 10Gi
     volumeName: pv-blob
     storageClassName: azureblob-nfs-premium
   

4. 运行以下命令，通过引用之前创建的 YAML 文件的 kubectl create 命令来创建持久卷声明：

   kubectl create -f pvc-blob-nfs.yaml
   

Kubernetes 需要凭据才能访问之前创建的 Blob 存储容器，这可以是 Azure 访问密钥或 SAS 令牌。 这些凭据存储在 Kubernetes 机密中，该机密是在创建 Kubernetes Pod 时引用的。

1. 使用 kubectl create secret command 创建机密。 可以使用 Kubernetes 密钥 或 [共享访问签名][sas-tokens] （SAS）令牌进行身份验证。 还必须提供现有Azure storage帐户中的帐户名称和密钥。

   • Kubernetes 密钥
   • SAS 令牌

   以下示例创建名为 的 azure-secret并填充 azurestorageaccountname 和 azurestorageaccountkey 参数。

   kubectl create secret generic azure-secret --from-literal azurestorageaccountname=NAME --from-literal azurestorageaccountkey="KEY" --type=Opaque
   

2. 创建 pv-blobfuse.yaml 文件。 在 volumeAttributes下，更新 containerName。 请在 nodeStateSecretRef 下，将之前创建的 Secret 对象名称更新至 name。 例如：

   注释

   YAML 中的 volumeHandle 值应该是群集中每个相同storage blob 容器的唯一 volumeID。

   字符 # 并 / 保留供内部使用，不能使用。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     annotations:
       pv.kubernetes.io/provisioned-by: blob.csi.azure.com
     name: pv-blob
   spec:
     capacity:
       storage: 10Gi
     accessModes:
       - ReadWriteMany
     persistentVolumeReclaimPolicy: Retain  # If set as "Delete" container would be removed after pvc deletion
     storageClassName: azureblob-fuse-premium
     mountOptions:
       - -o allow_other
       - --file-cache-timeout-in-seconds=120
     csi:
       driver: blob.csi.azure.com
       # volumeid has to be unique for every identical storage blob container in the cluster
       # character `#`and `/` are reserved for internal use and cannot be used in volumehandle
       volumeHandle: account-name_container-name
       volumeAttributes:
         containerName: containerName
       nodeStageSecretRef:
         name: azure-secret
         namespace: default
   

3. 运行以下命令，使用引用前面创建的 YAML 文件的 kubectl create 命令创建 PV：

   kubectl create -f pv-blobfuse.yaml
   

4. 创建一个带有 PV 的pvc-blobfuse.yaml文件。 例如：

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: pvc-blob
   spec:
     accessModes:
       - ReadWriteMany
     resources:
       requests:
         storage: 10Gi
     volumeName: pv-blob
     storageClassName: azureblob-fuse-premium
   

5. 运行以下命令，使用引用前面创建的 YAML 文件的 kubectl create 命令创建 PVC：

   kubectl create -f pvc-blobfuse.yaml
   

1. 创建名为 azure-blob-nfs-ss.yaml 的文件，并在以下 YAML 中复制。

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: statefulset-blob-nfs
     labels:
       app: nginx
   spec:
     serviceName: statefulset-blob-nfs
     replicas: 1
     template:
       metadata:
         labels:
           app: nginx
       spec:
         nodeSelector:
           "kubernetes.io/os": linux
         containers:
           - name: statefulset-blob-nfs
             image: mcr.azk8s.cn/azurelinux/base/nginx:1.25
             volumeMounts:
               - name: persistent-storage
                 mountPath: /mnt/blob
     updateStrategy:
       type: RollingUpdate
     selector:
       matchLabels:
         app: nginx
     volumeClaimTemplates:
       - metadata:
           name: persistent-storage
         spec:
           storageClassName: azureblob-nfs-premium
           accessModes: ["ReadWriteMany"]
           resources:
             requests:
               storage: 100Gi
   

2. 使用 kubectl create 以下命令创建 StatefulSet：

   kubectl create -f azure-blob-nfs-ss.yaml
   

1. 创建名为 azure-blobfuse-ss.yaml 的文件，并在以下 YAML 中复制。

   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: statefulset-blob
     labels:
       app: nginx
   spec:
     serviceName: statefulset-blob
     replicas: 1
     template:
       metadata:
         labels:
           app: nginx
       spec:
         nodeSelector:
           "kubernetes.io/os": linux
         containers:
           - name: statefulset-blob
             image: mcr.azk8s.cn/azurelinux/base/nginx:1.25
             volumeMounts:
               - name: persistent-storage
                 mountPath: /mnt/blob
     updateStrategy:
       type: RollingUpdate
     selector:
       matchLabels:
         app: nginx
     volumeClaimTemplates:
       - metadata:
           name: persistent-storage
         spec:
           storageClassName: azureblob-fuse-premium
           accessModes: ["ReadWriteMany"]
           resources:
             requests:
               storage: 100Gi
   

2. 使用 kubectl create 以下命令创建 StatefulSet：

   kubectl create -f azure-blobfuse-ss.yaml
   

¹ 如果驱动程序创建了storage帐户，则只需在 storage 类中指定 networkEndpointType: privateEndpoint 参数。 CSI 驱动程序将创建专用终结点和private DNS区域（命名为 privatelink.blob.core.chinacloudapi.cn），以及帐户。 如果自行提供存储帐户，则需要为存储帐户创建专用终结点。 如果在网络隔离群集中使用Azure Blob storage，则必须使用 networkEndpointType: privateEndpoint 创建自定义storage类。

可以使用 BlobFuse 的托管标识或服务主体名称（SPN）进行身份验证。 有关详细信息，请参阅 Managed Identity and Service Principal Name authentication。

可以使用以下参数使 BlobFuse 直接从Azure Key Vault读取帐户密钥或 SAS 令牌。

PVC 根据存储类自动分配存储。 在这种情况下，PVC 可以使用预先创建的存储类之一来创建标准或高级 Azure 托管磁盘。

1. 创建名为 azure-pvc.yaml 的文件，并在以下清单中复制。 声明请求一个名为 azure-managed-disk 的磁盘，该磁盘的大小是 5 GB，并具有 ReadWriteOnce 的访问权限。 managed-csi 被指定为存储类。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
       name: azure-managed-disk
   spec:
     accessModes:
     - ReadWriteOnce
     storageClassName: managed-csi
     resources:
       requests:
         storage: 5Gi
   

   小窍门

   若要创建使用 premium storage 的磁盘，请使用 storageClassName: managed-csi-premium，而不是 managed-csi。

2. 使用 kubectl apply 命令创建永久性卷声明，并指定 azure-pvc.yaml 文件。

   kubectl apply -f azure-pvc.yaml
   

   命令的输出类似于以下示例：

   persistentvolumeclaim/azure-managed-disk created
   

将 PVC 应用到 Pod

创建永久性卷声明后，必须验证其状态为“Pending”。 状态“Pending”指示它已准备好供 Pod 使用。

1. 使用 kubectl describe pvc 命令检查 PVC 的状态。

   kubectl describe pvc azure-managed-disk
   

   命令的输出类似于以下示例：

   Name:            azure-managed-disk
   Namespace:       default
   StorageClass:    managed-csi
   Status:          Pending
   [...]
   

2. 创建名为 azure-pvc-disk.yaml 的文件，并在以下清单中复制。 此清单创建一个基本 NGINX Pod，该 Pod 使用名为 azure-managed-disk 的永久性卷声明将 Azure 磁盘装载到路径 /mnt/azure。 对于 Windows Server 容器，请使用 Windows 路径约定指定 mountPath，例如“D:”。

   kind: Pod
   apiVersion: v1
   metadata:
     name: mypod
   spec:
     containers:
       - name: mypod
         image: mcr.azk8s.cn/oss/nginx/nginx:1.15.5-alpine
         resources:
           requests:
             cpu: 100m
             memory: 128Mi
           limits:
             cpu: 250m
             memory: 256Mi
         volumeMounts:
           - mountPath: "/mnt/azure"
             name: volume
             readOnly: false
     volumes:
       - name: volume
         persistentVolumeClaim:
           claimName: azure-managed-disk
   

3. 使用 kubectl apply 命令创建 pod。

   kubectl apply -f azure-pvc-disk.yaml
   

   命令的输出类似于以下示例：

   pod/mypod created
   

4. 您现在有一个正在运行的 pod，Azure 磁盘已挂载在 /mnt/azure 目录中。 使用 kubectl describe 命令检查 Pod 配置。

   kubectl describe pod mypod
   

   命令的输出类似于以下示例：

   [...]
   Volumes:
     volume:
       Type:       PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
       ClaimName:  azure-managed-disk
       ReadOnly:   false
      default-token-smm2n:
       Type:        Secret (a volume populated by a Secret)
       SecretName:  default-token-smm2n
       Optional:    false
   [...]
    Events:
     Type    Reason                 Age   From                               Message
     ----    ------                 ----  ----                               -------
     Normal  Scheduled              2m    default-scheduler                  Successfully assigned mypod to aks-nodepool1-79590246-0
     Normal  SuccessfulMountVolume  2m    kubelet, aks-nodepool1-79590246-0  MountVolume.SetUp succeeded for volume "default-token-smm2n"
     Normal  SuccessfulMountVolume  1m    kubelet, aks-nodepool1-79590246-0  MountVolume.SetUp succeeded for volume "pvc-faf0f176-8b8d-11e8-923b-deb28c58d242"
   [...]
   

创建用于 AKS 的Azure磁盘时，可以在 node 资源组中创建磁盘资源。 此方法允许 AKS 集群访问和管理磁盘资源。 如果改为在单独的资源组中创建磁盘，则必须为您的群集的 Azure Kubernetes Service (AKS) 托管标识授予针对该磁盘资源组的Contributor角色。

1. 使用 az aks show 命令标识资源组名称，并添加 --query nodeResourceGroup 参数。

   az aks show --resource-group myResourceGroup --name myAKSCluster --query nodeResourceGroup -o tsv
   

   命令的输出类似于以下示例：

   MC_myResourceGroup_myAKSCluster_chinanorth3
   

2. 使用 az disk create 命令创建磁盘。 指定节点资源组名称和磁盘资源名称，例如 myAKSDisk。 以下示例创建 20 GiB 磁盘，并在创建后输出磁盘的 ID。 如果需要创建与 Windows Server 容器一起使用的磁盘，请添加 --os-type windows 参数以正确格式化该磁盘。

   az disk create \
     --resource-group MC_myResourceGroup_myAKSCluster_chinanorth3 \
     --name myAKSDisk \
     --size-gb 20 \
     --query id --output tsv
   

   注释

   根据特定大小的 SKU，Azure 磁盘按此标准计费。 这些 SKU 的范围为 32 GiB（适用于 S4 或 P4 磁盘）到 32 TiB（适用于 S80 或 P80 磁盘），属于预览版。 高级托管磁盘的吞吐量和 IOPS 性能取决于 SKU 和 AKS 群集中节点的实例大小。 请参阅 托管磁盘的定价和性能。

   命令成功完成后，会显示磁盘资源 ID，如以下示例输出所示。 在下一部分中使用此磁盘 ID 来装载磁盘。

   /subscriptions/<subscriptionID>/resourceGroups/MC_myAKSCluster_myAKSCluster_chinanorth3/providers/Microsoft.Compute/disks/myAKSDisk
   

将磁盘装载为卷

1. 使用 PV 创建 pv-azuredisk.yaml 文件。 使用上一步骤中的磁盘资源 ID 更新 volumeHandle。 对于 Windows Server 容器，请为参数指定 fsType。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     annotations:
       pv.kubernetes.io/provisioned-by: disk.csi.azure.com
     name: pv-azuredisk
   spec:
     capacity:
       storage: 20Gi
     accessModes:
       - ReadWriteOnce
     persistentVolumeReclaimPolicy: Retain
     storageClassName: managed-csi
     csi:
       driver: disk.csi.azure.com
       volumeHandle: /subscriptions/<subscriptionID>/resourceGroups/MC_myAKSCluster_myAKSCluster_chinanorth3/providers/Microsoft.Compute/disks/myAKSDisk
       volumeAttributes:
         fsType: ext4
   

如果在单独的资源组中创建了 volumeHandle 磁盘，则需要将 AKS 群集的托管标识赋予该磁盘所在资源组的 Contributor 角色。

1. 使用 PV 的 PVC 创建 pvc-azuredisk.yaml 文件。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: pvc-azuredisk
   spec:
     accessModes:
       - ReadWriteOnce
     resources:
       requests:
         storage: 20Gi
     volumeName: pv-azuredisk
     storageClassName: managed-csi
   

2. 使用 kubectl apply 命令创建 PV 和 PVC，并引用创建的两个 YAML 文件：

   kubectl apply -f pv-azuredisk.yaml
   kubectl apply -f pvc-azuredisk.yaml
   

3. 使用 kubectl get pvc 命令验证 PVC 是否已创建并绑定到 PV。

   kubectl get pvc pvc-azuredisk
   

   命令的输出类似于以下示例：

   NAME            STATUS   VOLUME         CAPACITY    ACCESS MODES   STORAGECLASS   AGE
   pvc-azuredisk   Bound    pv-azuredisk   20Gi        RWO                           5s
   

4. 创建 "azure-disk-pod.yaml" 文件以引用 "PersistentVolumeClaim"。 对于 Windows Server 容器，请使用 Windows 路径约定指定mountPath，例如“D：”。

   apiVersion: v1
   kind: Pod
   metadata:
     name: mypod
   spec:
     nodeSelector:
       kubernetes.io/os: linux
     containers:
     - image: mcr.azk8s.cn/oss/nginx/nginx:1.15.5-alpine
       name: mypod
       resources:
         requests:
           cpu: 100m
           memory: 128Mi
         limits:
           cpu: 250m
           memory: 256Mi
       volumeMounts:
         - name: azure
           mountPath: /mnt/azure
     volumes:
       - name: azure
         persistentVolumeClaim:
           claimName: pvc-azuredisk
   

5. 使用 kubectl apply 命令应用配置并装载卷。

   kubectl apply -f azure-disk-pod.yaml
   

以下参数仅适用于 v2。

storage类用于定义如何创建Azure文件共享。 存储帐户会在 节点资源组 中自动创建，以便与存储类一起使用以保存 Azure 文件共享。 请为skuName选择以下Azure 存储冗余 SKU之一：

• Standard_LRS：标准本地冗余存储
• Standard_GRS：标准异地冗余存储
• Standard_RAGRS：标准读取访问地理冗余存储
• Standard_RAGZRS：标准读取访问异地区域冗余存储
• Premium_LRS：高级本地冗余存储

有关 Azure Files Kubernetes storage 类的详细信息，请参阅 Kubernetes Storage 类。

1. 创建名为 azure-file-sc.yaml 的文件，并在以下示例清单中复制。 有关 mountOptions 的详细信息，请参阅装载选项部分。

   kind: StorageClass
   apiVersion: storage.k8s.io/v1
   metadata:
     name: my-azurefile
   provisioner: file.csi.azure.com # replace with "kubernetes.io/azure-file" if aks version is less than 1.21
   allowVolumeExpansion: true
   mountOptions:
    - dir_mode=0777
    - file_mode=0777
    - uid=0
    - gid=0
    - mfsymlinks
    - cache=strict
    - actimeo=30
    - nobrl  # disable sending byte range lock requests to the server and for applications which have challenges with posix locks
   parameters:
     skuName: Premium_LRS
   

2. 使用 kubectl apply 命令创建storage类。

   kubectl apply -f azure-file-sc.yaml
   

创建 PVC

PVC 使用 storage 类对象动态预配Azure文件共享。 可以使用以下 YAML 创建大小为 100 GB，具有 ReadWriteMany 访问权限的 PVC。 有关访问模式的详细信息，请参阅 Kubernetes 持久卷。

1. 创建名为 azure-file-pvc.yaml 的文件，并在以下 YAML 中复制。 确保 storageClassName与在上一步中创建的storage类匹配。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: my-azurefile
   spec:
     accessModes:
       - ReadWriteMany
     storageClassName: my-azurefile
     resources:
       requests:
         storage: 100Gi
   

   注释

   如果使用 storage 类的 Premium_LRS SKU，则 storage 的最小值必须为 100Gi。

2. 使用 kubectl apply 命令创建 PVC。

   kubectl apply -f azure-file-pvc.yaml
   

   完成此步骤后，文件共享即创建完毕。 同时还会创建一个包含连接信息和凭据的 Kubernetes 机密。 可以使用 kubectl get 命令查看 PVC 的状态：

   kubectl get pvc my-azurefile
   

   命令的输出类似于以下示例：

   NAME           STATUS    VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS      AGE
   my-azurefile   Bound     pvc-8436e62e-a0d9-11e5-8521-5a8664dc0477   100Gi       RWX           my-azurefile      5m
   

装载 PVC

以下 YAML 创建一个 Pod，该 Pod 使用 PVC my-azurefile 在 /mnt/azure 路径，装载 Azure Files 文件共享。 对于 Windows Server 容器，请使用 Windows 路径约定指定mountPath，例如“D：”。

1. 创建名为 azure-pvc-files.yaml 的文件，并复制以下 YAML。 请确保 claimName 与前述步骤中创建的 PVC 匹配。

   kind: Pod
   apiVersion: v1
   metadata:
     name: mypod
   spec:
     containers:
       - name: mypod
         image: mcr.azk8s.cn/oss/nginx/nginx:1.15.5-alpine
         resources:
           requests:
             cpu: 100m
             memory: 128Mi
           limits:
             cpu: 250m
             memory: 256Mi
         volumeMounts:
           - mountPath: /mnt/azure
             name: volume
             readOnly: false
     volumes:
      - name: volume
        persistentVolumeClaim:
          claimName: my-azurefile
   

2. 使用 kubectl apply 命令创建 pod。

   kubectl apply -f azure-pvc-files.yaml
   

   现在，您的 Azure Files 文件共享已挂载到 /mnt/azure 目录中并运行 Pod。 使用 kubectl describe 命令检查 Pod 时，可以看到此配置。 以下精简示例输出显示容器中装载的卷。

   Containers:
     mypod:
       Container ID:   docker://053bc9c0df72232d755aa040bfba8b533fa696b123876108dec400e364d2523e
       Image:          mcr.azk8s.cn/oss/nginx/nginx:1.15.5-alpine
       Image ID:       docker-pullable://nginx@sha256:d85914d547a6c92faa39ce7058bd7529baacab7e0cd4255442b04577c4d1f424
       State:          Running
         Started:      Fri, 01 Mar 2019 23:56:16 +0000
       Ready:          True
       Mounts:
         /mnt/azure from volume (rw)
         /var/run/secrets/kubernetes.io/serviceaccount from default-token-8rv4z (ro)
   [...]
   Volumes:
     volume:
       Type:       PersistentVolumeClaim (a reference to a PersistentVolumeClaim in the same namespace)
       ClaimName:  my-azurefile
       ReadOnly:   false
   [...]
   

装载选项

对于 Kubernetes 版本 1.13.0 及更高版本，fileMode 和 dirMode 的默认值为 0777。 使用存储类别动态预配 PV 时，可以直接在存储类别清单中定义挂载选项。 有关详细信息，请参阅 挂载选项。 以下示例演示如何将这些权限设置为 0777：

kind: StorageClass
apiVersion: storage.k8s.io/v1
metadata:
  name: my-azurefile
provisioner: file.csi.azure.com # replace with "kubernetes.io/azure-file" if aks version is less than 1.21
allowVolumeExpansion: true
mountOptions:
  - dir_mode=0777
  - file_mode=0777
  - uid=0
  - gid=0
  - mfsymlinks
  - cache=strict
  - actimeo=30
  - nobrl  # disable sending byte range lock requests to the server and for applications which have challenges with posix locks
parameters:
  skuName: Premium_LRS

本部分为群集管理员提供指导，帮助他们创建一个或多个包含现有 Azure Files 共享详细信息的 PV，以与工作负载一起使用。

创建 Azure Files 共享

必须先创建一个 Azure 存储帐户和 Azure Files 文件共享，然后才能将 Azure Files 文件共享用作 Kubernetes 卷。

1. 使用带有 az aks show 参数的 --query nodeResourceGroup 命令获取资源组名称。

   az aks show --resource-group myResourceGroup --name myAKSCluster --query nodeResourceGroup -o tsv
   

   命令的输出类似于以下示例：

   MC_myResourceGroup_myAKSCluster_chinanorth3
   

2. 使用--sku命令和az storage account create参数创建存储帐户。 以下命令使用 Standard_LRS SKU 创建存储帐户。 请务必替换以下占位符：

   • myAKSStorageAccount，其中包含storage帐户的名称
   • nodeResourceGroupName 替换为 AKS 群集节点所在的资源组名称
   • location 替换为创建资源的区域名称。 它应与 AKS 群集节点为同一区域。

   az storage account create -n myAKSStorageAccount -g nodeResourceGroupName -l location --sku Standard_LRS
   

3. 使用以下命令将connection string导出为环境变量，用于创建文件共享。

   export AZURE_STORAGE_CONNECTION_STRING=$(az storage account show-connection-string -n storageAccountName -g resourceGroupName -o tsv)
   

   必须使用密钥轮换或存储在 Azure 密钥保管库中来保护连接字符串。 有关连接字符串的详细信息，请参阅 配置 Azure Storage 连接字符串 和 管理存储帐户访问密钥。

   对于生产环境，Microsoft建议使用Microsoft Entra ID身份验证。 有关详细信息，请参阅 在 Azure 存储中授权数据访问。

4. 使用 az storage share create 命令创建文件共享。 请确保将 shareName 替换为自己的共享名称。

   az storage share create -n shareName --connection-string $AZURE_STORAGE_CONNECTION_STRING
   

5. 使用以下命令将storage帐户密钥导出为环境变量。

   STORAGE_KEY=$(az storage account keys list --resource-group nodeResourceGroupName --account-name myAKSStorageAccount --query "[0].value" -o tsv)
   

6. 使用以下命令显示存储帐户的名称和密钥。 复制此信息，因为创建 Kubernetes 卷时需要这些值。

   echo Storage account key: $STORAGE_KEY
   

创建 Kubernetes 机密

Kubernetes 需要凭据才能访问在上一步中创建的文件共享。 这些凭据存储在 Kubernetes 机密中，创建 Kubernetes Pod 时将引用它。

1. 使用 kubectl create secret 命令创建机密。 以下示例创建名为 azure-secret 的机密，并从上一步填充 azurestorageaccountname 和 azurestorageaccountkey 参数。 若要使用现有Azure storage帐户，请提供帐户名称和密钥。

   kubectl create secret generic azure-secret --from-literal=azurestorageaccountname=myAKSStorageAccount --from-literal=azurestorageaccountkey=$STORAGE_KEY
   

将文件共享装载为 PV

1. 新建名为 azurefiles-pv.yaml 的文件，并将以下内容复制到其中。 在 csi 下，更新 resourceGroup、volumeHandle 和 shareName。 对于装载选项，fileMode和dirMode的默认值是0777。

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     annotations:
       pv.kubernetes.io/provisioned-by: file.csi.azure.com
     name: azurefile
   spec:
     capacity:
       storage: 5Gi
     accessModes:
       - ReadWriteMany
     persistentVolumeReclaimPolicy: Retain
     storageClassName: azurefile-csi
     csi:
       driver: file.csi.azure.com
       volumeHandle: "{resource-group-name}#{account-name}#{file-share-name}"  # make sure this volumeid is unique for every identical share in the cluster
       volumeAttributes:
         shareName: aksshare
       nodeStageSecretRef:
         name: azure-secret
         namespace: default
     mountOptions:
       - dir_mode=0777
       - file_mode=0777
       - uid=0
       - gid=0
       - mfsymlinks
       - cache=strict
       - nosharesock
       - nobrl  # disable sending byte range lock requests to the server and for applications which have challenges with posix locks
   

2. 使用 kubectl create 命令创建 PV。

   kubectl create -f azurefiles-pv.yaml
   

3. 新建名为“azurefiles-mount-options-pvc.yaml”的文件，并将以下内容复制到其中。

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: azurefile
   spec:
     accessModes:
       - ReadWriteMany
     storageClassName: azurefile-csi
     volumeName: azurefile
     resources:
       requests:
         storage: 5Gi
   

4. 使用 kubectl apply 命令创建 PVC。

   kubectl apply -f azurefiles-mount-options-pvc.yaml
   

5. 使用 kubectl get 命令验证您的 PVC 是否已创建并绑定到 PV。

   kubectl get pvc azurefile
   

   命令的输出如下例所示：

   NAME        STATUS   VOLUME      CAPACITY   ACCESS MODES   STORAGECLASS   AGE
   azurefile   Bound    azurefile   5Gi        RWX            azurefile      5s
   

6. 更新容器规格以引用 YAML 文件中的 PVC 和 Pod。 例如：

   ...
     volumes:
     - name: azure
       persistentVolumeClaim:
         claimName: azurefile
   

7. 无法就地更新 Pod 规范，因此请使用 kubectl delete 命令删除 Pod，然后使用 kubectl apply 命令重新创建 Pod。

   kubectl delete pod mypod
   
   kubectl apply -f azure-files-pod.yaml
   

将文件共享挂载为内联存储卷

若要将 Azure Files 文件共享装载到 Pod 中，请在容器规范中配置卷。

1. 创建名为 azure-files-pod.yaml 的新文件，并在以下内容中复制。 如果更改了文件共享名称或机密名称，请更新 shareName 和 secretName。 还可以更新 mountPath，这是文件共享在 Pod 中的装载路径。 对于 Windows Server 容器，请使用 Windows 路径约定指定 mountPath ，例如 D：/。

   apiVersion: v1
   kind: Pod
   metadata:
     name: mypod
   spec:
     nodeSelector:
       kubernetes.io/os: linux
     containers:
       - image: 'mcr.azk8s.cn/oss/nginx/nginx:1.15.5-alpine'
         name: mypod
         resources:
           requests:
             cpu: 100m
             memory: 128Mi
           limits:
             cpu: 250m
             memory: 256Mi
         volumeMounts:
           - name: azure
             mountPath: /mnt/azure
             readOnly: false
     volumes:
       - name: azure
         csi:
           driver: file.csi.azure.com
           volumeAttributes:
             secretName: azure-secret  # required
             shareName: aksshare  # required
             mountOptions: 'dir_mode=0777,file_mode=0777,cache=strict,actimeo=30,nosharesock,nobrl'  # optional
   

2. 使用 kubectl apply 命令创建 pod。

   kubectl apply -f azure-files-pod.yaml
   

   现在，你有一个正在运行的 Pod，已在 /mnt/azure 挂载了一个 Azure Files 文件共享。 可以使用 kubectl describe 命令验证是否已成功装载共享。

   kubectl describe pod mypod
   

下表包含用于定义 PVC 自定义存储类的参数。

¹ 如果驱动程序创建了storage帐户，则只需在 storage 类中指定 networkEndpointType: privateEndpoint 参数。 CSI 驱动程序将创建专用终结点和private DNS区域（命名为 privatelink.file.core.chinacloudapi.cn），以及帐户。 如果自带存储帐户，则需要为存储帐户创建专用终结点。 如果在网络隔离群集中使用Azure Files storage，则必须使用“networkEndpointType： privateEndpoint”创建自定义storage类。 可以按照此示例进行参考：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: azurefile-csi
provisioner: file.csi.azure.com
allowVolumeExpansion: true
parameters:
  skuName: Premium_LRS  # available values: Premium_LRS, Standard_LRS, Standard_GRS, Standard_RAGRS, Standard_RAGZRS
  networkEndpointType: privateEndpoint
reclaimPolicy: Delete
volumeBindingMode: Immediate
mountOptions:
  - dir_mode=0777  # modify this permission if you want to enhance the security
  - file_mode=0777
  - mfsymlinks
  - cache=strict  # https://linux.die.net/man/8/mount.cifs
  - nosharesock  # reduce probability of reconnect race
  - actimeo=30  # reduce latency for metadata-heavy workload
  - nobrl  # disable sending byte range lock requests to the server and for applications which have challenges with posix locks

以下参数仅适用于 SMB 协议。

以下参数仅适用于 NFS 协议。

以下参数仅适用于 VNet 设置，例如 NFS 和专用终结点。

下表包含可用于定义 PV 的参数。

以下参数仅适用于 SMB 协议。

以下参数仅适用于 NFS 协议。

若要为动态预配的卷启用托管标识，请执行以下步骤：

1. 使用 YAML 文件创建启用了托管标识的 storage 类，例如，使用以下示例内容azurefile-csi-managed-identity.yaml。 设置 mountWithManagedIdentity: "true" 于 parameters：

    apiVersion: storage.k8s.io/v1
    kind: StorageClass
    metadata:
      name: azurefile-csi
    provisioner: file.csi.azure.com
    parameters:
      resourceGroup: EXISTING_RESOURCE_GROUP_NAME   # optional, node resource group by default if it's not provided
      storageAccount: EXISTING_STORAGE_ACCOUNT_NAME # optional, a new account will be created if it's not provided
      mountWithManagedIdentity: "true"
      # optional, clientID of the managed identity, kubelet identity would be used by default if it's not provided
      clientID: "xxxxx-xxxx-xxx-xxx-xxxxxxx"
    reclaimPolicy: Delete
    volumeBindingMode: Immediate
    allowVolumeExpansion: true
    mountOptions:
     - dir_mode=0777  # modify this permission if you want to enhance the security
     - file_mode=0777
     - uid=0
     - gid=0
     - mfsymlinks
     - cache=strict  # https://linux.die.net/man/8/mount.cifs
     - nosharesock  # reduce probability of reconnect race
     - actimeo=30  # reduce latency for metadata-heavy workload
     - nobrl  # disable sending byte range lock requests to the server
   

2. 通过运行以下命令应用此存储类：

   kubectl apply -f azurefile-csi-managed-identity.yaml
   

3. 使用引用此 PVC 的新的存储类部署 StatefulSet 或工作负荷，以确保使用托管标识身份验证来预配卷。 在 PVC 清单中，设置 storageClassName: azurefile-csi-managed-identity。 例如：

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: azurefile-managed-identity-pvc
   spec:
     accessModes:
      - ReadWriteMany
     storageClassName: azurefile-csi-managed-identity
     resources:
      requests:
       storage: 100Gi
   

若要为静态预配卷启用托管标识，请执行以下步骤：

1. 创建 PV 清单，例如 azurefile-csi-static.yaml。 定义一个引用现有 Azure Files 共享的 PV，并通过在 mountWithManagedIdentity: "true" 下设置 volumeAttributes 来启用托管标识身份验证。

   示例 PV 清单文件：

   apiVersion: v1
   kind: PersistentVolume
   metadata:
     name: pv-azurefile
   spec:
     capacity:
       storage: 100Gi
     accessModes:
       - ReadWriteMany
     persistentVolumeReclaimPolicy: Retain
     storageClassName: azurefile-csi
     mountOptions:
       - dir_mode=0777  # modify this permission if you want to enhance the security
       - file_mode=0777
       - uid=0
       - gid=0
       - mfsymlinks
       - cache=strict  # https://linux.die.net/man/8/mount.cifs
       - nosharesock  # reduce probability of reconnect race
       - actimeo=30  # reduce latency for metadata-heavy workload
       - nobrl  # disable sending byte range lock requests to the server
     csi:
       driver: file.csi.azure.com
       # make sure volumeHandle is unique for every identical share in the cluster
       volumeHandle: "{resource-group-name}#{account-name}#{file-share-name}"
       volumeAttributes:
         resourceGroup: EXISTING_RESOURCE_GROUP_NAME   # optional, node resource group by default if it's not provided
         storageAccount: EXISTING_STORAGE_ACCOUNT_NAME # optional, a new account will be created if it's not provided
         shareName: EXISTING_FILE_SHARE_NAME
         mountWithManagedIdentity: "true"
         # optional, clientID of the managed identity, kubelet identity would be used by default if it's empty
         clientID: "xxxxx-xxxx-xxx-xxx-xxxxxxx"
   

2. 通过运行以下命令，将 PV 部署到您的应用程序 Pod 中：

   kubectl apply -f azurefile-csi-static.yaml
   

本部分介绍如何使用 rsize（读取大小）和 wsize（写入大小）选项，通过 Azure Files CSI 驱动程序优化 NFS 的性能。 rsize和wsize选项设置NFS操作的最大传输大小。 如果rsize或wsize在装载时未指定，则客户端和服务器将协商两者所支持的最大大小。 目前，Azure Files和新式 Linux 分发版都支持大小为 1,048,576 字节（1 MiB）的读写大小。

最佳性能基于高效的客户端-服务器通信。 增加或减少 装载 读取和写入选项大小值可以提高 NFS 性能。 对于客户端和服务器之间传输的读/写数据包，针对 NFS 版本 2 的默认大小为 8 KB，针对 NFS 版本 3 和 4 的默认大小为 32 KB。 这些默认值可能太大或太小。 通过减少rsize和wsize，并为每个 NFS 读取回复和写入请求发送较小的数据包，可以在拥堵的网络中提高 NFS 性能。 但是，这种减少可以增加跨网络发送数据的数据包数，增加客户端和服务器上的网络流量和 CPU 使用率。

请务必执行测试以查找能够维持高效数据包传输的rsize和wsize，确保它们不会降低吞吐量或增加延迟。

例如，若要将最大 rsize 和 wsize 配置为 256-KiB，请在 storage 类中配置 mountOptions，如下所示：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: azurefile-csi-nfs
provisioner: file.csi.azure.com
allowVolumeExpansion: true
parameters:
  protocol: nfs
mountOptions:
  - nconnect=4
  - noresvport
  - actimeo=30
  - rsize=262144
  - wsize=262144

1. 创建一个名为nfs-sc.yaml的文件，并复制示例清单。 有关支持的 mountOptions 列表，请参阅 NFS 装载选项。

   注释

   Azure文件 CSI 驱动程序配置 vers、minorversion 和 sec。 在清单中为这些属性指定值是不支持的。

   apiVersion: storage.k8s.io/v1
   kind: StorageClass
   metadata:
     name: azurefile-csi-nfs
   provisioner: file.csi.azure.com
   allowVolumeExpansion: true
   parameters:
     protocol: nfs
    mountOptions:
     - nconnect=4
     - noresvport
     - actimeo=30
   

2. 编辑并保存 YAML 文件后，使用 kubectl apply 命令应用storage类：

   kubectl apply -f nfs-sc.yaml
   

   命令的输出类似于以下示例：

   storageclass.storage.k8s.io/azurefile-csi-nfs created
   

1. 可以使用以下清单，通过运行 kubectl apply 命令部署一个示例 data.txt，该清单会将时间戳写入名为 的文件中。

   kubectl apply -f
   
   apiVersion: apps/v1
   kind: StatefulSet
   metadata:
     name: statefulset-azurefile
     labels:
       app: nginx
   spec:
     podManagementPolicy: Parallel  # default is OrderedReady
     serviceName: statefulset-azurefile
     replicas: 1
     template:
       metadata:
         labels:
           app: nginx
       spec:
         nodeSelector:
           "kubernetes.io/os": linux
         containers:
           - name: statefulset-azurefile
             image: mcr.azk8s.cn/oss/nginx/nginx:1.19.5
             command:
               - "/bin/bash"
               - "-c"
               - set -euo pipefail; while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
             volumeMounts:
               - name: persistent-storage
                 mountPath: /mnt/azurefile
     updateStrategy:
       type: RollingUpdate
     selector:
       matchLabels:
         app: nginx
     volumeClaimTemplates:
       - metadata:
           name: persistent-storage
         spec:
           storageClassName: azurefile-csi-nfs
           accessModes: ["ReadWriteMany"]
           resources:
             requests:
               storage: 100Gi
   

   命令的输出类似于以下示例：

   statefulset.apps/statefulset-azurefile created
   

2. 通过运行以下命令来验证卷的内容：

   kubectl exec -it statefulset-azurefile-0 -- df -h
   

   命令的输出类似于以下示例：

   Filesystem      Size  Used Avail Use% Mounted on
   ...
   /dev/sda1                                                                                 29G   11G   19G  37% /etc/hosts
   accountname.file.core.chinacloudapi.cn:/accountname/pvc-fa72ec43-ae64-42e4-a8a2-556606f5da38  100G     0  100G   0% /mnt/azurefile
   ...
   

由于 NFS 位于Premium storage帐户中，因此最小文件共享大小为 100 GiB。 如果创建存储容量较小的持久卷声明（PVC），可能会遇到类似于以下输出的错误：

*failed to create file share ... size (5)...*.

以下存储类示例中提供了建议的 SMB 共享挂载选项：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: azurefile-csi
provisioner: file.csi.azure.com
allowVolumeExpansion: true
parameters:
  skuName: Premium_LRS  # available values: Premium_LRS, Standard_LRS, Standard_GRS, Standard_RAGRS, Standard_RAGZRS
reclaimPolicy: Delete
volumeBindingMode: Immediate
mountOptions:
  - dir_mode=0777  # modify this permission if you want to enhance the security
  - file_mode=0777 # modify this permission if you want to enhance the security
  - mfsymlinks    # support symbolic links
  - cache=strict  # https://linux.die.net/man/8/mount.cifs
  - nosharesock  # reduces probability of reconnect race
  - actimeo=30  # reduces latency for metadata-heavy workload
  - nobrl  # disable sending byte range lock requests to the server and for applications which have challenges with posix locks

如果使用高级（SSD）文件共享且工作负荷很重，请注册以使用 metadata 缓存功能来提高性能。

有关详细信息，请参阅 提升 SMB Azure 文件共享性能。

在下面的存储类示例中提供了建议的 NFS 共享挂载选项。

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: azurefile-csi-nfs
provisioner: file.csi.azure.com
parameters:
  protocol: nfs
  skuName: Premium_LRS     # available values: Premium_LRS
reclaimPolicy: Delete
volumeBindingMode: Immediate
allowVolumeExpansion: true
mountOptions:
  - nconnect=4  # improves performance by enabling multiple connections to share
  - noresvport  # improves availability
  - actimeo=30  # reduces latency for metadata-heavy workloads

可以通过增加预读大小来提高读取吞吐量。

虽然Azure Files支持将nconnect设置为最多 16，我们建议使用最佳设置nconnect=4来配置挂载选项。 目前，Azure Files 实现的 nconnect 不支持超过四个渠道的增益。

有关详细信息，请参阅 提升 NFS Azure 文件共享性能。