베어메탈용 Anthos 클러스터 업그레이드

베어메탈용 Anthos 클러스터 업그레이드

새 버전의 bmctl을 설치하면 이전 버전으로 생성된 기존 클러스터를 업그레이드할 수 있습니다. 클러스터를 최신 베어메탈용 Anthos 클러스터 버전으로 업그레이드하면 클러스터에 추가 기능 및 수정 사항이 적용됩니다. 또한 클러스터가 지원되는 상태로 유지됩니다. bmctl upgrade cluster 명령어로 관리자, 하이브리드, 독립형, 사용자 클러스터를 업그레이드할 수 있습니다.

실행 전 검사는 클러스터 상태와 노드 상태를 검사하기 위해 클러스터 업그레이드 전에 실행됩니다.

다음 예시는 초기 버전 1.6.0에서 베어메탈용 Anthos 클러스터 1.6.1로 업그레이드 프로세스를 보여줍니다.

동일한 방식으로 1.6.1을 1.6.2로 업그레이드할 수 있습니다. 업그레이드 건너뛰기 (1.6.0~1.6.2)도 지원됩니다.

베어메탈용 Anthos 클러스터에서 관리자, 독립형 또는 하이브리드 클러스터 업그레이드

bmctl의 새 버전을 다운로드하여 설치하면 이전 버전으로 만든 관리자, 하이브리드 및 독립형 클러스터를 업그레이드할 수 있습니다. bmctl의 특정 버전에서는 클러스터를 동일한 버전으로만 업그레이드할 수 있습니다.

먼저 최신 bmctl을 다운로드한 다음 적절한 클러스터 구성 파일을 수정한 후 bmctl upgrade cluster 명령어를 실행하여 업그레이드를 완료합니다.

  1. Cloud Storage 버킷에서 최신 bmctl을 다운로드합니다.
    gsutil cp gs://anthos-baremetal-release/bmctl/1.6.2/linux-amd64/bmctl bmctl
    chmod a+x bmctl
    
  2. 클러스터 구성 YAML 파일을 수정하여 베어메탈용 Anthos 클러스터의 클러스터 버전을 1.6.1에서 1.6.2로 변경합니다. 다음은 관리자 클러스터 구성의 예시를 보여줍니다.
  3. ---
    apiVersion: baremetal.cluster.gke.io/v1
    kind: Cluster
    metadata:
      name: cluster1
      namespace: cluster-cluster1
    spec:
      # Cluster type. This can be:
      #   1) admin:  to create an admin cluster. This can later be used to create user clusters.
      #   2) user:   to create a user cluster. Requires an existing admin cluster.
      #   3) hybrid: to create a hybrid cluster that runs admin cluster components and user workloads.
      #   4) standalone: to create a cluster that manages itself, runs user workloads, but does not manage other clusters.
      type: admin
      # Anthos cluster version.
      # Change the following line from 1.6.0 to 1.6.1, shown below
      anthosBareMetalVersion: 1.6.1
    
  4. bmctl upgrade cluster 명령어를 사용하여 업그레이드를 완료합니다. 여기서 CLUSTER_NAME은 클러스터 이름이며 ADMIN_KUBECONFIG는 관리자 클러스터 kubeconfig 파일 경로를 지정합니다.
  5. bmctl upgrade cluster -c CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG
    

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

관리자, 하이브리드 또는 독립형 클러스터를 성공적으로 업그레이드하면 관리하는 사용자 클러스터를 업그레이드할 수 있습니다.

먼저 적절한 사용자 클러스터 구성 파일을 수정한 후 kubectl apply 명령어를 실행하여 수정된 구성 파일을 적용하고 업그레이드를 완료합니다.

  1. 사용자 클러스터 구성 YAML 파일을 수정하여 베어메탈용 Anthos 클러스터의 클러스터 버전을 1.6.0에서 1.6.1로 변경합니다.
  2. ---
    apiVersion: baremetal.cluster.gke.io/v1
    kind: Cluster
    metadata:
      name: cluster1
      namespace: cluster-cluster1
    spec:
      # Cluster type. This can be:
      #   1) admin:  to create an admin cluster. This can later be used to create user clusters.
      #   2) user:   to create a user cluster. Requires an existing admin cluster.
      #   3) hybrid: to create a hybrid cluster that runs admin cluster components and user workloads.
      #   4) standalone: to create a cluster that manages itself, runs user workloads, but does not manage other clusters.
      type: user
      # Anthos cluster version.
      # Change the following line from 1.6.0 to 1.6.1, shown below
      anthosBareMetalVersion: 1.6.1
    
  3. kubectl 명령어를 실행하여 수정된 사용자 클러스터 구성을 적용하고 클러스터를 만듭니다.
  4.   kubectl --kubeconfig ADMIN_KUBECONFIG apply -f USER_CLUSTER_CONFIG
      
    ADMIN_KUBECONFIG는 관리자 클러스터 kubeconfig 파일의 경로를 지정하고 USER_CLUSTER_CONFIG은 이전 섹션에서 수정한 사용자 클러스터 YAML 파일의 경로를 지정합니다. 예를 들어 admin이라는 관리자 클러스터와 user1이라는 사용자 클러스터의 경우 명령어는 다음과 같습니다.
    kubectl --kubeconfig bmctl-workspace/admin/admin-kubeconfig apply /
      -f bmctl-workspace/user1/user1.yaml
    

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

업그레이드 후 사용자 클러스터 버전을 확인하려면 kubectl get 명령어를 사용하여 버전을 반환합니다.

예를 들어 1.6.0에서 업그레이드한 후에 클러스터 버전이 1.6.1인지 확인하려면 다음 명령어를 실행합니다.

kubectl get cluster.baremetal.cluster.gke.io -n cluster-USER_CLUSTER_NAME \
  -o jsonpath='{.status.anthosBareMetalVersion}' --kubeconfig ADMIN_KUBECONFIG

각 항목의 의미는 다음과 같습니다.

  • ADMIN_KUBECONFIG는 관리자 클러스터 kubeconfig 파일의 경로를 지정합니다.
  • USER_CLUSTER_NAME은 사용자 클러스터의 이름입니다.

업그레이드가 성공하면 명령어는 업그레이드된 버전 번호를 반환합니다. 업그레이드가 완료되는 데 30분 정도가 소요될 수 있습니다.