클러스터 등록 취소

이 페이지에서는 Google Cloud Fleet에서 클러스터를 수동으로 등록 취소하는 방법을 설명합니다. 클러스터를 수동으로 등록 취소하면 Fleet에 대한 연결은 삭제되지만 클러스터는 그대로 유지됩니다. Google Cloud 콘솔이나 gcloud CLI를 사용하여 Google Cloud에서 등록된 GKE 클러스터를 삭제하면 클러스터의 Fleet 멤버십도 삭제됩니다.

Google Cloud 기반 GKE 클러스터 및 연결된 타사 클러스터만 등록 취소할 수 있습니다. 다른 클러스터 유형을 등록 취소할 수 없습니다.

Fleet 간에 등록된 클러스터를 이동(등록 취소 후 재등록)하면 예기치 않거나 원치 않는 동작이 발생할 수 있으므로 현재 이러한 이동은 권장되지 않습니다. 예를 들어 워크로드의 Fleet 워크로드 아이덴티티가 변경되어 요청이 차단되고 중단될 수 있습니다. 권장되는 방법은 워크로드를 포함하려는 Fleet에 새 클러스터를 만든 다음 이전 클러스터에서 새 클러스터로 워크로드를 이동하는 것입니다.

클러스터 등록 취소

gcloud

GKE 클러스터 등록 취소

이 명령어는 gcloud container clusters update 또는 gcloud container clusters create를 사용해서 등록된 GKE 클러스터를 등록 취소하는 데만 사용할 수 있습니다.

다음 명령어를 실행합니다.

gcloud container clusters update CLUSTER_NAME --clear-fleet-project

CLUSTER_NAME을 삭제할 클러스터 이름으로 바꿉니다.

GKE 클러스터 등록 취소(레거시 명령어)

이전의 register 명령어를 사용하여 클러스터를 등록한 경우 다음 명령어 중 하나를 실행하여 등록 취소합니다.

gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --gke-uri=[GKE_URI]
gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --gke-cluster=[GKE_CLUSTER]

각 항목의 의미는 다음과 같습니다.

  • [PROJECT_ID]는 Google Cloud 프로젝트 ID입니다. 이 값을 찾는 방법 알아보기
  • [MEMBERSHIP_NAME]는 클러스터에 해당하는 멤버십 이름입니다. 허브에서 모든 멤버십을 나열하려면 gcloud container fleet memberships list을 실행합니다.
  • [GKE_URI]는 GKE 클러스터의 URI입니다(예: 'https://container.googleapis.com/projects/my-project/locations/us-central1-a/clusters/my-cluster'). gcloud container clusters list --uri를 실행하면 URI를 가져올 수 있습니다. 제공된 URI는 유효성 검사를 통해 올바른 GKE 클러스터에 매핑되는지 확인합니다.
  • [GKE_CLUSTER]는 GKE 클러스터의 location/name입니다. 위치는 영역이거나 리전일 수 있습니다(예: us-central1-a/my-cluster).

연결된 클러스터 등록 취소

이 안내는 연결된 클러스터 기능의 최신 버전을 통해 등록된 클러스터에 적용됩니다. 이 기능의 지원 중단된 이전 세대를 통해 연결된 클러스터는 다음 섹션에서 기존 명령어를 사용해야 합니다.

연결된 클러스터 등록 취소(기존 명령어)

연결된 클러스터의 이전 세대를 사용하여 클러스터를 등록한 경우에는 다음 명령어를 실행하여 등록 취소합니다.

gcloud container fleet memberships unregister [MEMBERSHIP_NAME] \
   --project=[PROJECT_ID] \
   --context=[KUBECONFIG_CONTEXT] \
   --kubeconfig=[KUBECONFIG_PATH]

각 매개변수는 다음과 같습니다.

  • [PROJECT_ID]는 Google Cloud 프로젝트 ID입니다. 이 값을 찾는 방법 알아보기
  • [MEMBERSHIP_NAME]는 클러스터에 해당하는 멤버십 이름입니다. 허브에서 모든 멤버십 목록을 가져오려면 gcloud container fleet memberships list를 실행합니다.
  • [KUBECONFIG_PATH]는 클러스터 파일 항목이 포함된 kubeconfig가 저장된 로컬 경로입니다. 환경 변수가 설정된 경우 기본값은 $KUBECONFIG입니다. 그렇지 않으면 이 기본값은 $HOME/.kube/config입니다.
  • [KUBECONFIG_CONTEXT]는 kubeconfig 파일에 나타나는 클러스터의 컨텍스트입니다. kubectl config current-context를 실행하면 명령줄에서 이 값을 가져올 수 있습니다.

Console

Google Cloud에서 GKE 클러스터 등록 취소

기존 Anthos 페이지만 사용하여 Google Cloud 콘솔에서 Google Cloud의 GKE 클러스터를 등록 취소할 수 있습니다. GKE 클러스터 페이지에서는 등록을 취소할 수 없습니다.

GKE 클러스터를 등록 취소하려면 다음 안내를 따르세요.

  1. Anthos 클러스터 페이지로 이동합니다. 이 페이지에는 등록된 모든 클러스터가 표시됩니다.

    Anthos 클러스터 페이지로 이동

  2. 목록에서 등록 취소하려는 클러스터를 선택합니다. 세부정보 패널이 표시됩니다.

  3. 세부정보 패널에서 등록 취소를 클릭합니다.

  4. 대화상자가 표시되면 다시 등록 취소를 클릭하여 작업을 확인합니다.

연결된 서드 파티 클러스터 등록 취소

연결된 클러스터를 등록 취소하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔에서 Google Kubernetes Engine 클러스터 개요 페이지로 이동합니다.

    GKE 클러스터로 이동

  2. 클러스터가 있는 Google Cloud 프로젝트를 선택합니다.

  3. 분리할 클러스터의 이름을 클릭한 후 측면 패널에서 세부정보 보기를 선택합니다.

  4. 창 상단에서 삭제를 클릭합니다.

  5. 확인 메시지가 표시되면 클러스터 이름을 입력하고 확인을 클릭합니다.

Terraform

Terraform을 사용하여 등록한 GKE 클러스터를 등록 취소하려면 다음 안내를 따르세요.

클러스터의 google_container_cluster 리소스 구성에서 다음 블록을 삭제합니다.

fleet {
      project = "FLEET_HOST_PROJECT""
    }

FLEET_HOST_PROJECT는 클러스터가 등록된 Google Cloud 프로젝트 ID입니다.

Connect Agent 관리

다음 단계는 연결된 클러스터 등록 취소에만 적용됩니다. 여기서 Connect Agent는 등록 중에 클러스터에 설치되었습니다.

선택사항: Connect Agent 네임스페이스가 삭제되었는지 확인

클러스터를 등록 취소한 후 Connect Agent에서 사용하는 네임스페이스가 삭제되었는지 확인할 수 있습니다. 이것은 Connect Agent를 설치하는 등록에만 적용됩니다. 이 작업을 수행하려면 다음을 실행합니다.

kubectl get ns -l hub.gke.io/project

이 명령어를 실행해도 결과가 반환되지 않으면 네임스페이스가 이미 삭제된 것입니다.

Connect Agent 서비스 계정 삭제

Connect Agent의 서비스 계정을 만든 경우 다음과 같이 이를 삭제할 수 있습니다.

gcloud iam service-accounts delete [SERVICE_ACCOUNT_NAME]

사용할 수 없는 클러스터 등록 취소

더 이상 액세스할 수 없는 클러스터를 등록 취소하려면 다음 안내를 따르세요.

  1. 현재 등록된 클러스터(멤버십이라고도 함)를 나열합니다.

    gcloud container fleet memberships list

    명령어 결과에서 Name 열은 등록된 클러스터의 멤버십 이름을 나열하고 EXTERNAL_ID 열에는 kube-system 네임스페이스의 클러스터 UID가 나열됩니다.

  2. 사용할 수 없는 클러스터를 등록 취소하려면 다음 명령어를 실행하세요.

    gcloud container fleet memberships delete [MEMBERSHIP_NAME]

    여기서 [MEMBERSHIP_NAME]은 클러스터에 해당하는 멤버십 이름입니다.