Azure 클러스터 버전 업그레이드

이 페이지에서는 Azure용 GKE 클러스터의 Kubernetes 버전을 업그레이드하는 방법을 설명합니다.

기본 요건

클러스터의 Kubernetes 버전을 업그레이드하는 것은 보다 일반적인 클러스터 업데이트 작업의 특정한 경우입니다. 클러스터 업데이트 페이지에서 일반적인 클러스터 업데이트 작업에 대해 알아볼 수 있습니다. 클러스터 버전을 업그레이드하려면 다음 안내를 따르세요.

  • 현재 버전 및 대상 버전 사이의 모든 부 버전을 업그레이드해야 합니다. 예를 들어 1.20에서 1.22로 업그레이드하려면 먼저 1.20에서 1.21로 업그레이드한 다음 1.21에서 1.22로 업그레이드해야 합니다.
  • gkemulticloud.googleapis.com/azureClusters.update Identity and Access Management 권한이 있어야 합니다.

Azure용 GKE에서 업데이트를 수행하는 방법

클러스터를 업그레이드하려면 컨트롤 플레인 노드를 다시 시작해야 하므로 Azure용 GKE는 다음 단계에 따라 "순차적 업데이트"를 수행합니다.

  1. 업데이트할 컨트롤 플레인 인스턴스 하나를 선택합니다. Azure용 GKE는 비정상 인스턴스가 있으면 정상 인스턴스보다 먼저 업데이트합니다.
  2. 인스턴스를 삭제합니다. Azure용 GKE가 인스턴스를 다시 만들고 인스턴스가 새 구성으로 부팅됩니다.
  3. 새 인스턴스에서 상태 확인을 수행합니다.
  4. 상태 확인이 성공하면 다른 인스턴스를 선택하고 동일한 단계를 수행합니다. 모든 인스턴스가 다시 시작 또는 다시 생성될 때까지 이 주기를 반복합니다. 상태 점검이 실패하면 Azure용 GKE는 클러스터를 DEGRADED 상태로 설정하고 업데이트를 중지합니다. 자세한 내용은 다음 섹션을 참조하세요.

업데이트 실패 시

업데이트 후 Azure용 GKE는 클러스터에서 상태 점검을 수행합니다. 상태 점검이 실패하면 클러스터가 DEGRADED로 표시됩니다. 다음 Google Cloud CLI 명령어를 사용하여 클러스터 상태를 표시할 수 있습니다.

gcloud container azure clusters describe CLUSTER_NAME \
  --location=GOOGLE_CLOUD_LOCATION

다음을 바꿉니다.

  • CLUSTER_NAME: 클러스터 이름
  • GOOGLE_CLOUD_LOCATION: 클러스터를 관리하는 Google Cloud 리전

업그레이드 수행

클러스터 버전 확인

클러스터 버전을 업그레이드하기 전에 다음 명령어를 사용하여 리전에서 사용할 수 있는 버전을 확인합니다.

gcloud container azure get-server-config \
    --location=GOOGLE_CLOUD_LOCATION

GOOGLE_CLOUD_LOCATION을 클러스터를 관리하는 Google Cloud위치로 바꿉니다.

업그레이드 방법 선택

Google Cloud 콘솔, Google Cloud CLI 또는 GKE Multi-Cloud API를 통해 클러스터 버전을 업그레이드할 수 있습니다. 콘솔을 사용하여 클러스터를 업그레이드하려면 먼저 클러스터에 로그인할 수 있는 인증 방법을 선택하고 구성해야 합니다. 자세한 내용은 클러스터에 연결 및 인증을 참조하세요.

콘솔

  1. Google Cloud 콘솔에서 Google Kubernetes Engine 클러스터 개요 페이지로 이동합니다.

    GKE 클러스터로 이동

  2. 클러스터가 있는 Google Cloud 프로젝트를 선택합니다.

  3. 클러스터 목록에서 클러스터 이름을 선택한 후 측면 패널에서 세부정보 보기를 선택합니다.

  4. 세부정보 탭에서 업그레이드를 선택합니다.

  5. 클러스터의 Kubernetes 버전 업그레이드 대화상자에서 업그레이드하려는 버전을 선택하고 완료를 클릭합니다. 클러스터를 업그레이드할 때는 모든 부 버전 단계를 따라 업그레이드해야 합니다.

gcloud

클러스터의 Kubernetes 버전을 업그레이드하려면 다음 명령어를 실행합니다.

gcloud container azure clusters update CLUSTER_NAME \
    --location=GOOGLE_CLOUD_LOCATION \
    --cluster-version=CLUSTER_VERSION

다음을 바꿉니다.

API

API를 통해 클러스터를 업데이트하려면 GKE Multi-Cloud API에서 PATCH 작업을 사용합니다.

  1. 다음 콘텐츠로 cluster_update.json이라는 JSON 파일을 만듭니다.

    {
    "controlPlane": {
       "version": "CLUSTER_VERSION",
    },
}

    다음을 바꿉니다.

    • CLUSTER_VERSION: 새로운 지원되는 클러스터 버전. 클러스터를 업그레이드할 때는 모든 부 버전 단계를 따라 업그레이드해야 합니다.

  2. 다음 명령어로 GKE Multi-Cloud API를 통해 이 설정을 업데이트합니다.

    curl -d @cluster_update.json -X PATCH \
   ENDPOINT/projects/PROJECT_ID/locations/GOOGLE_CLOUD_LOCATION/azureClusters/CLUSTER_ID?update_mask=controlPlane.Version

다음을 바꿉니다.

자세한 내용은 projects.locations.azureClusters.patch 메서드 문서를 참조하세요.

노드 풀 업그레이드

클러스터 버전을 업그레이드한 후 노드 풀을 업그레이드하여 프로세스를 완료합니다. 자세한 내용은 노드 풀 업데이트를 참조하세요.

다음 단계