이 페이지에서는 모든 Fleet 구성원 나열, 클러스터의 멤버십 이름 같은 세부정보 가져오기, 또는 Fleet 워크로드 아이덴티티가 사용 설정되었는지 등 클러스터의 Fleet 멤버십 상태를 가져오는 방법을 설명합니다. 이 정보를 사용하여 클러스터를 성공적으로 등록했는지 확인하거나 다른 Fleet 수준 작업을 수행할 수 있습니다.
gcloud CLI 또는Google Cloud 콘솔을 사용하여 성공적으로 등록된 클러스터를 볼 수 있습니다. 일부 추가 상태 세부정보는 gcloud CLI를 통해서만 제공됩니다.
콘솔
필요한 역할
Google Cloud 콘솔에서 Fleet 클러스터를 볼 수 있도록 최소 권한이 있는지 확인합니다.
클러스터의 Fleet 등록 상태는 다음 페이지에 표시됩니다.
GKE 클러스터 페이지에 클러스터 목록에 있는 Fleet 열의 Fleet 이름이 표시됩니다.
gcloud container fleet memberships list \
--project=PROJECT_ID
명령어 출력의 Name 열에 등록된 클러스터의 멤버십 이름이 나열됩니다. 클러스터가 등록될 때 선택된 멤버십 이름에 따라 멤버십 이름이 클러스터 이름과 동일할 수 있습니다. EXTERNAL_ID 열에는 kube-system 네임스페이스의 클러스터 UID가 나열됩니다. 다음 명령어를 사용하여 클러스터의 UID를 찾을 수 있습니다.
kubectl get namespace kube-system -o jsonpath='{.metadata.uid}'
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-01(UTC)"],[],[],null,["This page shows you how to get the fleet membership status of your clusters, including listing all your fleet members, and getting membership details such as the cluster's [membership name](/kubernetes-engine/fleet-management/docs/fleet-creation#about_fleet_membership) or if it has [fleet Workload Identity](/kubernetes-engine/fleet-management/docs/use-workload-identity) enabled. You can use this information to validate that you have successfully registered a cluster, or to perform other fleet-level tasks.\n\nYou can view clusters that have been successfully registered by using the gcloud CLI or the\nGoogle Cloud console. Some additional status details are available only by using the gcloud CLI. \n\nConsole\n\nRequired roles\n\nEnsure you have the [minimum permissions](/kubernetes-engine/fleet-management/docs/console) to view fleet clusters in the Google Cloud console.\n\nA cluster's fleet registration status is shown in the following pages:\n\n- The GKE clusters page displays the fleet name in the cluster list's **Fleet** column.\n\n [Go to Kubernetes clusters](https://console.cloud.google.com/kubernetes/list)\n- The GKE cluster details page shows the cluster's [unique membership name](/kubernetes-engine/fleet-management/docs/fleet-creation#about_fleet_membership) in the **GKE Hub Membership** field.\n\n- If you have running workloads on the cluster, the fleet name is also displayed on the GKE workloads page, in the workload list's **Fleet** column.\n\n [Go to Workloads](https://console.cloud.google.com/kubernetes/workload/overview)\n\ngcloud\n\nThe following commands provide information about fleet members:\n\n- List all registered clusters in a project:\n\n gcloud container fleet memberships list \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\n In the command output, the `Name` column lists the [membership names](/kubernetes-engine/fleet-management/docs/fleet-creation#about_fleet_membership) of\n registered clusters. The membership name might be the same as the\n cluster name depending on the membership name that was chosen when\n the cluster was registered. The `EXTERNAL_ID` column lists the\n clusters' UIDs in the `kube-system` namespace. You can find a cluster's\n UID with the following command:\n `kubectl get namespace kube-system -o jsonpath='{.metadata.uid}'`\n\n \u003cbr /\u003e\n\n | **Note:** Depending on the version, admin clusters in Google Distributed Cloud deployments on VMware might not be in the command output. If you don't know the membership name of the admin cluster, run the following command on your admin workstation to get the membership name: `kubectl describe membership membership --kubeconfig `\u003cvar translate=\"no\"\u003eADMIN_CLUSTER_KUBECONFIG\u003c/var\u003e\n- View fleet membership details about a cluster:\n\n gcloud container fleet memberships describe \u003cvar translate=\"no\"\u003eMEMBERSHIP_NAME\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e\n\n This command returns complete details of your cluster's fleet membership, including when it was registered and if it has [fleet Workload Identity](/kubernetes-engine/fleet-management/docs/use-workload-identity) enabled.\n\nWhat's next\n\nLearn more about working with, and connecting to fleet clusters in the following guides:\n\n- [Manage identity for authenticating to clusters](/kubernetes-engine/fleet-management/docs/secure#manage_identity)\n- [Work with fleet clusters from the Google Cloud console](/kubernetes-engine/fleet-management/docs/console)\n- [Work with fleet clusters from the command line](/kubernetes-engine/fleet-management/docs/command-line)"]]
