GOOGLE_CLOUD_REGION을 클러스터를 관리할Google Cloud 위치 이름으로 바꿉니다.
kubectl 명령줄 도구가 로컬 머신에 설치되어 있고 클러스터에 액세스하도록 구성되어 있는지 확인합니다. 여기에는 kubeconfig 파일에 올바른 사용자 인증 정보를 설정하는 작업이 포함됩니다.
클러스터에 네트워크 연결이 있는지 확인합니다.
클러스터를 연결하면 Google Cloud 가 Google Cloud에서 관리하는 포드 여러 개를 설치합니다. 이러한 포드는 노드에 예약되어야 합니다. 클러스터의 taint가 예약을 방해하지 않는지 확인합니다. 이러한 taint가 있으면 클러스터 등록이 실패하고 다음과 유사한 오류가 표시될 수 있습니다.
1 node(s) had untolerated taint {CriticalAddOnsOnly: true}
네트워킹 요구사항
연결된 클러스터는 지원되는 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-07-31(UTC)"],[],[],null,["# Prerequisites for your AKS attached cluster\n\nTo operate as a GKE attached cluster, your cluster needs to have\nthe following characteristics.\n\n### AKS (Azure) cluster requirements\n\n- Ensure that you use a [supported platform version](/kubernetes-engine/multi-cloud/docs/attached/aks/reference/supported-versions). The\n cluster Kubernetes major.minor version should match the selected platform\n version. You can also list all supported versions using the following command:\n\n gcloud container attached get-server-config \\\n --location=\u003cvar translate=\"no\"\u003eGOOGLE_CLOUD_REGION\u003c/var\u003e\n\n Replace \u003cvar translate=\"no\"\u003eGOOGLE_CLOUD_REGION\u003c/var\u003e with the name of the\n Google Cloud location to administer your cluster from.\n- Ensure that the `kubectl` command-line tool is installed on your local machine\n and configured to access your cluster. This includes setting up the correct\n user credentials in the `kubeconfig` file.\n\n- Ensure that there is network connectivity to your cluster.\n\n- When you attach a cluster, Google Cloud installs several Pods that are\n managed by Google Cloud. These Pods must be scheduled on your nodes. Make\n sure that any taints on your cluster don't prevent scheduling. If you have\n such taints, your cluster registration fails and you might see an error\n similar to the following:\n\n 1 node(s) had untolerated taint {CriticalAddOnsOnly: true}\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"]]
