協助改進此頁面

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

若要為本使用者指南貢獻內容，請點選每個頁面右側面板中的在 GitHub 上編輯此頁面連結。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

建立儲存類別

在 Amazon EKS 自動模式中，StorageClass 定義了當應用程式請求持久性儲存時，如何自動佈建 Amazon EBS 磁碟區。本頁面闡釋了如何建立和設定與 Amazon EKS 自動模式協同工作的 StorageClass，以佈建 EBS 磁碟區。

透過設定 StorageClass，您可為 EBS 磁碟區指定預設設定，包括磁碟區類型、加密、IOPS 和其他儲存參數。您也可以StorageClass將 設定為使用 AWS KMS 金鑰進行加密管理。

EKS 自動模式不會為您建立 StorageClass。您必須建立 StorageClass 參考 ebs.csi.eks.amazonaws.com，以使用 EKS 自動模式的儲存功能。

首先，建立名為 storage-class.yaml 的檔案：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: auto-ebs-sc
  annotations:
    storageclass.kubernetes.io/is-default-class: "true"
allowedTopologies:
- matchLabelExpressions:
  - key: eks.amazonaws.com/compute-type
    values:
    - auto
provisioner: ebs.csi.eks.amazonaws.com
volumeBindingMode: WaitForFirstConsumer
parameters:
  type: gp3
  encrypted: "true"

接著，將儲存體方案套用至您的叢集。

kubectl apply -f storage-class.yaml

關鍵元件：

使用自我管理的 KMS 金鑰加密 EBS 磁碟區

要使用自我管理的 KMS 金鑰來加密由 EKS 自動模式自動佈建的 EBS 磁碟區，您需要：

自我管理 KMS IAM 政策範例

更新下方政策中的以下值：

{
  "Version":"2012-10-17",
  "Id": "key-auto-policy-3",
  "Statement": [
      {
          "Sid": "Enable IAM User Permissions",
          "Effect": "Allow",
          "Principal": {
              "AWS": "arn:aws:iam::123456789012:root"
          },
          "Action": "kms:*",
          "Resource": "*"
      },
      {
        "Sid": "Allow access through EBS for all principals in the account that are authorized to use EBS",
        "Effect": "Allow",
        "Principal": {
            "AWS": "*"
        },
        "Action": [
            "kms:Encrypt",
            "kms:Decrypt",
            "kms:ReEncrypt*",
            "kms:GenerateDataKey*",
            "kms:CreateGrant",
            "kms:DescribeKey"
        ],
        "Resource": "*",
        "Condition": {
            "StringEquals": {
                "kms:CallerAccount": "123456789012",
                "kms:ViaService": "ec2.us-east-1.amazonaws.com"
            }
        }
    }
  ]
}

自我管理的 KMS StorageClass 範例

parameters:
  type: gp3
  encrypted: "true"
  kmsKeyId: <custom-key-arn>

StorageClass 參數參考

有關 Kubernetes StorageClass 資源的一般資訊，請參閱 Kubernetes 文件中的儲存類別。

StorageClass 資源的 parameters區段是特定的 AWS。請使用下列資料表檢閱可用的選項。

如需詳細資訊，請參閱 GitHub 上的 AWS EBS CSI 驅動程式。

考量事項

EKS 自動模式的區塊儲存功能與 EBS CSI 驅動程式不同。

從 volume-modifier-for-k8s 遷移至 VolumeAttributesClass

對於執行 Kubernetes 1.34 或更新版本的 EKS Auto Mode 叢集，請使用 VolumeAttributesClass(VAC) 來變更 EBS 磁碟區的類型、IOPS 或輸送量。

您可以在現有的 PVCsspec.volumeAttributesClassName上建立 VAC 和設定，以遷移現有的 PVC。PVC 和 PV 不會重新建立，而且在此過程中不會中斷您的工作負載。

選用：移除 VMK 註釋

不需要移除舊註釋，VAC 才能運作。一旦 PVC 或 PV 參考 VAC，VMK 會拒絕以註釋為基礎的修改，而 VAC 是授權路徑。

稍後可能會在組態清除時移除註釋。如果移除它們，也請更新任何 Helm、GitOps 或其他會新增它們的自動化。保留在 PV 上的 VMK 狀態註釋是無害的，不需要移除。

變更或還原設定

VAC 參數不可變。若要變更 EBS 組態，請建立另一個 VAC，並將其名稱指派給 PVC。

若要取消尚未完成的變更，請還原先前指派的 VAC。如果 PVC 之前未使用，請清除 欄位：

kubectl patch pvc <pvc-name> -n <namespace> --type=merge \
  -p '{"spec":{"volumeAttributesClassName":null}}'

清除 欄位不會復原已完成的 EBS 修改。若要還原先前的磁碟區設定，請建立包含這些設定的 VAC，並將其指派給 PVC。一般 EBS 參數限制條件和修改冷卻時間適用。

安裝 CSI 快照控制器附加元件

EKS 自動模式與 CSI 快照控制器 Amazon EKS 附加元件相容。

AWS 建議您將此附加元件設定為在內建system節點集區上執行。

如需詳細資訊，請參閱：

在系統節點集區中安裝快照控制器