클러스터를 업데이트하면 GKE 연결 클러스터와 연관된 속성이나 버전이 업데이트됩니다. 이렇게 해도 클러스터가 실행 중인 Kubernetes 버전이 변경되거나 GKE 연결 클러스터와 관련없는 클러스터 속성이 업데이트되지 않습니다. Google Cloud CLI 또는 Google Cloud 콘솔을 사용하여 클러스터를 업데이트할 수 있습니다.
세부정보 탭에서 클러스터에 대한 기본 정보를 업데이트하거나 GKE 연결 클러스터 버전을 업그레이드할 수 있습니다.
클러스터 기본사항을 업데이트하려면 다음 안내를 따르세요.
변경하려는 필드 옆에 있는 edit 수정을 선택합니다.
변경이 완료되면 완료를 선택합니다.
GKE 연결 클러스터 버전을 업그레이드하려면 다음 안내를 따르세요.
플랫폼 버전 옆에 있는 edit사용 가능한 업그레이드를 선택합니다.
목록에서 버전을 선택하고 완료를 클릭합니다.
플랫폼 버전을 업그레이드해도 클러스터의 Kubernetes 버전은 변경되지 않습니다.
--platform-version 인수를 사용한 클러스터 업그레이드
클러스터에 설치된 GKE 연결 클러스터 소프트웨어 버전을 업그레이드하려면 gcloud container attached clusters update 명령어와 함께 선택사항인 --platform-version 인수를 사용합니다. 예를 들어 이를 통해 버전 1.28.0-gke.1에서 1.28.0-gke.3으로 또는 버전 1.28.x에서 1.29.y로 업그레이드할 수 있습니다.
하지만 gcloud container attached clusters update 명령어는 이전 세대의 GKE 연결 클러스터를 사용하여 연결한 클러스터를 현재 세대로 업그레이드하는 데 사용될 수 없습니다. 이전 세대는 더 이상 새로운 기능이나 수정사항 또는 지원을 받지 못하는 오래된 관리되지 않는 소프트웨어입니다.
클러스터를 이전 세대에서 현재 세대로 마이그레이션하려면 클러스터 마이그레이션의 단계를 수행합니다.
플랫폼 버전 번호 지정
이 문서에서는 Kubernetes 버전과 구분하기 위해 GKE 연결 클러스터 버전을 플랫폼 버전이라고 부릅니다. GKE 연결 클러스터는 1.21.5-gke.1과 같이 GKE와 동일한 버전 번호 지정 규칙을 따릅니다. 클러스터를 연결하거나 업데이트할 때는 부 버전이 클러스터의 Kubernetes 버전보다 한 단계 낮거나 동일한 플랫폼 버전을 선택해야 합니다. 예를 들어 Kubernetes v1.22.*를 실행하는 클러스터를 GKE 연결 클러스터 플랫폼 버전 1.21.* 또는 1.22.*와 연결할 수 있습니다.
이렇게 하면 GKE 연결 클러스터를 업그레이드하기 전에 클러스터를 다음 부 버전으로 업그레이드할 수 있습니다.
[[["이해하기 쉬움","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,["# Update your AKS attached cluster\n\nUpdating a cluster means updating the attributes or version associated with\nGKE attached clusters. This doesn't change the Kubernetes version that the cluster\nis running or update cluster attributes not related to GKE attached clusters. You can\nupdate the cluster with the Google Cloud CLI or the Google Cloud console. \n\n### gcloud CLI\n\nTo update an attached cluster, use the\n[`gcloud container attached clusters update` command](/sdk/gcloud/reference/container/attached/clusters/update):\n\n```sh\ngcloud container attached clusters update CLUSTER_NAME \\\n --location GOOGLE_CLOUD_REGION\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eCLUSTER_NAME\u003c/var\u003e: the name of the cluster\n- \u003cvar translate=\"no\"\u003eGOOGLE_CLOUD_REGION\u003c/var\u003e: the name of the Google Cloud region to administer your cluster from\n\nFor information about all the arguments you can use when updating a cluster,\nsee the\n[`gcloud container attached clusters update` command](/sdk/gcloud/reference/container/attached/clusters/update).\n\n### Console\n\n1. In the Google Cloud console, go to the **Google Kubernetes Engine clusters\n overview** page.\n\n [Go to GKE clusters](https://console.cloud.google.com/kubernetes/list/overview)\n2. Select the Google Cloud project that the cluster is in.\n\n3. Click the name of the cluster you want to update, and then select **View\n more details** in the side panel.\n\n4. On the **Details** tab, you can update basic information about the\n cluster or upgrade the GKE attached clusters version.\n\n - To update cluster basics:\n\n 1. Select edit **Edit** next to\n a field that you want to change.\n\n 2. When you are finished making changes, select **Done**.\n\n - To upgrade the GKE attached clusters version:\n\n 1. Select edit\n **Upgrade available** next to **Platform version**.\n\n 2. Select the version from the list, and click **Done**.\n\n Upgrading the platform version doesn't change the Kubernetes version\n on the cluster.\n\nUse the `--platform-version` argument to upgrade your cluster\n-------------------------------------------------------------\n\nUse the optional `--platform-version` argument with the\n`gcloud container attached clusters update` command to upgrade the\nversion of the GKE attached clusters software installed on your\ncluster. For example, this lets you upgrade from version 1.28.0-gke.1 to\n1.28.0-gke.3, or from version 1.28.x to 1.29.y.\n\nHowever, the `gcloud container attached clusters update` command can't be used\nto upgrade a cluster attached using the previous generation of\n[GKE attached clusters](/kubernetes-engine/multi-cloud/docs/attached/previous-generation/how-to/attach-kubernetes-clusters) to the current generation. This previous generation\nis older and unmanaged software that no longer receives new features, fixes, or\nsupport.\n\nTo migrate a cluster from the previous generation to the current generation,\nfollow the steps in\n[Migrate your cluster](/kubernetes-engine/multi-cloud/docs/attached/aks/how-to/migrate-cluster).\n\nPlatform version numbering\n--------------------------\n\nThese documents refer to the GKE attached clusters version as the platform version,\nto distinguish it from the Kubernetes version. GKE attached clusters uses the same\nversion numbering convention as GKE - for example, 1.21.5-gke.1. When attaching\nor updating your cluster, you must choose a platform version whose minor version\nis the same as or one level below the Kubernetes version of your cluster. For\nexample, you can attach a cluster running Kubernetes v1.22.\\* with\nGKE attached clusters platform version 1.21.\\* or 1.22.\\*.\n\nThis lets you upgrade your cluster to the next minor version before upgrading\nGKE attached clusters."]]
