你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 Azure Kubernetes 服务 (AKS) 中通过 Azure 磁盘创建并使用卷

项目
08/02/2024

永久性卷表示已经过预配的可用于 Kubernetes Pod 的存储块。永久性卷可供一个或多个 Pod 使用，并可进行动态或静态预配。本文介绍如何在 Azure Kubernetes 服务 (AKS) 群集的 Azure 磁盘中动态创建永久性卷。

注意

Azure 磁盘只能使用“访问模式”类型 ReadWriteOnce 进行装载，这使其只可供 AKS 中的一个节点使用。当多个 Pod 在同一节点上运行时，此访问模式仍允许多个 Pod 访问卷。有关详细信息，请参阅 Kubernetes PersistentVolume 访问模式。

本文介绍如何：

通过安装容器存储接口 (CSI) 驱动程序并动态创建一个或多个要附加到 Pod 的 Azure 托管磁盘来使用动态永久性卷 (PV)。
通过创建一个或多个 Azure 托管磁盘来使用静态 PV，或者使用现有 Azure 托管磁盘并将其附加到 Pod。

有关 Kubernetes 卷的详细信息，请参阅 AKS 中应用程序的存储选项。

开始之前

确保已安装且已配置 Azure CLI 版本 2.0.59。运行 az --version 即可查找版本。如果需要进行安装或升级，请参阅安装 Azure CLI。
Azure 磁盘 CSI 驱动程序对节点有卷限制。卷计数因节点/节点池的大小而异。运行 kubectl get 命令以确定可为每个节点分配的卷数：
```
kubectl get CSINode <nodename> -o yaml
```

动态预配卷

本部分为想要预配一个或多个永久性卷的群集管理员提供指导，这些卷中包含供工作负荷使用的 Azure 磁盘存储的详细信息。永久性卷声明 (PVC) 使用存储类对象来动态预配 Azure 磁盘存储容器。

动态 PersistentVolume 的存储类参数

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

名称	含义	可用值	必需	默认值
skuName	Azure 磁盘存储帐户类型（别名：`storageAccountType`）	`Standard_LRS`、`Premium_LRS`、`StandardSSD_LRS`、`PremiumV2_LRS`、`UltraSSD_LRS`、`Premium_ZRS`、`StandardSSD_ZRS`	否	`StandardSSD_LRS`
fsType	文件系统类型	`ext4`、`ext3`、`ext2`、`xfs`、`btrfs`（适用于 Linux）、`ntfs`（适用于 Windows）	否	`ext4`（适用于 Linux），`ntfs`（适用于 Windows）
cachingMode	Azure 数据磁盘主机缓存设置（PremiumV2_LRS 和 UltraSSD_LRS 仅支持 `None` 缓存模式）	`None`、`ReadOnly`、`ReadWrite`	否	`ReadOnly`
resourceGroup	指定 Azure 磁盘的资源组	现有资源组名称	否	如果为空，驱动程序将使用与当前 AKS 群集相同的资源组名称
DiskIOPSReadWrite	UltraSSD 磁盘或 Premium SSD v2 IOPS 能力（最低: 2 IOPS/GiB）	100~160000	否	`500`
DiskMBpsReadWrite	UltraSSD 磁盘或 Premium SSD v2 吞吐能力（最低：0.032/GiB）	1~2000	否	`100`
LogicalSectorSize	超级磁盘的逻辑扇区大小（以字节为单位）。支持的值为 512 和 4096。 4096 是默认值。	`512`、`4096`	否	`4096`
标记	Azure 磁盘标记	标记格式：`key1=val1,key2=val2`	否	""
diskEncryptionSetID	用于启用静态加密的磁盘加密集的 ResourceId	格式：`/subscriptions/{subs-id}/resourceGroups/{rg-name}/providers/Microsoft.Compute/diskEncryptionSets/{diskEncryptionSet-name}`	否	""
diskEncryptionType	磁盘加密集的加密类型。	`EncryptionAtRestWithCustomerKey`（默认），`EncryptionAtRestWithPlatformAndCustomerKeys`	否	""
writeAcceleratorEnabled	Azure 磁盘上的写入加速器	`true`、`false`	否	""
networkAccessPolicy	NetworkAccessPolicy 属性，用于防止生成磁盘或快照的 SAS URI	`AllowAll`、`DenyAll`、`AllowPrivate`	否	`AllowAll`
diskAccessID	用于在磁盘上使用专用终结点的 DiskAccess 资源的 Azure 资源 ID		否	``
enableBursting	启用按需突发超出磁盘的预配性能目标。按需突发应仅应用于高级版磁盘，同时磁盘大小 > 512 GB。不支持超级磁盘和共享磁盘。默认情况下，突发处于禁用状态。	`true`、`false`	否	`false`
useragent	用于客户使用情况归因的用户代理		否	生成的用户代理格式为 `driverName/driverVersion compiler/version (OS-ARCH)`
subscriptionID	指定在其中创建 Azure 磁盘的 Azure 订阅 ID。	Azure 订阅 ID	否	如果不为空，则必须提供 `resourceGroup`。
---	以下参数仅适用于 v2	---	---	---
maxShares	磁盘允许的共享磁盘装载总数。将该值设置为 2 或 2 以上可启用附件副本。	支持的值取决于磁盘大小。有关支持的值，请参阅共享 Azure 托管磁盘。	否	1
maxMountReplicaCount	要维护的副本附件数。	该值必须在 `[0..(maxShares - 1)]` 范围内	否	如果 `accessMode` 为 `ReadWriteMany`，则默认值为 `0`。否则默认值为 `maxShares - 1`

内置存储类

存储类用于定义使用永久性卷动态创建存储单位的方式。有关 Kubernetes 存储类的详细信息，请参阅 Kubernetes 存储类。

每个 AKS 群集包含四个预先创建的存储类，其中两个配置为使用 Azure 磁盘：

default 存储类可预配标准 SSD Azure 磁盘。
- 标准 SSD 支持标准存储，并可以在交付可靠性能的同时提供经济高效的存储。
managed-csi-premium 存储类可预配高级 Azure 磁盘。
- 基于 SSD 的高性能、低延迟磁盘支持高级磁盘。它们非常适合运行生产工作负载的 VM。在 AKS 上使用 Azure 磁盘 CSI 驱动程序时，还可以使用 managed-csi 存储类，该类由标准 SSD 本地冗余存储 (LRS) 提供支持。
从 Kubernetes 版本 1.29 开始，跨多个可用性区域部署 Azure Kubernetes 服务 (AKS) 群集时，AKS 现在利用区域冗余存储 (ZRS) 在内置存储类中创建托管磁盘。
- ZRS 确保在所选区域中的多个 Azure 可用性区域之间同步复制 Azure 托管磁盘。此冗余策略可增强应用程序的复原能力，并保护数据免受数据中心故障的影响。
- 但是，请务必注意，与本地冗余存储 (LRS) 相比，区域冗余存储 (ZRS) 的成本更高。如果成本优化是优先级，则可以使用 LRS SKU 名称参数创建新的存储类，并将其用于永久性卷声明 (PVC)。

由于存在数据丢失的风险，因此不支持减小 PVC 的大小。可以使用 kubectl edit sc 命令编辑现有存储类，也可以创建自己的自定义存储类。例如，如果要使用大小为 4 TiB 的磁盘，需要创建一个定义 cachingmode: None 的存储类，因为磁盘缓存不支持 4 TiB 及更大的磁盘。有关存储类和创建自己的存储类的详细信息，请参阅 AKS 中应用程序的存储选项。

可以使用 kubectl get sc 命令查看预先创建的存储类。以下示例显示了 AKS 群集中可用的预先创建的存储类：

kubectl get sc

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

NAME                PROVISIONER                AGE
default (default)   disk.csi.azure.com         1h
managed-csi         disk.csi.azure.com         1h

注意

永久卷声明在 GiB 中指定，但 Azure 托管磁盘由 SKU 针对特定大小计费。这些 SKU 的范围从用于 S4 或 P4 磁盘的 32 GiB 到用于 S80 或 P80 磁盘的 32 TiB（预览版）。高级托管磁盘的吞吐量和 IOPS 性能取决于 SKU 和 AKS 群集中节点的实例大小。有关详细信息，请参阅托管磁盘的定价和性能。

创建永久性卷声明

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

创建名为 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。

使用 kubectl apply 命令创建永久性卷声明，并指定 azure-pvc.yaml 文件。
```
kubectl apply -f azure-pvc.yaml
```
该命令的输出类似于以下示例：
```
persistentvolumeclaim/azure-managed-disk created
```

使用永久性卷

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

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

kubectl describe pvc azure-managed-disk

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

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

创建名为 azure-pvc-disk.yaml 的文件，并将其复制到以下清单中。以下清单创建的基本 NGINX 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.microsoft.com/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

使用 kubectl apply 命令创建 Pod。
```
 kubectl apply -f azure-pvc-disk.yaml
```
该命令的输出类似于以下示例：
```
pod/mypod created
```

现在你有一个正在运行的 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"
[...]

使用 Azure 超级磁盘

若要使用 Azure 超级磁盘，请参阅在 Azure Kubernetes 服务 (AKS) 上使用超级磁盘。

使用 Azure 标记

有关使用 Azure 标记的详细信息，请参阅在 Azure Kubernetes 服务 (AKS) 中使用 Azure 标记。

静态预配卷

本部分将指导群集管理员如何创建一个或多个永久性卷，并在其中包含供工作负载使用的 Azure 磁盘的详细信息。

永久性卷的静态预配参数

下表包含可用于定义永久性卷的参数。

名称	含义	可用值	必需	默认值
volumeHandle	Azure 磁盘 URI	`/subscriptions/{sub-id}/resourcegroups/{group-name}/providers/microsoft.compute/disks/{disk-id}`	是	空值
volumeAttributes.fsType	文件系统类型	`ext4`、`ext3`、`ext2`、`xfs`、`btrfs`（适用于 Linux）、`ntfs`（适用于 Windows）	否	`ext4`（适用于 Linux）、`ntfs`（适用于 Windows）
volumeAttributes.partition	现有磁盘的分区号（仅在 Linux 上受支持）	`1`、`2`、`3`	否	空（无分区） - 确保分区格式类似于 `-part1`
volumeAttributes.cachingMode	磁盘主机缓存设置	`None`、`ReadOnly`、`ReadWrite`	否	`ReadOnly`

创建 Azure 磁盘

创建用于 AKS 的 Azure 磁盘时，可以在节点资源组中创建磁盘资源。此方法允许 AKS 群集访问和管理磁盘资源。如果想要在单独的资源组中创建磁盘，则必须向群集的 Azure Kubernetes 服务 (AKS) 托管标识授予磁盘资源组的 Contributor 角色。

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

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

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

MC_myResourceGroup_myAKSCluster_eastus

使用 az disk create 命令创建磁盘。指定节点资源组名称和磁盘资源名称，例如 myAKSDisk。以下示例创建一个 20GiB 的磁盘，并在创建后输出磁盘的 ID。如果需要创建与 Windows Server 容器一起使用的磁盘，请添加 --os-type windows 参数以正确格式化该磁盘。
```
az disk create \
  --resource-group MC_myResourceGroup_myAKSCluster_eastus \
  --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_eastus/providers/Microsoft.Compute/disks/myAKSDisk
```

将磁盘作为卷进行装载

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

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_eastus/providers/Microsoft.Compute/disks/myAKSDisk
    volumeAttributes:
      fsType: ext4

创建一个 pvc-azuredisk.yaml 文件，其中包含使用 PersistentVolume 的 PersistentVolumeClaim。

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

使用 kubectl apply 命令创建 PersistentVolume 和 PersistentVolumeClaim，并引用已创建的两个 YAML 文件。
```
kubectl apply -f pv-azuredisk.yaml
kubectl apply -f pvc-azuredisk.yaml
```

使用 kubectl get pvc 命令验证 PersistentVolumeClaim 是否已创建并绑定到 PersistentVolume。

kubectl get pvc pvc-azuredisk

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

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

创建 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.microsoft.com/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

使用 kubectl apply 命令应用配置并装载卷。
```
kubectl apply -f azure-disk-pod.yaml
```

清理资源

完成本文中创建的资源后，可以使用 kubectl delete 命令将其删除。

# Remove the pod
kubectl delete -f azure-pvc-disk.yaml

# Remove the persistent volume claim
kubectl delete -f azure-pvc.yaml

后续步骤

若要了解如何将 CSI 驱动程序用于 Azure 磁盘存储，请参阅将 Azure 磁盘存储与 CSI 驱动程序配合使用。
如需相关的最佳做法，请参阅 AKS 中的存储和备份最佳做法。

通过

在 Azure Kubernetes 服务 (AKS) 中通过 Azure 磁盘创建并使用卷

开始之前

动态预配卷

动态 PersistentVolume 的存储类参数

内置存储类

创建永久性卷声明

使用永久性卷

使用 Azure 超级磁盘

使用 Azure 标记

静态预配卷

永久性卷的静态预配参数

创建 Azure 磁盘

将磁盘作为卷进行装载

清理资源

后续步骤

其他资源