연결된 클러스터는 지원되는 Google Cloud 서비스를 사용하므로 다음 도메인에 액세스할 수 있도록 클러스터의 아웃바운드 방화벽 규칙을 수정해야 합니다. GKE 연결 클러스터를 설치하고 실행하기 위해 클러스터에 적용해야 하는 유일한 변경사항입니다.
주소
목적
.gcr.io
Artifact Registry에서 이미지를 가져옵니다.
gkeconnect.googleapis.com
Google Cloud 에서 요청을 수신하고 응답을 보는 데 사용되는 채널을 설정합니다.
gkemulticloud.googleapis.com
단기 액세스 토큰의 Google 또는 서드 파티 사용자 인증 정보를 Google Cloud 리소스로 교환합니다. Google Cloud 리전을 사용하여 클러스터를 Fleet에 등록한 경우 REGION-gkemulticloud.googleapis.com을 허용 목록에 추가해야 합니다 (예: us-central1-gkemulticloud.googleapis.com).
oauth2.googleapis.com
계정에 액세스할 수 있도록 OAuth 토큰 교환을 통해 인증합니다.
securetoken.googleapis.com
워크로드 아이덴티티를 승인할 수 있도록 갱신 토큰을 검색합니다.
storage.googleapis.com
객체 스토리지와 버킷(예: Artifact Registry 객체)을 관리합니다.
sts.googleapis.com
단기 액세스 토큰의 Google 또는 서드 파티 사용자 인증 정보를 Google Cloud 리소스로 교환합니다.
www.googleapis.com
수신되는 Google Cloud 서비스 요청에서 서비스 토큰을 인증합니다.
로깅 및 모니터링
또한 로깅 및 모니터링 기능을 사용하려면 클러스터가 다음 URL에 액세스할 수 있어야 합니다.
클러스터를 Google Cloud 관리 서비스에 연결하기 전에 Google Cloud CLI 명령어를 포함하여 gcloud CLI를 설치하고 연결된 클러스터 리소스를 관리할 수 있도록 Google Cloud 계정에 대한 액세스 권한을 Google Cloud 관리 서비스에 부여해야 합니다.
다음 명령어를 사용하여 gcloud CLI 설치를 확인합니다.
gcloudversion
gcloud CLI가 설치되지 않았거나 버전이 412.0.0 이전이면 gcloud CLI 설치 안내에 따라 버전 412.0.0 이상을 설치합니다.
[[["이해하기 쉬움","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-04(UTC)"],[],[],null,["# Prerequisites for your CNCF conformant attached cluster\n\nTo operate as a GKE attached cluster, your cluster needs to have\nthe following characteristics.\n\n### Generic cluster requirements\n\n- 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.\n- Ensure that there is network connectivity to your cluster.\n- Ensure the cluster Kubernetes version is at least 1.25. The Kubernetes major.minor version should match the selected platform version.\n- The selected platform version must be at least:\n\n 1.25.0-gke.8\n 1.26.0-gke.6\n 1.27.0-gke.3\n\n You can also list all supported versions using: \n\n gcloud container attached get-server-config \\\n --location=\u003cvar translate=\"no\"\u003eGOOGLE_CLOUD_REGION\u003c/var\u003e\n\n Release notes for each platform version can be found at the\n [supported versions](/kubernetes-engine/multi-cloud/docs/attached/generic/reference/supported-versions) page.\n\nNetworking requirements\n-----------------------\n\nBecause attached clusters rely on supporting Google Cloud services, you need to\nmodify your cluster's outbound firewall rules to allow it\naccess to the following domains. This is the only change you need to make to\nyour cluster to install and run GKE attached clusters.\n\n### Logging and monitoring\n\nTo use logging and monitoring features, your cluster also needs to\nbe able to access the following URLs: \n\n logging.googleapis.com\n monitoring.googleapis.com\n opsconfigmonitoring.googleapis.com\n kubernetesmetadata.googleapis.com\n\nGoogle Cloud requirements\n-------------------------\n\nBefore attaching your cluster to the Google Cloud management service, you must\ninstall the gcloud CLI, including the Google Cloud CLI command, and\ngrant access to your Google Cloud account to the Google Cloud management\nservice so it can manage your attached cluster resources.\n\n1. Check your gcloud CLI installation with the following command:\n\n gcloud version\n\n2. If the gcloud CLI isn't installed, or if its version is earlier than\n version 412.0.0, install version 412.0.0 or higher by following the\n [gcloud CLI installation instructions](/sdk/docs/install).\n\n3. Install the `kubectl`\n [additional component](/sdk/docs/components#additional_components).\n\n4. If you haven't already done so,\n [create your Google Cloud project](/resource-manager/docs/creating-managing-projects#creating_a_project).\n This will generate a Google Cloud project ID and a project number.\n\n5. Set your active Google Cloud project and authenticate your account with\n the following commands.\n\n export PROJECT_ID=\u003cyour project id\u003e\n gcloud auth login\n gcloud config set project $PROJECT_ID\n gcloud auth application-default login\n\n6. Enable the GKE attached clusters API and its required services with\n the following commands:\n\n gcloud services enable gkemulticloud.googleapis.com\n gcloud services enable gkeconnect.googleapis.com\n gcloud services enable connectgateway.googleapis.com\n gcloud services enable cloudresourcemanager.googleapis.com\n gcloud services enable anthos.googleapis.com\n gcloud services enable logging.googleapis.com\n gcloud services enable monitoring.googleapis.com\n gcloud services enable opsconfigmonitoring.googleapis.com\n gcloud services enable kubernetesmetadata.googleapis.com"]]
