Amazon EBS CSI 마이그레이션 관련 자주 묻는 질문 - Amazon EKS
CSI 드라이버란 무엇인가요?CSI 마이그레이션이란 무엇인가요?버전 1.23 이후 클러스터에 kubernetes.io/aws-ebs StorageClass 볼륨을 탑재할 수 있나요?Amazon EKS 1.23 이후 클러스터에서 kubernetes.io/aws-ebs StorageClass 볼륨을 프로비저닝할 수 있나요?Amazon EKS에서 kubernetes.io/aws-ebs StorageClass 프로비저너가 제거되나요?Amazon EBS CSI 드라이버는 어떻게 설치하나요?Amazon EBS CSI 드라이버가 클러스터에 설치되어 있는지 확인하려면 어떻게 해야 하나요?Amazon EBS CSI 드라이버를 아직 설치하지 않은 경우 Amazon EKS에서 클러스터를 버전 1.23으로 업데이트할 수 없나요?클러스터를 버전 1.23으로 업데이트하기 전에 Amazon EBS CSI 드라이버를 설치하지 않은 경우 어떻게 해야 하나요? 클러스터를 업데이트한 후에 드라이버를 설치할 수 있나요?새로 생성된 Amazon EKS 버전 1.23 이후 클러스터에 적용되는 기본 StorageClass는 무엇인가요?클러스터를 버전 1.23으로 업데이트할 때 Amazon EKS에서 기존 클러스터에 이미 있던 StorageClasses를 변경하나요?스냅샷을 이용하여 kubernetes.io/aws-ebsStorageClass에서 ebs.csi.aws.com으로 영구 볼륨을 어떻게 마이그레이션하나요?주석을 사용하여 Amazon EBS 볼륨을 수정하려면 어떻게 해야 하나요?Windows 워크로드에 대해 마이그레이션이 지원되나요?

이 페이지 개선에 도움 주기

이 사용자 설명서에 기여하고 싶으신가요? 이 페이지 하단으로 스크롤하여 GitHub에서 이 페이지 편집을 선택하세요. 여러분의 기여는 모두를 위한 더 나은 사용자 설명서를 만드는 데 도움이 됩니다.

Amazon EBS CSI 마이그레이션 관련 자주 묻는 질문

중요

버전 1.22 이전의 클러스터에서 Pods를 실행하고 있는 경우 서비스 중단이 발생하지 않도록 클러스터를 버전 1.23으로 업데이트하기 전에 Amazon EBS 드라이버를 설치해야 합니다.

Amazon EBS 컨테이너 스토리지 인터페이스(CSI) 마이그레이션 기능은 스토리지 작업 처리에 대한 책임을 Amazon EBS 인트리 EBS 스토리지 프로비저너에서 Amazon EBS CSI 드라이버로 이전합니다.

CSI 드라이버란 무엇인가요?

CSI 드라이버:

  • Kubernetes 프로젝트 소스 코드에 있는 Kubernetes ‘in-tree’ 스토리지 드라이버 드라이버를 대체합니다.

  • Amazon EBS와 같은 스토리지 공급자와 협력합니다.

  • AWS와 같은 스토리지 제공업체에서 Kubernetes 릴리스 주기에 의존하지 않고 더 쉽게 기능을 릴리스하고 지원을 유지할 수 있는 간소화된 플러그인 모델을 제공합니다.

자세한 내용은 Kubernetes CSI 설명서에서 소개를 참조하세요.

CSI 마이그레이션이란 무엇인가요?

Kubernetes CSI 마이그레이션 기능은 스토리지 작업을 처리하는 책임을 kubernetes.io/aws-ebs와 같은 기존 in-tree 스토리지 플러그인에서 해당 CSI 드라이버로 이전합니다. 기존 StorageClass, PersistentVolume, PersistentVolumeClaim(PVC) 객체는 해당 CSI 드라이버가 설치되어 있는 한 계속 작동합니다. 기능이 활성화된 경우

  • PVC를 활용하는 기존 워크로드는 항상 그렇듯이 계속 작동합니다.

  • Kubernetes에서 모든 스토리지 관리 작업에 대한 제어를 CSI 드라이버에 전달합니다.

자세한 내용은 Kubernetes 블로그의 Kubernetes1.23: Kubernetes In-Tree to CSI Volume Migration Status Update( In-Tree에서 CSI 볼륨 마이그레이션 상태 업데이트)를 참조하세요.

in-tree 플러그인에서 CSI 드라이버로 마이그레이션하는 데 도움이 되도록 Amazon EKS 버전 1.23 이후 클러스터에서 기본적으로 CSIMigration 및 CSIMigrationAWS 플래그가 활성화됩니다. 이러한 플래그를 사용하면 클러스터가 in-tree API를 동일한 CSI API로 변환할 수 있습니다. 이 플래그는 Amazon EKS에서 관리하는 Kubernetes 컨트롤 플레인과 Amazon EKS 최적화 AMI에 구성된 kubelet 설정에서 설정합니다. Pods에서 클러스터의 Amazon EBS 볼륨을 사용하는 경우 클러스터를 버전 1.23으로 업데이트하기 전에 Amazon EBS CSI 드라이버를 설치해야 합니다. 그렇지 않으면 프로비저닝 및 탑재와 같은 볼륨 작업이 예상대로 작동하지 않을 수 있습니다. 자세한 내용은 Amazon EBS를 사용한 Kubernetes 볼륨 저장 단원을 참조하십시오.

참고

in-tree StorageClass 프로비저너는 kubernetes.io/aws-ebs라고 합니다. Amazon EBS CSI StorageClass 프로비저너는 ebs.csi.aws.com이라고 합니다.

버전 1.23 이후 클러스터에 kubernetes.io/aws-ebs StorageClass 볼륨을 탑재할 수 있나요?

예. Amazon EBS CSI 드라이버가 설치되어 있는 한 가능합니다. 새로 생성된 버전 1.23 이후 클러스터의 경우 클러스터 생성 프로세스의 일부로 Amazon EBS CSI 드라이버를 설치하는 것이 좋습니다. 또한 ebs.csi.aws.com 프로비저너를 기반으로 한 StorageClasses만을 사용하는 것이 좋습니다.

클러스터 컨트롤 플레인을 버전 1.23으로 업데이트했으며 아직 노드를 1.23으로 업데이트하지 않은 경우 CSIMigration 및 CSIMigrationAWS kubelet 플래그가 활성화되지 않습니다. 이 경우 in-tree 드라이버를 사용하여 kubernetes.io/aws-ebs 기반 볼륨을 탑재합니다. 그러나 kubernetes.io/aws-ebs 기반 볼륨을 사용하는 Pods를 예약할 수 있으려면 Amazon EBS CSI 드라이버가 여전히 설치되어 있어야 합니다. 다른 볼륨 작업이 성공하려면 드라이버도 필요합니다.

Amazon EKS 1.23 이후 클러스터에서 kubernetes.io/aws-ebs StorageClass 볼륨을 프로비저닝할 수 있나요?

예. Amazon EBS CSI 드라이버가 설치되어 있는 한 가능합니다.

Amazon EKS에서 kubernetes.io/aws-ebs StorageClass 프로비저너가 제거되나요?

kubernetes.io/aws-ebsStorageClass프로비저닝 장치 및awsElasticBlockStore 볼륨 유형은 더 이상 지원되지 않지만 제거할 계획은 없습니다. 이러한 리소스는Kubernetes API의 일부로 취급됩니다.

Amazon EBS CSI 드라이버는 어떻게 설치하나요?

Amazon EBS CSI 드라이버 Amazon EKS 추가 기능을 설치하는 것이 좋습니다. Amazon EKS 추가 기능에 업데이트가 필요한 경우 사용자가 업데이트를 시작합니다. 그러면 Amazon EKS가 추가 기능을 업데이트합니다. 드라이버를 직접 관리하려면 오픈 소스 Helm 차트를 사용하여 설치할 수 있습니다.

중요

Kubernetes in-tree Amazon EBS 드라이버가 Kubernetes 컨트롤 플레인에서 실행됩니다. Amazon EKS 클러스터 IAM 역할에 할당된 IAM 권한을 사용하여 Amazon EBS 볼륨을 프로비저닝합니다. Amazon EBS CSI 드라이버가 노드에서 실행됩니다. 드라이버에 볼륨을 프로비저닝하려면 IAM 권한이 필요합니다. 자세한 내용은 1단계 - IAM 역할 생성 단원을 참조하십시오.

Amazon EBS CSI 드라이버가 클러스터에 설치되어 있는지 확인하려면 어떻게 해야 하나요?

클러스터에 드라이버가 설치되어 있는지 확인하려면 다음 명령을 실행합니다.

kubectl get csidriver ebs.csi.aws.com

해당 설치가 Amazon EKS에서 관리되는지 확인하려면 다음 명령을 실행합니다.

aws eks list-addons --cluster-name my-cluster

Amazon EBS CSI 드라이버를 아직 설치하지 않은 경우 Amazon EKS에서 클러스터를 버전 1.23으로 업데이트할 수 없나요?

아니요.

클러스터를 버전 1.23으로 업데이트하기 전에 Amazon EBS CSI 드라이버를 설치하지 않은 경우 어떻게 해야 하나요? 클러스터를 업데이트한 후에 드라이버를 설치할 수 있나요?

예. 그러나 Amazon EBS CSI 드라이버가 필요한 볼륨 작업은 클러스터 업데이트 후 드라이버가 설치될 때까지 실패합니다.

새로 생성된 Amazon EKS 버전 1.23 이후 클러스터에 적용되는 기본 StorageClass는 무엇인가요?

기본 StorageClass 동작은 변경되지 않습니다. Amazon EKS는 각각의 새 클러스터에 gp2라는 kubernetes.io/aws-ebs 기반 StorageClass를 적용합니다. 새로 생성된 클러스터에서 이 StorageClass를 제거할 계획은 없습니다. 클러스터 기본 StorageClass와 별개로 볼륨 유형을 지정하지 않고 ebs.csi.aws.com 기반 StorageClass를 생성하는 경우 Amazon EBS CSI 드라이버는 기본적으로 gp3를 사용하도록 설정됩니다.

클러스터를 버전 1.23으로 업데이트할 때 Amazon EKS에서 기존 클러스터에 이미 있던 StorageClasses를 변경하나요?

아니요.

스냅샷을 이용하여 kubernetes.io/aws-ebsStorageClass에서 ebs.csi.aws.com으로 영구 볼륨을 어떻게 마이그레이션하나요?

영구 볼륨을 마이그레이션하려면 AWS 블로그의 Migrating Amazon EKS clusters from gp2 to gp3 EBS volumes(gp2에서 gp3 EBS 볼륨으로 Amazon EKS 클러스터 마이그레이션)를 참조하세요.

주석을 사용하여 Amazon EBS 볼륨을 수정하려면 어떻게 해야 하나요?

aws-ebs-csi-driver v1.19.0-eksbuild.2부터 PersistentVolumeClaim(PVC) 내의 주석을 사용하여 Amazon EBS 볼륨을 수정할 수 있습니다. 새로운 볼륨 수정 기능은 volumemodifier라는 추가 사이드카로 구현됩니다. 자세한 내용은 AWS 블로그의 Simplifying Amazon EBS volume migration and modification on Kubernetes using the EBS CSI Driver를 참조하세요.

Windows 워크로드에 대해 마이그레이션이 지원되나요?

예. 오픈 소스 차트 Helm을 사용하여 Amazon EBS CSI 드라이버를 설치하는 경우 node.enableWindows를 true로 설정합니다. Amazon EKS 추가 기능으로 Amazon EBS CSI 드라이버를 설치하는 경우 기본적으로 설정되어 있습니다. StorageClasses를 생성할 때 fsType을 ntfs와 같은 Windows 파일 시스템으로 설정합니다. 그런 다음 Windows 워크로드에 대한 볼륨 작업이 Linux 워크로드와 마찬가지로 Amazon EBS CSI 드라이버로 마이그레이션됩니다.