Log in to Google Cloud using your account credentials:
gcloud auth login
Set a default project. Setting a default Google Cloud causes all
gcloud CLI commands to run against the project, so that you don't
need to specify your project for each command:
gcloud config set project [PROJECT_ID]
Replace [PROJECT_ID] with your
project ID. (You can
find your project ID in Google Cloud console, or by running
gcloud config get-value project.)
Viewing your clusters
kubectl
kubectl get clusters --kubeconfig [ADMIN_CLUSTER_KUBECONFIG]
Console
If you chose to register your clusters with Google Cloud by populating
the gkeconnect field of the Google Distributed Cloud configuration file,
you can view your clusters in Google Cloud console. To learn more, see
Viewing registered clusters
in the Connect documentation.
Connecting to your clusters
If you want to connect to your clusters, you have two options:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThis page provides instructions on managing Google Distributed Cloud clusters.\u003c/p\u003e\n"],["\u003cp\u003eYou can view your clusters using either \u003ccode\u003ekubectl\u003c/code\u003e commands or the Google Cloud console if registered.\u003c/p\u003e\n"],["\u003cp\u003eConnecting to clusters can be done via SSH to cluster nodes or through the Google Cloud console.\u003c/p\u003e\n"],["\u003cp\u003eYou can check the version of both user and admin clusters by using \u003ccode\u003ekubectl\u003c/code\u003e commands.\u003c/p\u003e\n"]]],[],null,["# Managing clusters\n\n\u003cbr /\u003e\n\nThis page describes how to manage your Google Distributed Cloud clusters.\n\nBefore you begin\n----------------\n\n1. SSH into your admin workstation:\n\n ```\n ssh -i ~/.ssh/vsphere_workstation ubuntu@[IP_ADDRESS]\n ```\n2. Log in to Google Cloud using your account credentials:\n\n ```\n gcloud auth login\n ```\n3. Set a default project. Setting a default Google Cloud causes all\n gcloud CLI commands to run against the project, so that you don't\n need to specify your project for each command:\n\n ```\n gcloud config set project [PROJECT_ID]\n ```\n\n Replace \u003cvar translate=\"no\"\u003e[PROJECT_ID]\u003c/var\u003e with your\n [project ID](/resource-manager/docs/creating-managing-projects). (You can\n find your project ID in Google Cloud console, or by running\n `gcloud config get-value project`.)\n\nViewing your clusters\n---------------------\n\n### kubectl\n\n```\nkubectl get clusters --kubeconfig [ADMIN_CLUSTER_KUBECONFIG]\n```\n\n### Console\n\nIf you chose to register your clusters with Google Cloud by populating\nthe `gkeconnect` field of the Google Distributed Cloud configuration file,\nyou can view your clusters in Google Cloud console. To learn more, see\n[Viewing registered clusters](/anthos/multicluster-management/connect/viewing-registered-clusters)\nin the Connect documentation.\n\nConnecting to your clusters\n---------------------------\n\nIf you want to connect to your clusters, you have two options:\n\n- You can [SSH into cluster nodes](/anthos/clusters/docs/on-prem/1.9/how-to/ssh-cluster-node).\n- Your user clusters are automatically [registered to your Google Cloud project](/anthos/clusters/docs/on-prem/1.9/how-to/connecting-to-a-cluster) when you create them. This means you can view and [log in to clusters from the Google Cloud console](/anthos/multicluster-management/console/logging-in).\n\nChecking cluster version\n------------------------\n\n### User cluster\n\n```\nkubectl get cluster --kubeconfig [USER_CLUSTER_KUBECONFIG] -o yaml | grep bundle.gke.io/version\n```\n\nThe cluster's version is the same as the bundle version returned by this\ncommand.\n\n### Admin cluster\n\n```\nkubectl get pod -l api=clusterapi --kubeconfig [ADMIN_CLUSTER_KUBECONFIG] -o yaml -n kube-system | grep image:.*controller-manager\n```\n\nThe cluster's version is the same as the image version returned by this\ncommand."]]
