클러스터에서 Amazon EKS 추가 기능 제거 - Amazon EKS
사전 조건절차

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

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

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

  • 추가 기능에서 제공되는 기능의 가동 중지 시간이 없습니다.

  • 서비스 계정용 IAM 역할(IRSA)을 사용하고 추가 기능에 연결된 IAM 역할이 있는 경우 IAM 역할은 제거되지 않습니다.

  • Pod Identity를 사용하는 경우 추가 기능이 소유한 모든 Pod Identity 연결이 제거됩니다. AWS CLI에 --preserve 옵션을 지정하면 연결이 보존됩니다.

  • Amazon EKS에서는 추가 기능의 설정 관리를 중지합니다.

  • 새 버전이 사용할 수 있을 때 콘솔의 알림 표시가 중지됩니다.

  • AWS 도구 또는 API를 사용하여 추가 기능을 업데이트할 수 없습니다.

  • 자체 관리할 수 있도록 클러스터에 추가 기능 소프트웨어 남겨두기를 선택하거나 클러스터에서 추가 기능 소프트웨어를 제거할 수 있습니다. 추가 기능에서 제공되는 기능에 종속되는 리소스가 클러스터에 없는 경우에만 클러스터에서 추가 기능 소프트웨어을 제거해야 합니다.

사전 조건

추가 기능을 생성하기 전에 다음을 완료합니다.

  • 기존 Amazon EKS 클러스터. 배포하려면 Amazon EKS 시작하기 섹션을 참조하세요.

  • 추가 기능에 IAM 역할이 필요한지 확인합니다. 자세한 내용을 알아보려면 다음 섹션을 참조하세요.

  • 장치에 설치된 eksctl 명령줄 도구의 버전 0.194.0 이상 또는 AWS CloudShell이 필요합니다. eksctl을 설치 또는 업그레이드하려면 eksctl 설명서에서 Installation을 참조하세요.

절차

Amazon EKS 추가 기능을 제거하는 경우 다음 두 가지 옵션이 있습니다.

  • 클러스터에 추가 기능 소프트웨어 보존 – 이 옵션은 모든 설정에 대한 Amazon EKS 관리를 제거합니다. 또한 업데이트를 시작한 후 Amazon EKS가 업데이트를 알리고 Amazon EKS 추가 기능을 자동으로 업데이트하는 기능을 제거합니다. 그러나 클러스터에 추가 기능 소프트웨어는 유지됩니다. 이 옵션을 사용하면 추가 기능을 Amazon EKS 추가 기능이 아닌 자체 관리형 설치 기능으로 만들 수 있습니다. 이 옵션을 사용하면 추가 기능에 대한 가동 중지 시간이 없습니다.

  • 클러스터에서 추가 기능 소프트웨어 완전히 제거(Remove the add-on software entirely from your cluster) - 클러스터에 종속된 리소스가 없는 경우에만 클러스터에서 Amazon EKS 추가 기능을 제거하는 것이 좋습니다.

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

추가 기능 제거(eksctl)

  1. 클러스터에 설치된 현재 추가 기능을 확인합니다. 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
[...]

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

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

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

    추가 기능 업데이트에 대한 자세한 내용은 eksctl 설명서의 Deleting addons를 참조하세요.

추가 기능 제거(AWS 콘솔)

  1. Amazon EKS 콘솔을 엽니다.

  2. 좌측 탐색 창에서 클러스터를 선택합니다.

  3. Amazon EKS 추가 기능을 제거하려는 클러스터의 이름을 선택합니다.

  4. 추가 기능(Add-ons) 탭을 선택합니다.

  5. 제거하려는 추가 기능을 선택합니다.

  6. 제거를 선택합니다.

  7. 제거: 추가 기능 이름 확인 대화 상자에서 다음을 수행합니다.

    1. 추가 기능에 대한 Amazon EKS의 설정 관리를 중지하려면 클러스터에 보존을 선택합니다. 클러스터에 추가 소프트웨어를 유지하려면 이렇게 합니다. 이는 추가 기능의 모든 설정을 스스로 관리할 수 있도록 하기 위한 것입니다.

    2. 추가 기능 이름을 입력합니다.

    3. 제거를 선택합니다.

추가 기능 제거(AWS CLI)

  1. 장치에 설치된 eksctl 명령줄 도구의 버전 0.194.0 이상 또는 AWS CloudShell이 필요합니다. eksctl을 설치 또는 업그레이드하려면 eksctl 설명서에서 Installation을 참조하세요.

  2. 설치한 추가 기능 목록을 참조합니다. my-cluster를 해당 클러스터의 이름으로 바꿉니다.

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

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

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

  3. 설치한 추가 기능을 제거합니다. 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",
    }
}

  4. 제거의 상태를 확인합니다. 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