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

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

# Amazon EKS 콘솔에서 Kubernetes 클러스터 등록 취소
<a name="deregister-connected-cluster"></a>

연결된 클러스터 사용을 마치면 등록 취소할 수 있습니다. 등록이 취소된 후에는 클러스터가 Amazon EKS 콘솔에 더이상 표시되지 않습니다.

deregisterCluster API를 호출하려면 다음 권한이 있어야 합니다.
+  `eks:DeregisterCluster` 
+  `ssm:DeleteActivation` 
+  `ssm:DeregisterManagedInstance` 

이 프로세스는 두 단계로 이루어집니다. Amazon EKS에서 클러스터 등록을 취소하고 클러스터에서 eks-connector 에이전트를 제거하는 것입니다.

## Kubernetes 클러스터 등록 취소
<a name="deregister-connected-cluster-eks"></a>

Amazon EKS 커넥터에서 클러스터를 등록 취소하려면 다음 도구 중 하나를 사용할 수 있습니다.
+  [AWS CLI](#awscli_deregister_cluster_connect) 
+  [AWS Management Console](#console_deregister_cluster_connect) 
+  [`eksctl`](#eksctl_deregister_cluster_connect) 

### AWS CLI
<a name="awscli_deregister_cluster_connect"></a>

1.  AWS CLI가 설치되어 있어야 합니다. 설치하거나 업그레이드하려면 [AWS CLI 설치](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)를 참조하세요.

1. Amazon EKS Connector 에이전트 역할이 생성되었는지 확인합니다.

1. 연결된 클러스터의 등록을 취소합니다.

   ```
   aws eks deregister-cluster \
       --name my-cluster \
       --region region-code
   ```

### AWS Management Console
<a name="console_deregister_cluster_connect"></a>

1. [Amazon EKS 콘솔](https://console.aws.amazon.com/eks/home#/clusters)을 엽니다.

1. **클러스터**를 선택하세요.

1. **클러스터** 페이지에서 연결된 클러스터를 선택한 다음 **등록 취소**를 선택합니다.

1. 클러스터 등록을 취소할지 확인합니다.

### `eksctl`
<a name="eksctl_deregister_cluster_connect"></a>

1. `eksctl` 버전 `0.68` 이상을 설치합니다. 설치하거나 업그레이드하려면 [Amazon EKS 시작하기 – `eksctl`](getting-started-eksctl.md) 섹션을 참조하세요.

1. Amazon EKS Connector 에이전트 역할이 생성되었는지 확인합니다.

1. 연결된 클러스터의 등록을 취소합니다.

   ```
   eksctl deregister cluster --name my-cluster
   ```

## Kubernetes 클러스터의 리소스 정리
<a name="deregister-connected-cluster-k8s"></a>

`eks-connector` 에이전트를 삭제하려면 다음 도구 중 하나를 사용합니다.
+  [Helm](#helm_agent_cluster_deregister) 
+  [yaml](#yaml_agent_cluster_deregister) 

### Helm
<a name="helm_agent_cluster_deregister"></a>

다음 명령을 실행하여 에이전트를 제거합니다.

```
helm -n eks-connector uninstall eks-connector
```

### yaml
<a name="yaml_agent_cluster_deregister"></a>

1. Kubernetes 클러스터에서 Amazon EKS Connector YAML 파일을 삭제합니다.

   ```
   kubectl delete -f eks-connector.yaml
   ```

1. 추가 [IAM 위탁자](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal)가 클러스터에 액세스할 수 있도록 `clusterrole` 또는 `clusterrolebindings`를 생성한 경우 Kubernetes 클러스터에서 이를 삭제합니다.