클러스터에서 Amazon EKS 추가 기능 제거

eksctl, AWS Management Console 또는 AWS CLI로 클러스터에서 Amazon EKS 추가 기능을 제거할 수 있습니다.

클러스터에서 Amazon EKS 추가 기능을 제거하면:

추가 기능이 제공하는 기능에 대한 다운타임이 없습니다.
IAM Roles for Service Accounts(IRSA)를 사용 중이고 추가 기능에 연결된 IAM 역할이 있다면 IAM 역할은 제거되지 않습니다.
Pod Identities를 사용 중이라면 추가 기능이 소유한 모든 Pod Identity Association이 제거됩니다. AWS CLI에 --preserve 옵션을 지정하면 연결이 보존됩니다.
Amazon EKS가 추가 기능의 설정 관리를 중단합니다.
콘솔이 새 버전이 제공될 때 더 이상 알리지 않습니다.
어떤 AWS 도구나 API로도 추가 기능을 업데이트할 수 없습니다.

추가 기능 소프트웨어를 클러스터에 남겨 둘지(직접 관리하기 위해) 아니면 클러스터에서 제거할지 선택할 수 있습니다. 추가 기능이 제공하는 기능에 의존하는 클러스터 리소스가 없을 때만 클러스터에서 추가 기능 소프트웨어를 제거해야 합니다.

출처: 문서

본문

사전 요구 사항

추가 기능을 제거하기 전에 다음을 완료하세요.

기존 Amazon EKS 클러스터. 배포하려면 Amazon EKS 시작하기(Get started with Amazon EKS)를 참조하세요.
추가 기능에 IAM 역할이 필요한지 확인합니다. 자세한 내용은 Amazon EKS 추가 기능에 대한 IAM 정보 검색을 참조하세요.
기기나 AWS CloudShell에 eksctl 명령줄 도구 버전 0.215.0 이상이 설치되어 있습니다. eksctl을 설치하거나 업데이트하려면 eksctl 문서의 설치(Installation)를 참조하세요.

절차

Amazon EKS 추가 기능을 제거할 때 두 가지 옵션이 있습니다.

클러스터에서 추가 기능 소프트웨어 보존 – 이 옵션은 Amazon EKS의 설정 관리를 제거합니다. 또한 Amazon EKS가 업데이트를 알리고 업데이트 시작 후 Amazon EKS 추가 기능을 자동 업데이트하는 기능도 제거합니다. 그러나 클러스터의 추가 기능 소프트웨어는 보존합니다. 이 옵션은 추가 기능을 Amazon EKS 추가 기능이 아닌 self-managed 설치로 만듭니다. 이 옵션에서는 추가 기능에 다운타임이 없습니다.
클러스터에서 추가 기능 소프트웨어를 완전히 제거 – 클러스터에 이에 의존하는 리소스가 없을 때만 Amazon EKS 추가 기능을 클러스터에서 제거할 것을 권장합니다.

eksctl, AWS Management Console 또는 AWS CLI로 Amazon EKS 추가 기능을 제거할 수 있습니다.

추가 기능 제거(eksctl)

클러스터에 설치된 현재 추가 기능을 결정합니다. my-cluster를 클러스터 이름으로 바꿉니다.

eksctl get addon --cluster my-cluster

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

NAME        VERSION              STATUS  ISSUES  IAMROLE  UPDATE AVAILABLE
coredns     v1.8.7-eksbuild.2    ACTIVE  0
kube-proxy  v1.23.7-eksbuild.1   ACTIVE  0
vpc-cni     v1.10.4-eksbuild.1   ACTIVE  0
[...]

클러스터에 있는 추가 기능과 버전에 따라 출력이 다를 수 있습니다.

추가 기능을 제거합니다. my-cluster를 클러스터 이름으로, name-of-add-on을 이전 단계의 출력에서 반환된 제거하려는 추가 기능 이름으로 바꿉니다. --preserve 옵션을 제거하면 Amazon EKS가 추가 기능을 더 이상 관리하지 않는 데 더해 추가 기능 소프트웨어도 클러스터에서 삭제됩니다.

eksctl delete addon --cluster my-cluster --name name-of-addon --preserve

추가 기능 제거에 대한 자세한 내용은 eksctl 문서의 Deleting addons를 참조하세요.

추가 기능 제거(AWS 콘솔)

Amazon EKS 콘솔을 엽니다.
왼쪽 탐색 창에서 클러스터(Clusters)를 선택합니다.
Amazon EKS 추가 기능을 제거할 클러스터의 이름을 선택합니다.
Add-ons 탭을 선택합니다.
제거할 추가 기능을 선택합니다.
제거(Remove)를 선택합니다.
Remove: name of addon 확인 대화 상자에서 다음을 수행합니다.
- Amazon EKS가 추가 기능의 설정 관리를 중단하길 원한다면 Preserve on cluster를 선택합니다. 클러스터에 추가 기능 소프트웨어를 유지하려면 이렇게 합니다. 이는 추가 기능의 모든 설정을 직접 관리할 수 있게 하기 위함입니다.
- 추가 기능 이름을 입력합니다.
- 제거(Remove)를 선택합니다.

추가 기능 제거(AWS CLI)

기기나 AWS CloudShell에 eksctl 명령줄 도구 버전 0.215.0 이상이 설치되어 있어야 합니다. eksctl을 설치하거나 업데이트하려면 eksctl 문서의 설치(Installation)를 참조하세요.

설치된 추가 기능 목록을 봅니다. my-cluster를 클러스터 이름으로 바꿉니다.

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

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

{
    "addons": [
        "coredns",
        "kube-proxy",
        "vpc-cni",
        "name-of-addon"
    ]
}

설치된 추가 기능을 제거합니다. my-cluster를 클러스터 이름으로, name-of-add-on을 제거하려는 추가 기능 이름으로 바꿉니다. --preserve를 제거하면 클러스터에서 추가 기능 소프트웨어가 삭제됩니다.

aws eks delete-addon --cluster-name my-cluster --addon-name name-of-addon --preserve

축약된 예시 출력은 다음과 같습니다.

{
    "addon": {
        "addonName": "name-of-add-on",
        "clusterName": "my-cluster",
        "status": "DELETING",
    }
}

제거 상태를 확인합니다. my-cluster를 클러스터 이름으로, name-of-addon을 제거 중인 추가 기능 이름으로 바꿉니다.

aws eks describe-addon --cluster-name my-cluster --addon-name name-of-addon

추가 기능이 제거된 뒤 예시 출력은 다음과 같습니다.

An error occurred (ResourceNotFoundException) when calling the DescribeAddon operation: No addon: name-of-addon found in cluster: my-cluster

클러스터에서 Amazon EKS 추가 기능 제거