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

本部分为想要预配一个或多个永久性卷的群集管理员提供指导，其中包括可供工作负荷使用的 Blob 存储的详细信息。 永久性卷声明（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

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

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

在 AKS 上使用存储 CSI 驱动程序时，还存在两个内置组件，这些组件使用 Azure Blob CSI 存储驱动程序 StorageClasses。

针对这两个存储类的回收策略可确保在删除相应 PV 时删除基础 Azure Blob 存储。 默认情况下，存储类还会将容器配置为可扩展，因为 set allowVolumeExpansion 参数设置为 true。

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

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

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

PVC 使用存储类对象动态预配 Azure Blob 存储容器。 以下 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 存储。

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
   

本部分为想要创建一个或多个 PV 的群集管理员提供指导，其中包括可供工作负荷使用的 Blob 存储的详细信息。

创建 Blob 存储容器

创建用于 AKS 的 Azure Blob 存储资源时，可以在节点资源组中创建资源。 此方法允许 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

接下来，按照 “管理 Blob 存储 ”中的步骤创建用于存储 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 命令创建存储类：

   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 命令创建存储类：

   kubectl apply -f blobfuse-sc.yaml
   

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

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

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

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

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

   注释

   volumeHandle YAML 中的值应当是群集中每个相同的存储 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 存储 CSI 驱动程序不使用此值，因为可以灵活写入数据，直到达到存储帐户的容量限制。 特性的值 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-token] （SAS） 令牌进行身份验证。 还必须提供现有 Azure 存储帐户中的帐户名称和密钥。

   • Kubernetes 密钥
   • SAS 令牌

   以下示例创建一个名为，并填充azure-secret和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。 例如：

   注释

   volumeHandle YAML 中的值应当是群集中每个相同的存储 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
   

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

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

可以使用以下参数使 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
   

   小窍门

   要创建使用高级存储的磁盘，请使用 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 的持久性卷声明，在路径 /mnt/azure 上挂载 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 磁盘时，可以在节点资源组中创建磁盘资源。 此方法允许 AKS 群集访问和管理磁盘资源。 如果想要在单独的资源组中创建磁盘，则必须向群集的 Azure Kubernetes 服务 (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
   

   注释

   Azure 磁盘根据 SKU 和特定大小的规格进行计费。 这些 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。

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

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

有关 Azure 文件的 Kubernetes 存储类的详细信息，请参阅 Kubernetes 存储类。

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 命令创建存储类。

   kubectl apply -f azure-file-sc.yaml
   

创建 PVC

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

1. 创建名为 azure-file-pvc.yaml 的文件，并将其复制到以下 YAML 中。 请确保 storageClassName 与前述步骤中创建的存储类匹配。

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

   注释

   如果将 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 文件共享。 对于 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
   

   现有一个正在运行的 Pod，其中的 Azure 文件共享已装载到 /mnt/azure 目录中。 使用 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

本部分为想要创建一个或多个 PV 的群集管理员提供指导，其中包括要用于工作负荷的现有 Azure 文件共享的详细信息。

创建 Azure 文件共享

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

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

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

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

   MC_myResourceGroup_myAKSCluster_chinanorth3
   

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

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

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

3. 使用以下命令将连接字符串导出为环境变量（用于创建文件共享）。

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

   连接字符串必须通过密钥轮换或存储在 Azure Key Vault 中进行保护。 有关连接字符串的详细信息，请参阅配置 Azure 存储连接字符串和管理存储帐户访问密钥。

   对于生产环境，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_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 存储帐户，请提供帐户名称和密钥。

   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 文件共享装载到 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，其中 Azure 文件共享装载在 /mnt/azure 处。 可以使用 kubectl describe 命令验证是否已成功装载共享。

   kubectl describe pod mypod
   

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

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

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 文件创建启用了托管标识的存储类，例如， 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。 定义一个 PV，此 PV 引用了现有的 Azure 文件共享，并通过在 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
   

本部分介绍如何使用 Azure 文件 CSI 驱动程序和 NFS 的 rsize （读取大小）及 wsize （写入大小）选项进行性能优化。 rsize和wsize选项设置NFS操作的最大传输大小。 如果rsize或wsize在装载时未指定，则客户端和服务器将协商两者所支持的最大大小。 目前，Azure 文件和新式 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，请在存储类中配置 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 命令应用存储类：

   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 位于高级存储帐户中，因此最小文件共享大小为 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）文件共享和工作负荷是元数据密集型的，请注册以使用 元数据缓存 功能来提高性能。

有关详细信息，请参阅 提高 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 文件存储支持 nconnect 设置最大设置为 16，但建议使用最佳设置 nconnect=4配置装载选项。 目前，Azure Files 的 nconnect 实现超过四个通道后没有收益。

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