고급이 아닌 클러스터를 업그레이드하고 고급이 아닌 상태로 유지

기본적으로 버전 1.33으로 업그레이드하면 고급이 아닌 클러스터가 고급 클러스터로 자동 업그레이드됩니다. 고급이 아닌 클러스터를 고급 클러스터로 업그레이드하는 것이 좋지만 1.32에서 1.33으로 업그레이드하고 클러스터를 고급이 아닌 상태로 유지해야 하는 경우 이 문서의 단계를 따르세요.

자세한 내용은 다음을 참조하세요.

• 버전 1.32 이하로 업그레이드하는 방법에 대한 자세한 내용은 클러스터 업그레이드를 참고하세요.

• 고급이 아닌 클러스터를 고급 클러스터로 업그레이드하는 방법에 대한 자세한 내용은 클러스터를 고급 클러스터로 업데이트 또는 업그레이드를 참고하세요.

기본 요건

• gkectl 버전은 대상 클러스터 버전과 동일해야 합니다.

  • 필요한 경우 gkectl 다운로드를 참고하여 지원되는 gkectl 버전을 가져옵니다.

• 업데이트하거나 업그레이드하기 전에 항상 클러스터를 진단하세요.

• 클러스터에서 권장 기능만 사용해야 합니다.

• 사용자 클러스터를 업그레이드하기 전에 관리자 클러스터를 업그레이드해야 합니다.

관리자 클러스터 업그레이드

1. 필요한 경우 관리자 워크스테이션을 업그레이드합니다.

2. OS 이미지를 vSphere로 가져옵니다.

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster=false
   

   다음을 바꿉니다.

   • BUNDLE_PATH: 번들 파일의 경로입니다. 이 파일은 /var/lib/gke/bundles/의 관리자 워크스테이션에 있습니다. 예를 들면 다음과 같습니다.

     /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: 관리자 클러스터 kubeconfig 파일의 경로입니다.

3. 관리자 클러스터 구성 파일에서 enableAdvancedCluster를 false로 설정합니다.

4. 관리자 클러스터 구성 파일의 bundlepath 필드가 업그레이드할 번들의 경로와 일치하는지 확인합니다.

5. 관리자 클러스터를 업그레이드하고 고급 클러스터가 아닌 클러스터로 유지합니다.

   gkectl upgrade admin \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config ADMIN_CLUSTER_CONFIG
   

   다음을 바꿉니다.

   • ADMIN_CLUSTER_KUBECONFIG: 관리자 클러스터 kubeconfig 파일의 경로입니다.
   • ADMIN_CLUSTER_CONFIG: 관리자 클러스터 구성 파일의 경로입니다.

   이 명령어는 관리 클러스터의 모든 노드를 다시 생성합니다.

사용자 클러스터 업그레이드

중요: 관리자 클러스터가 이미 업그레이드되었는지 확인합니다.

1. OS 이미지를 vSphere로 가져옵니다.

   gkectl prepare \
       --bundle-path BUNDLE_PATH \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --advanced-cluster=false
   

   다음을 바꿉니다.

   • BUNDLE_PATH: 번들 파일의 경로입니다. 이 파일은 /var/lib/gke/bundles/의 관리자 워크스테이션에 있습니다. 예를 들면 다음과 같습니다.

     /var/lib/gke/bundles/gke-onprem-vsphere-1.33.0-gke.799-full.tgz
     

   • ADMIN_CLUSTER_KUBECONFIG: 관리자 클러스터 kubeconfig 파일의 경로입니다.

2. 사용자 클러스터 구성 파일에서 enableAdvancedCluster를 false로 설정합니다.

3. 사용자 클러스터 구성 파일의 gkeOnPremVersion 필드가 업그레이드 대상 버전과 일치하는지 확인합니다.

4. 사용자 클러스터를 업그레이드하고 고급 클러스터가 아닌 상태로 유지합니다.

   gkectl upgrade cluster \
       --kubeconfig ADMIN_CLUSTER_KUBECONFIG \
       --config USER_CLUSTER_CONFIG
   

   다음을 바꿉니다.

   • ADMIN_CLUSTER_KUBECONFIG: 관리자 클러스터 kubeconfig 파일의 경로입니다.
   • USER_CLUSTER_CONFIG: 사용자 클러스터 구성 파일의 경로입니다.

   이 명령어를 실행하면 사용자 클러스터의 모든 노드가 다시 생성됩니다.