클러스터를 업데이트하거나 고급 클러스터로 업그레이드

이 문서에서는 버전 1.32에서 클러스터를 고급 클러스터로 업데이트하거나 업그레이드하는 방법을 보여줍니다.

기본 요건

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

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

  • 업데이트 또는 업그레이드를 시작하기 전에 클러스터에서 고급 클러스터에서 지원하지 않는 기능을 사용하지 않는지 확인하세요. 지원되지 않는 기능이 활성화되어 있으면 먼저 업데이트를 사용하여 사용 중지합니다.

    • 고급 클러스터에는 고가용성 (HA) 사용자 클러스터가 필요하지만 이 가이드에 따라 비HA 사용자 클러스터를 HA 고급 클러스터로 업데이트하거나 업그레이드할 수 있습니다.

  • 사용자 클러스터를 업데이트하거나 업그레이드하기 전에 관리자 클러스터를 고급 클러스터로 업데이트하거나 업그레이드해야 합니다.

관리자 클러스터를 고급 클러스터로 업데이트 또는 업그레이드

업데이트

  1. 고급 클러스터 준비:

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

    다음을 바꿉니다.

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz

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

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

  3. 관리자 클러스터를 고급 클러스터로 업데이트합니다.

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

    다음을 바꿉니다.

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

    이 명령어는 관리자 클러스터의 모든 노드를 다시 만듭니다.

업그레이드

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

  2. 고급 클러스터 준비:

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

    다음을 바꿉니다.

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz

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

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

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

  5. 관리자 클러스터를 고급 클러스터로 업그레이드합니다.

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

    다음을 바꿉니다.

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

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

관리자 클러스터가 고급 클러스터로 업데이트되거나 업그레이드된 후에는 다음을 수행할 수 있습니다.

  • 기존의 고급이 아닌 사용자 클러스터는 계속 정상적으로 작동합니다.

  • 고급 관리자 클러스터에서 관리하는 고급 사용자 클러스터만 만들 수 있습니다.

일관되고 완전한 기능을 갖춘 환경을 유지하려면 모든 사용자 클러스터를 고급 클러스터로 업그레이드하는 것이 좋습니다.

사용자 클러스터를 고급 클러스터로 업데이트 또는 업그레이드

업데이트

  1. 사용자 클러스터 컨트롤 플레인이 고가용성 (HA)이 아닌 경우:

    1. masterNode.replicas을 1에서 3으로 변경합니다.

    2. 사용자 클러스터 컨트롤 플레인 노드의 고정 IP 주소를 network.controlPlaneIPBlock.ips 섹션에 추가합니다.

  2. 고급 클러스터 준비:

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

    다음을 바꿉니다.

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz

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

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

  4. 사용자 클러스터를 고급 클러스터로 업데이트합니다.

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

    다음을 바꿉니다.

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

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

업그레이드

  1. 사용자 클러스터 컨트롤 플레인이 고가용성 (HA)이 아닌 경우:

    1. masterNode.replicas을 1에서 3으로 변경합니다.

    2. 사용자 클러스터 컨트롤 플레인 노드의 고정 IP 주소를 network.controlPlaneIPBlock.ips 섹션에 추가합니다.

  2. 고급 클러스터 준비:

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

    다음을 바꿉니다.

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

      /var/lib/gke/bundles/gke-onprem-vsphere-1.32.0-gke.1085-full.tgz

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

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

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

  5. 사용자 클러스터를 고급 클러스터로 업그레이드합니다.

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

    다음을 바꿉니다.

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

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

고급 클러스터로 이동한 후의 주요 차이점

클러스터를 고급 클러스터로 업그레이드하거나 업데이트하면 표준 클러스터와 비교해 몇 가지 주요 차이점이 발생합니다. 고급 클러스터의 주요 변경사항은 다음과 같습니다.

  • 리소스 위치: 클러스터 및 머신 리소스가 더 이상 사용자 클러스터에 있지 않습니다. 이러한 리소스는 관리자 클러스터 내에만 있습니다.

  • NodeExternalIP: 노드에 NodeExternalIP이 설정되어 있지 않습니다.

  • cert-manager 설치: 고급 클러스터에 cert-manager이 자동으로 설치됩니다. 클러스터에 cert-manager를 설치한 경우 고급 클러스터로 업데이트하거나 업그레이드하면 고급 클러스터 버전으로 덮어쓰여집니다.

기능 차이점에 대한 포괄적인 개요는 기능 비교 표를 참고하세요.