Prerequisites for your CNCF conformant attached cluster

To operate as a GKE attached cluster, your cluster needs to have the following characteristics.

Generic cluster requirements

  • Ensure that the kubectl command-line tool is installed on your local machine and configured to access your cluster. This includes setting up the correct user credentials in the kubeconfig file.
  • Ensure that there is network connectivity to your cluster.
  • Ensure the cluster Kubernetes version is at least 1.25. The Kubernetes major.minor version should match the selected platform version.
  • The selected platform version must be at least:

    1.25.0-gke.8
    1.26.0-gke.6
    1.27.0-gke.3
    

    You can also list all supported versions using:

    gcloud container attached get-server-config  \
    --location=GOOGLE_CLOUD_REGION
    

    Release notes for each platform version can be found at the supported versions page.

Networking requirements

Because attached clusters rely on supporting Google Cloud services, you need to modify your cluster's outbound firewall rules to allow it access to the following domains. This is the only change you need to make to your cluster to install and run GKE attached clusters.

.gcr.io
gkeconnect.googleapis.com
oauth2.googleapis.com
securetoken.googleapis.com
storage.googleapis.com
sts.googleapis.com

Logging and monitoring

To use logging and monitoring features, your cluster also needs to be able to access the following URLs:

logging.googleapis.com
monitoring.googleapis.com
opsconfigmonitoring.googleapis.com
kubernetesmetadata.googleapis.com

Google Cloud requirements

Before attaching your cluster to the Google Cloud management service, you must install the gcloud CLI including the gcloud command, and grant the Google Cloud management service access to your Google Cloud account so it can manage your attached cluster resources.

  1. Check your gcloud CLI installation with the following command:

    gcloud version
    
  2. If the gcloud CLI isn't installed, or if its version is earlier than version 412.0.0, install version 412.0.0 or higher by following the gcloud CLI installation instructions.

  3. Install the kubectl additional component.

  4. If you haven't already done so, create your Google Cloud project. This will generate a Google Cloud project ID and a project number.

  5. Set your active Google Cloud project and authenticate your account with the following commands.

    export PROJECT_ID=<your project id>
    gcloud auth login
    gcloud config set project $PROJECT_ID
    gcloud auth application-default login
    
  6. Enable the GKE attached clusters API and its required services with the following commands:

    gcloud services enable gkemulticloud.googleapis.com
    gcloud services enable gkeconnect.googleapis.com
    gcloud services enable connectgateway.googleapis.com
    gcloud services enable cloudresourcemanager.googleapis.com
    gcloud services enable anthos.googleapis.com
    gcloud services enable logging.googleapis.com
    gcloud services enable monitoring.googleapis.com
    gcloud services enable opsconfigmonitoring.googleapis.com
    gcloud services enable kubernetesmetadata.googleapis.com