클러스터를 업데이트하면 GKE 연결 클러스터와 연관된 속성이나 버전이 업데이트됩니다. 이렇게 해도 클러스터가 실행 중인 Kubernetes 버전이 변경되거나 GKE 연결 클러스터와 관련없는 클러스터 속성이 업데이트되지 않습니다. Google Cloud CLI 또는 Google Cloud 콘솔을 사용하여 클러스터를 업데이트할 수 있습니다.
gcloud CLI
연결 클러스터를 업데이트하려면 gcloud container attached clusters update 명령어를 사용합니다.
gcloud container attached clusters update CLUSTER_NAME \ --location GOOGLE_CLOUD_REGION
다음을 바꿉니다.
CLUSTER_NAME: 클러스터의 이름입니다.GOOGLE_CLOUD_REGION: 클러스터를 관리할 Google Cloud 리전의 이름
클러스터를 업데이트할 때 사용할 수 있는 모든 인수에 대한 자세한 내용은 gcloud container attached clusters update 명령어를 참조하세요.
Console
Google Cloud 콘솔에서 Google Kubernetes Engine 클러스터 개요 페이지로 이동합니다.
클러스터가 있는 Google Cloud 프로젝트를 선택합니다.
업데이트할 클러스터의 이름을 클릭한 후 측면 패널에서 세부정보 더보기를 선택합니다.
세부정보 탭에서 클러스터에 대한 기본 정보를 업데이트하거나 GKE 연결 클러스터 버전을 업그레이드할 수 있습니다.
클러스터 기본사항을 업데이트하려면 다음 안내를 따르세요.
변경하려는 필드 옆에 있는 수정을 선택합니다.
변경이 완료되면 완료를 선택합니다.
GKE 연결 클러스터 버전을 업그레이드하려면 다음 안내를 따르세요.
플랫폼 버전 옆에 있는 사용 가능한 업그레이드를 선택합니다.
목록에서 버전을 선택하고 완료를 클릭합니다.
플랫폼 버전을 업그레이드해도 클러스터의 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 연결 클러스터를 업그레이드하기 전에 클러스터를 다음 부 버전으로 업그레이드할 수 있습니다.