Amazon EKS의 관리형 노드 그룹과 관련된 사용자 지정 시작 템플릿 문제를 해결하려면 어떻게 해야 합니까?

3분 분량

Amazon Elastic Kubernetes Service(Amazon EKS) 클러스터에서 관리형 노드 그룹에 사용자 지정 시작 템플릿을 사용할 때 발생하는 오류를 해결하고 싶습니다.

간략한 설명

Amazon EKS 클러스터의 관리형 노드 그룹에 사용자 지정 시작 템플릿을 사용할 때 다음 오류 중 하나가 발생할 수 있습니다.

"Client.InternalError: Client error on launch"
"SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found"
"Node group entered a DEGRADED status"

해결 방법

Client.InternalError: Client error on launch

이 오류는 사용자 지정 시작 템플릿에서 암호화된 Amazon Elastic Block Store(Amazon EBS) 볼륨을 잘못된 권한으로 사용할 때 발생합니다. 암호화 상태와 AWS Identity and Access Management(IAM) 권한 또는 정책을 확인하려면 다음을 확인하세요.

볼륨을 암호화하는 데 사용된 AWS Key Management Service(AWS KMS) 키가 활성화되어 있습니다.
AWS KMS 키에 올바른 키 정책이 있습니다. 더 많은 IAM 역할이 암호화된 Amazon EBS 볼륨으로 작업할 수 있게 하려면 키 정책을 수정할 수 있습니다. 자세한 내용은 키 사용자가 KMS 키를 사용하도록 허용을 참조하세요.

SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found

이 오류는 Amazon EKS 대신 노드의 Auto Scaling 그룹을 통해 사용자 지정 시작 템플릿 버전을 수동으로 변경할 때 발생합니다. 이 문제를 해결하려면 Amazon EKS를 사용하여 시작 템플릿 버전을 업데이트해야 합니다.

관리형 노드 그룹에서 EC2 시작 템플릿을 업데이트하려면 다음 단계를 완료하세요.

Amazon EKS 콘솔을 엽니다.
탐색 창에서 **클러스터(Clusters)**를 선택합니다.
**클러스터 이름(Cluster name)**에서 업데이트할 노드 그룹이 포함된 클러스터를 선택합니다.
계산(Compute) 탭을 선택합니다.
노드 그룹의 경우 노드를 선택한 다음 **버전 변경(Change version)**을 선택합니다.
노드 그룹에 적용할 버전을 선택합니다. 업데이트 전략이 **롤링 업데이트(Rolling Update)**로 설정되어 있는지 확인합니다.
**업데이트(Update)**를 선택합니다.

자세한 내용은 관리형 노드 그룹 업데이트를 참조하세요.

Node group entered a DEGRADED status after creating a new launch template

노드 그룹은 다음과 비슷한 오류와 함께 DEGRADED 상태로 전환될 수 있습니다.

"The Amazon EC2 Launch Template : lt-xxxxxxxxxxxxxxxxx has a new version associated with your Autoscaling group, which is not managed by Amazon EKS. Expected Launch Template version : x".

이 문제는 관리형 노드 그룹의 Amazon EC2 시작 템플릿 버전이 Amazon EKS에서 생성한 버전과 일치하지 않을 때 발생합니다. 사용자 지정 시작 템플릿을 사용하지 않는 기존 노드 그룹은 직접 업데이트할 수 없습니다. 이 문제를 해결하려면 원하는 설정으로 시작 템플릿과 버전을 만든 다음 해당 시작 템플릿을 사용하여 노드 그룹을 생성합니다. 사용자 지정 템플릿에서 새 노드 그룹을 시작하는 경우 새 버전의 템플릿을 만들 수 있습니다. 노드 그룹을 DEGREDED 상태로 전환하지 않고도 이 템플릿을 사용할 수 있습니다.