A new version of GKE on AWS was released on October 2. See the release notes for more information.

Connecting to your cluster with Cloud Console

With Connect, you can use the Google Cloud Console to manage your GKE on AWS clusters. Each GKE on AWS cluster that you create automatically runs the Connect agent and is registered with Connect. For more information, see Connect overview.

Before you begin

Before you start using GKE on AWS, make sure you have performed the following tasks:

Logging into your cluster with Connect

You can view, monitor, debug, and manage workloads on your GKE on AWS clusters through the Google Cloud Console.

To log into your user clusters:

  1. From your anthos-aws directory, use anthos-gke to switch context to your user cluster.

    cd anthos-aws
    env HTTP_PROXY=http://localhost:8118 \
    anthos-gke aws clusters get-credentials CLUSTER_NAME

  2. From a command line, use kubectl to set up a Kubernetes service account and a token in the kube-system namespace.

    This topic assumes the name of the service account is admin-user.

    env HTTP_PROXY=http://localhost:8118 \
    kubectl create serviceaccount -n kube-system admin-user
    
  3. Create a ClusterRoleBinding between the cluster-admin role and the Kubernetes service account.

    env HTTP_PROXY=http://localhost:8118 \
    kubectl create clusterrolebinding admin-user-binding \
      --clusterrole cluster-admin --serviceaccount kube-system:admin-user
    
  4. Get the service account's Secret with kubectl.

    SECRET_NAME=$(env HTTP_PROXY=http://localhost:8118 \
    kubectl get serviceaccount -n kube-system admin-user \
      -o jsonpath='{$.secrets[0].name}')
    
    env HTTP_PROXY=http://localhost:8118 \
    kubectl get secret -n kube-system ${SECRET_NAME} -o jsonpath='{$.data.token}' \
      | base64 -d | sed $'s/$/\\\n/g'
    
  5. Copy the secret to your clipboard.

  6. In your browser, visit the Connect Clusters page.

    Visit the Connect menu

  7. Select the cluster under Anthos managed clusters

  8. Click the Login button in the right-side pane.

  9. Select Token and paste the Kubernetes token you copied earlier. Click Login.

What's next

Read the full documentation on Logging into clusters with Connect.

Learn about multi-cluster management with Connect.