Fleet에 클러스터 등록

Connect를 사용하여 프로젝트 Fleet에 GKE 클러스터를 등록해야 합니다. Fleet은 여러 클러스터와 워크로드를 보고 관리하는 통합된 방법을 제공합니다. Fleet과 Fleet에서 사용 설정되는 기능에 대한 자세한 내용은 Fleet 가이드를 참조하세요.

모든 클러스터를 한 번에 등록할 필요는 없지만 등록하기 전에는 Google Cloud 콘솔의 GKE Enterprise 클러스터 페이지에 클러스터가 표시되지 않습니다.

Google Cloud CLI를 사용하면 직접 Connect Agent 매니페스트를 다운로드하고 적용하는 등 Google Cloud 콘솔에서 사용할 수 없는 몇 가지 고급 클러스터 등록 옵션이 제공됩니다. 이러한 옵션에 대한 자세한 내용은 Connect 문서의 고급 등록 옵션을 참조하세요.

시작하기 전에

클러스터 등록

gcloud

  1. 기본 요건의 안내에 따라 클러스터에 GKE 워크로드 아이덴티티가 사용 설정되어 있는지 확인합니다.

  2. 다음 명령어 중 하나를 실행하여 클러스터를 등록합니다.

    gcloud container fleet memberships register MEMBERSHIP_NAME \
 --gke-uri=GKE_URI \
 --enable-workload-identity

    또는

    gcloud container fleet memberships register MEMBERSHIP_NAME \
 --gke-cluster=GKE_CLUSTER \
 --enable-workload-identity

    다음을 바꿉니다.

    • MEMBERSHIP_NAME: Fleet에 등록되는 클러스터를 고유하게 나타내기 위해 선택한 멤버십 이름입니다.
    • GKE_URI: GKE 클러스터 URI입니다(예: https://container.googleapis.com/v1/projects/my-gke-project/locations/us-central1-a/clusters/my-gke-cluster). gcloud container clusters list --uri를 실행하면 URI를 가져올 수 있습니다.
    • GKE_CLUSTER: 현재 프로젝트의 GKE 클러스터 location/name입니다. 위치는 영역이거나 리전일 수 있습니다(예: us-central1-a/my-gke-cluster).

    클러스터에 Connect Agent를 설치하려면 다음 예시와 같이 선택사항인 --install-connect-agent 플래그를 두 명령어 중 하나에 추가합니다. 기본적으로 이 플래그가 없으면 에이전트가 설치되지 않습니다.

    gcloud container fleet memberships register MEMBERSHIP_NAME \
 --gke-cluster=GKE_CLUSTER \
 --enable-workload-identity \
 --install-connect-agent

다음 단계