**이 페이지 개선에 도움 주기**
이 사용자 가이드에 기여하려면 모든 페이지의 오른쪽 창에 있는 **GitHub에서 이 페이지 편집** 링크를 선택합니다.
# 클러스터에서 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 시작하기](getting-started.md) 섹션을 참조하세요.
+ 추가 기능에 IAM 역할이 필요한지 확인합니다. 자세한 내용은 다음 섹션을 참조하세요.
+ 장치에 설치된 `eksctl` 명령줄 도구의 버전 `0.215.0` 이상 또는 AWS CloudShell이 필요합니다. `eksctl`을 설치 또는 업그레이드하려면 `eksctl` 설명서에서 [설치](https://eksctl.io/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
[...]
```
클러스터에 있는 추가 기능과 버전에 따라 출력이 다르게 보일 수 있습니다.
1. 추가 기능을 제거합니다. *my-cluster*를 클러스터의 이름으로 바꾸고 제거하려는 이전 단계의 출력에서 반환된 추가 기능의 이름으로 *name-of-add-on*을 바꿉니다. *–-보존* 옵션을 제거하면 Amazon EKS에서 더는 추가 기능을 관리하지 않을 뿐만 아니라 클러스터에서 추가 기능 소프트웨어가 삭제됩니다.
```
eksctl delete addon --cluster my-cluster --name name-of-addon --preserve
```
추가 기능 업데이트에 대한 자세한 내용은 `eksctl` 설명서의 [추가 기능 삭제](https://eksctl.io/usage/addons/#deleting-addons)를 참조하세요.
### 추가 기능 제거(AWS 콘솔)
1. [Amazon EKS 콘솔](https://console.aws.amazon.com/eks/home#/clusters)을 엽니다.
1. 좌측 탐색 창에서 **클러스터**를 선택합니다.
1. Amazon EKS 추가 기능을 제거하려는 클러스터의 이름을 선택합니다.
1. **추가 기능** 탭을 선택합니다.
1. 제거하려는 추가 기능을 선택합니다.
1. **제거**를 선택합니다.
1. **제거: *추가 기능 이름* ** 확인 대화 상자에서 다음을 수행합니다.
1. 추가 기능에 대한 Amazon EKS의 설정 관리를 중지하려면 **클러스터에 보존**을 선택합니다. 클러스터에 추가 소프트웨어를 유지하려면 이렇게 합니다. 이는 추가 기능의 모든 설정을 스스로 관리할 수 있도록 하기 위한 것입니다.
1. 추가 기능 이름을 입력합니다.
1. **제거**를 선택합니다.
### 추가 기능 제거(AWS CLI)
1. 장치에 설치된 `eksctl` 명령줄 도구의 버전 `0.215.0` 이상 또는 AWS CloudShell이 필요합니다. `eksctl`을 설치 또는 업그레이드하려면 `eksctl` 설명서에서 [설치](https://eksctl.io/installation)를 참조하세요.
1. 설치한 추가 기능 목록을 참조합니다. *my-cluster*를 해당 클러스터의 이름으로 바꿉니다.
```
aws eks list-addons --cluster-name my-cluster
```
예제 출력은 다음과 같습니다.
```
{
"addons": [
"coredns",
"kube-proxy",
"vpc-cni",
"name-of-addon"
]
}
```
1. 설치한 추가 기능을 제거합니다. *my-cluster*를 클러스터 이름으로 바꾸고 제거할 추가 기능의 이름으로 *name-of-add-on*을 바꿉니다. *–-보존*을 제거하면 클러스터에서 추가 기능 소프트웨어가 삭제됩니다.
```
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",
}
}
```
1. 제거의 상태를 확인합니다. *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
```