CoreDNS Amazon EKS 추가 기능 업데이트
CoreDNS Amazon EKS 추가 기능 업데이트
Amazon EKS 유형의 추가 기능을 업데이트합니다. Amazon EKS 추가 기능을 클러스터에 추가하지 않았다면 추가하거나 CoreDNS Amazon EKS self-managed 추가 기능 업데이트를 참조하세요.
시작하기 전에 업그레이드 고려 사항을 검토하세요. 자세한 내용은 중요한 CoreDNS 업그레이드 고려 사항을 참조하세요.
출처: 문서
본문
클러스터에 설치된 추가 기능 버전을 확인합니다. my-cluster를 클러스터 이름으로 바꿉니다.
aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query "addon.addonVersion" --output text
예시 출력은 다음과 같습니다.
v1.10.1-eksbuild.13
반환된 버전이 latest version 표에 있는 클러스터의 Kubernetes 버전 버전과 같다면 이미 최신 버전이 클러스터에 설치되어 있어 이 절차의 나머지 부분을 완료할 필요가 없습니다. 출력에서 버전 번호 대신 오류를 받으면 클러스터에 Amazon EKS 유형의 추가 기능이 설치되어 있지 않은 것입니다. 이 절차로 업데이트하려면 먼저 추가 기능을 만들어야 합니다.
현재 설치된 추가 기능의 구성을 저장합니다.
kubectl get deployment coredns -n kube-system -o yaml > aws-k8s-coredns-old.yaml
AWS CLI를 사용해 추가 기능을 업데이트합니다. AWS Management Console이나 eksctl로 추가 기능을 업데이트하려면 Amazon EKS 추가 기능 업데이트를 참조하세요. 다음 명령을 기기에 복사합니다. 필요에 따라 명령을 다음처럼 수정한 뒤 수정된 명령을 실행합니다.
my-cluster를 클러스터 이름으로 바꿉니다.v1.11.3-eksbuild.1을 클러스터 버전에 대한 latest version 표에 나열된 최신 버전으로 바꿉니다.
--resolve-conflicts PRESERVE 옵션은 추가 기능의 기존 구성 값을 보존합니다. 추가 기능 설정에 사용자 지정 값을 설정했는데 이 옵션을 사용하지 않으면 Amazon EKS가 값을 기본값으로 덮어씁니다. 이 옵션을 사용한다면 프로덕션 클러스터에서 추가 기능을 업데이트하기 전에 비프로덕션 클러스터에서 필드와 값 변경을 테스트할 것을 권장합니다. 이 값을 OVERWRITE로 변경하면 모든 설정이 Amazon EKS 기본값으로 변경됩니다. 어떤 설정에 사용자 지정 값을 설정했다면 Amazon EKS 기본값으로 덮어써질 수 있습니다. 이 값을 none으로 변경하면 Amazon EKS는 어떤 설정 값도 변경하지 않지만 업데이트가 실패할 수 있습니다. 업데이트가 실패하면 충돌을 해결하는 데 도움이 되는 오류 메시지를 받게 됩니다.
구성 설정을 업데이트하지 않는다면 명령에서 --configuration-values '{"replicaCount":3}'를 제거하세요. 구성 설정을 업데이트한다면 "replicaCount":3을 설정하려는 설정으로 바꾸세요. 이 예시에서는 CoreDNS의 복제본 수를 3으로 설정합니다. 지정하는 값은 구성 스키마에 유효해야 합니다. 구성 스키마를 모른다면 aws eks describe-addon-configuration --addon-name coredns --addon-version v1.11.3-eksbuild.1을 실행하고 v1.11.3-eksbuild.1을 구성을 보려는 추가 기능의 버전 번호로 바꾸세요. 스키마가 출력에 반환됩니다. 기존 사용자 지정 구성이 있고 모두 제거한 뒤 모든 설정 값을 Amazon EKS 기본값으로 되돌리려면 명령에서 "replicaCount":3을 제거해 빈 {}로 만드세요. CoreDNS 설정에 대한 자세한 내용은 Kubernetes 문서의 DNS 서비스 사용자 지정(Customizing DNS Service)을 참조하세요.
aws eks update-addon --cluster-name my-cluster --addon-name coredns --addon-version v1.11.3-eksbuild.1 \
--resolve-conflicts PRESERVE --configuration-values '{"replicaCount":3}'
업데이트가 완료되는 데 몇 초가 걸릴 수 있습니다.
추가 기능 버전이 업데이트되었는지 확인합니다. my-cluster를 클러스터 이름으로 바꿉니다.
aws eks describe-addon --cluster-name my-cluster --addon-name coredns
업데이트가 완료되는 데 몇 초가 걸릴 수 있습니다.
예시 출력은 다음과 같습니다.
{
"addon": {
"addonName": "coredns",
"clusterName": "my-cluster",
"status": "ACTIVE",
"addonVersion": "v1.11.3-eksbuild.1",
"health": {
"issues": []
},
"addonArn": "arn:aws:eks:region:111122223333:addon/my-cluster/coredns/d2c34f06-1111-2222-1eb0-24f64ce37fa4",
"createdAt": "2023-03-01T16:41:32.442000+00:00",
"modifiedAt": "2023-03-01T18:16:54.332000+00:00",
"tags": {},
"configurationValues": "{\"replicaCount\":3}"
}
}