클러스터를 Google Cloud 관리 서비스에 연결하기 전에 gcloud 명령어를 포함하여 gcloud CLI를 설치하고, 연결된 클러스터 리소스를 관리할 수 있도록 Google Cloud 관리 서비스에 Google Cloud 계정에 대한 액세스 권한을 부여해야 합니다.
다음 명령어를 사용하여 gcloud CLI 설치를 확인합니다.
gcloud version
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"]],["최종 업데이트: 2024-06-28(UTC)"],[],[],null,["# Prerequisites for your EKS attached cluster\n\nTo operate as a GKE attached cluster, your cluster needs to have\nthe following characteristics.\n\n### EKS (AWS) cluster requirements\n\n- Ensure that you use a [supported platform version](/kubernetes-engine/multi-cloud/docs/attached/eks/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- The cluster must have a public IAM OIDC Identity Provider.\n To check if a provider exists, and to create a provider if necessary, follow the\n instructions in\n [Create an IAM OIDC provider for your cluster](https://docs.aws.amazon.com/eks/latest/userguide/enable-iam-roles-for-service-accounts.html).\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"]]
