Bantu meningkatkan halaman ini

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Untuk berkontribusi pada panduan pengguna ini, pilih GitHub tautan Edit halaman ini di yang terletak di panel kanan setiap halaman.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Buat kelas penyimpanan

A StorageClass dalam Mode Otomatis Amazon EKS mendefinisikan bagaimana volume Amazon EBS disediakan secara otomatis saat aplikasi meminta penyimpanan persisten. Halaman ini menjelaskan cara membuat dan mengonfigurasi StorageClass yang berfungsi dengan Mode Otomatis Amazon EKS untuk menyediakan volume EBS.

Dengan mengonfigurasi aStorageClass, Anda dapat menentukan pengaturan default untuk volume EBS Anda termasuk jenis volume, enkripsi, IOPS, dan parameter penyimpanan lainnya. Anda juga dapat mengonfigurasi StorageClass untuk menggunakan kunci AWS KMS untuk manajemen enkripsi.

Mode Otomatis EKS tidak membuat StorageClass untuk Anda. Anda harus membuat StorageClass referensi ebs.csi.eks.amazonaws.com untuk menggunakan kemampuan penyimpanan Mode Otomatis EKS.

Pertama, buat file bernamastorage-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"

Kedua, terapkan kelas penyimpanan ke cluster Anda.

kubectl apply -f storage-class.yaml

Komponen kunci:

Gunakan kunci KMS yang dikelola sendiri untuk mengenkripsi volume EBS

Untuk menggunakan kunci KMS yang dikelola sendiri untuk mengenkripsi volume EBS yang diotomatisasi oleh Mode Otomatis EKS, Anda perlu:

Contoh Kebijakan KMS IAM yang dikelola sendiri

Perbarui nilai-nilai berikut dalam kebijakan di bawah ini:

{
  "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"
            }
        }
    }
  ]
}

Contoh KMS yang dikelola sendiri StorageClass

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

StorageClassParameter Referensi

Untuk informasi umum tentang StorageClass sumber daya Kubernetes, lihat Kelas Penyimpanan di Dokument asi Kubernetes.

parametersBagian sumber StorageClass daya khusus untuk AWS. Gunakan tabel berikut untuk meninjau opsi yang tersedia.

Untuk informasi selengkapnya, lihat Driver AWS EBS CSI aktif. GitHub

Pertimbangan-pertimbangan

Kemampuan penyimpanan blok dari EKS Auto Mode berbeda dengan EBS CSI Driver.

Bermigrasi dari volume-modier-for-k8s ke VolumeAttributesClass

Untuk cluster Mode Otomatis EKS yang menjalankan Kubernetes 1.34 atau yang lebih baru, gunakan VolumeAttributesClass (VAC) untuk mengubah jenis volume EBS, IOPS, atau throughput.

PVC yang ada dapat dimigrasikan di tempat dengan membuat VAC dan pengaturan spec.volumeAttributesClassName pada PVC yang ada. PVC dan PV tidak dibuat ulang dan tidak ada gangguan pada beban kerja Anda selama proses ini.

Opsional: Hapus anotasi VMK

Menghapus anotasi lama tidak diperlukan agar VAC berfungsi. Setelah PVC atau PV mereferensikan VAC, VMK menolak modifikasi berbasis anotasi dan VAC adalah jalur otoritatif.

Anotasi dapat dihapus nanti sebagai pembersihan konfigurasi. Jika dihapus, perbarui juga Helm, GitOps, atau otomatisasi lain yang akan menambahkannya kembali. Anotasi status VMK yang tersisa di PV tidak berbahaya dan tidak perlu dihapus.

Mengubah atau Mengembalikan Pengaturan

Parameter VAC tidak dapat diubah. Untuk mengubah konfigurasi EBS, buat VAC lain dan tetapkan namanya ke PVC.

Untuk membatalkan perubahan yang belum selesai, kembalikan VAC yang ditetapkan sebelumnya. Jika PVC sebelumnya tidak menggunakannya, bersihkan bidang:

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

Menghapus bidang tidak membatalkan modifikasi EBS yang sudah selesai. Untuk mengembalikan pengaturan volume sebelumnya, buat VAC yang berisi pengaturan tersebut dan tetapkan ke PVC. Batasan parameter EBS normal dan cooldown modifikasi berlaku.

Instal add-on CSI Snapshot Controller

Mode Otomatis EKS kompatibel dengan add-on CSI Snapshot Controller Amazon EKS.

AWS menyarankan Anda mengonfigurasi add-on ini untuk berjalan di kumpulan system node bawaan.

Untuk informasi selengkapnya, lihat:

Untuk menginstal pengontrol snapshot di kumpulan node sistem