**이 페이지 개선에 도움 주기** 

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

# CoreDNS Amazon EKS 추가 기능 생성
<a name="coredns-add-on-create"></a>

CoreDNS Amazon EKS 추가 기능을 생성합니다. 추가 기능을 생성하기 전에 클러스터가 있어야 합니다. 자세한 내용은 [Amazon EKS 클러스터 생성](create-cluster.md) 섹션을 참조하세요.

1. 클러스터에 설치된 추가 기능의 버전을 확인하세요.

   ```
   kubectl describe deployment coredns --namespace kube-system | grep coredns: | cut -d : -f 3
   ```

   예제 출력은 다음과 같습니다.

   ```
   v1.10.1-eksbuild.13
   ```

1. 클러스터에 설치된 추가 기능의 유형을 확인하세요. 클러스터를 생성하는 데 사용한 도구에 따라 현재 클러스터에 Amazon EKS 추가 기능이 유형이 설치되어 있지 않을 수 있습니다. *my-cluster*를 해당 클러스터의 이름으로 바꿉니다.

   ```
   aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query addon.addonVersion --output text
   ```

   버전 번호가 반환되는 경우 Amazon EKS 유형의 추가 기능이 클러스터에 설치되고 본 절차의 나머지 단계를 완료할 필요가 없습니다. 오류가 번호가 반환되는 경우 Amazon EKS 유형의 추가 기능이 클러스터에 설치되지 않습니다. 이 절차의 나머지 단계를 완료하여 설치하세요.

1. 현재 설치된 추가 기능의 구성을 저장합니다.

   ```
   kubectl get deployment coredns -n kube-system -o yaml > aws-k8s-coredns-old.yaml
   ```

1. AWS CLI를 사용하여 추가 기능을 생성합니다. AWS Management Console 또는 `eksctl`를 사용하여 추가 기능을 만들려면 [Amazon EKS 추가 기능 생성](creating-an-add-on.md)을 참조하여 추가 기능 이름을 `coredns`로 지정하세요. 다음 명령을 디바이스에 복사합니다. 필요에 따라 명령을 다음과 같이 수정한 다음에 수정한 명령을 실행합니다.
   + *my-cluster*를 해당 클러스터의 이름으로 바꿉니다.
   + *v1.11.3-eksbuild.1*을 클러스터 버전의 [최신 버전 테이블](managing-coredns.md#coredns-versions)에 나와 있는 최신 버전으로 바꿉니다.

     ```
     aws eks create-addon --cluster-name my-cluster --addon-name coredns --addon-version v1.11.3-eksbuild.1
     ```

     Amazon EKS 추가 기능의 기본 설정과 충돌하는 사용자 지정 설정을 현재 추가 기능에 적용한 경우 생성이 실패할 수 있습니다. 생성에 실패하면 문제 해결에 도움이 될 수 있는 오류를 받게 됩니다. 또는 이전 명령에 `--resolve-conflicts OVERWRITE`을(를) 추가할 수 있습니다. 이렇게 하면 추가 기능이 기존 사용자 지정 설정을 덮어쓸 수 있습니다. 추가 기능을 만든 후에는 사용자 지정 설정으로 업데이트할 수 있습니다.

1. 클러스터의 Kubernetes 버전에 맞는 추가 기능의 최신 버전이 클러스터에 추가되었는지 확인합니다. *my-cluster*를 해당 클러스터의 이름으로 바꿉니다.

   ```
   aws eks describe-addon --cluster-name my-cluster --addon-name coredns --query addon.addonVersion --output text
   ```

   추가 기능 생성이 완료되는 데 몇 초 정도 걸릴 수 있습니다.

   예제 출력은 다음과 같습니다.

   ```
   v1.11.3-eksbuild.1
   ```

1. 원래 추가 기능을 사용자 지정 설정했다면 Amazon EKS 추가 기능을 생성하기 전에 이전 단계에서 저장한 구성을 사용하여 Amazon EKS 추가 기능을 사용자 지정 설정으로 업데이트하세요. 애드온을 업데이트하는 방법은 [CoreDNS Amazon EKS 추가 기능 업데이트](coredns-add-on-update.md)을 참조하세요.