이 페이지 개선에 도움 주기

이 사용자 가이드에 기여하려면 모든 페이지의 오른쪽 창에 있는 GitHub에서 이 페이지 편집 링크를 선택합니다.

스토리지 클래스 생성

Amazon EKS 자동 모드의 StorageClass는 애플리케이션이 영구 스토리지를 요청할 때 Amazon EBS 볼륨이 자동으로 프로비저닝되는 방식을 정의합니다. 이 페이지에서는 Amazon EKS 자동 모드와 함께 작동하여 EBS 볼륨을 프로비저닝하는 StorageClass를 생성하고 구성하는 방법을 설명합니다.

StorageClass를 구성하여 볼륨 유형, 암호화, IOPS 및 기타 스토리지 파라미터를 포함하여 EBS 볼륨에 대한 기본 설정을 지정할 수 있습니다. 암호화 관리에 AWS KMS 키를 사용하도록 StorageClass를 구성할 수도 있습니다.

EKS 자동 모드는 StorageClass를 생성하지 않습니다. EKS 자동 모드의 스토리지 기능을 사용하려면 ebs.csi.eks.amazonaws.com을 참조하는 StorageClass를 생성해야 합니다.

첫째, 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 Auto Mode로 자동화된 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 설명서의 Storage Classes를 참조하세요.

StorageClass 리소스의 parameters 섹션은 AWS에 특정합니다. 다음 표를 이용하여 사용 가능한 옵션을 검토하세요.

자세한 내용은 GitHub의 AWS EBS CSI 드라이버를 참조하세요.

고려 사항

EKS Auto Mode의 블록 스토리지 기능은 EBS CSI 드라이버와 다릅니다.

volume-modifier-for-k8s에서 VolumeAttributesClass로 마이그레이션

Kubernetes 1.34 이후 버전을 실행 중인 EKS Auto Mode 클러스터의 경우, VolumeAttributesClass(VAC)를 사용해 EBS 볼륨의 유형, IOPS 또는 처리량을 변경합니다.

VAC를 생성하고 기존 PVC에서 spec.volumeAttributesClassName을 설정하면 기존 PVC를 제자리에서 마이그레이션할 수 있습니다. PVC와 PV가 재생성되지 않고, 이 프로세스 중에 워크로드에 중단이 발생하지 않습니다.

선택 사항: VMK 주석 제거

기존 주석을 제거하지 않아도 VAC는 작동합니다. PVC 또는 PV가 VAC를 참조하면 VMK가 주석 기반 수정을 거부하고, VAC가 권한 있는 경로가 됩니다.

주석은 나중에 구성 정리로 제거할 수 있습니다. 주석을 제거하는 경우, 주석을 다시 추가하는 각종 헬름, GitOps 또는 기타 자동화도 업데이트하세요. PV에 남은 VMK 상태 주석은 무해하며 제거할 필요가 없습니다.

설정 변경 또는 되돌리기

VAC 파라미터는 변경 불가합니다. EBS 구성을 변경하려면 VAC를 하나 더 생성해 해당 VAC의 이름을 PVC에 할당하세요.

완료되지 않은 변경 사항을 취소하려면 이전에 할당한 VAC를 복원합니다. PVC가 이전에 VAC를 사용하지 않았다면, 해당 필드를 지우세요.

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

필드를 지워도 이미 완료된 EBS 수정 사항이 실행 취소되지는 않습니다. 이전 볼륨 설정을 복원하려면 해당 설정을 포함하는 VAC를 생성해 해당 VAC를 PVC에 할당하세요. 정상적인 EBS 파라미터 제한 사항 및 수정 휴지 기간이 적용됩니다.

CSI 스냅샷 컨트롤러 추가 기능 설치

EKS Auto Mode는 CSI 스냅샷 컨트롤러 Amazon EKS 추가 기능과 호환됩니다.

AWS에서는 이 추가 기능을 내장 system 노드 풀에서 실행하도록 구성할 것을 제안합니다.

자세한 내용은 다음을 참조하세요.

시스템 노드 풀에 스냅샷 컨트롤러를 설치하려면