Version 1.14. This version is no longer supported. For more information see the version support policy.

Anthos On-Prem API 클라이언트를 사용하여 사용자 클러스터 업그레이드

이 페이지에서는 Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 Anthos On-Prem API에서 관리하는 VMware용 GKE 사용자 클러스터를 업그레이드하는 방법을 설명합니다. 사용자 클러스터를 업그레이드하기 전 업그레이드 권장사항을 검토하는 것이 좋습니다.

Anthos On-Prem API란?

Anthos On-Prem API는 Terraform 및 표준 Google Cloud 도구를 사용하여 온프레미스 클러스터의 수명 주기를 관리할 수 있게 해주는 Google Cloud 호스팅 API입니다. Anthos On-Prem API는 Google Cloud 인프라에서 실행됩니다. Terraform, Google Cloud 콘솔, Google Cloud CLI는 API의 클라이언트이며 API를 사용하여 데이터 센터에서 클러스터를 생성, 업데이트, 업그레이드, 삭제합니다. 표준 클라이언트를 사용하여 클러스터를 만든 경우 클러스터가 Anthos On-Prem API에 등록됩니다. 즉, 표준 클라이언트를 사용하여 클러스터의 수명 주기를 관리할 수 있습니다(일부 예외 있음). gkectl을 사용하여 클러스터를 만든 경우 표준 클라이언트를 사용할 수 있는 Anthos On-Prem API에서 클러스터를 등록할 수 있습니다.

시작하기 전에

gcloud CLI 설정

gcloud CLI 또는 Terraform을 사용하여 클러스터를 업그레이드하려면 다음 안내를 따르세요.

최신 버전의 gcloud CLI가 있는지 확인합니다. 필요한 경우 gcloud CLI 구성요소를 업데이트합니다.
```
gcloud components update
```

IAM 요구사항

프로젝트 소유자가 아닌 경우 클러스터가 생성된 Google Cloud 프로젝트에 대해 Identity and Access Management 역할 roles/gkeonprem.admin을 부여 받아야 합니다. 이 역할에 포함된 권한에 대한 자세한 내용은 IAM 문서의 GKE On-Prem 역할을 참조하세요.

콘솔을 사용하여 클러스터를 업그레이드하려면 최소한 다음이 필요합니다.

roles/container.viewer. 이 역할을 통해 사용자는 콘솔에서 GKE 클러스터 페이지와 기타 컨테이너 리소스를 볼 수 있습니다. 이 역할에 포함된 권한에 대한 자세한 내용이나 읽기/쓰기 권한이 있는 역할을 부여하려면 IAM 문서의 Kubernetes Engine 역할을 참조하세요.
roles/gkehub.viewer. 이 역할은 사용자가 콘솔에서 클러스터를 볼 수 있게 해줍니다. 이 역할에 포함된 권한에 대한 자세한 내용이나 읽기/쓰기 권한이 있는 역할을 부여하려면 IAM 문서의 GKE 허브 역할을 참조하세요.

업그레이드 옵션

관리자 클러스터가 1.14 이상이면 Anthos On-Prem API로 관리되는 사용자 클러스터에 대해 다음 업그레이드 옵션이 제공됩니다.

다음 섹션에 설명된 미리보기 업그레이드 절차를 사용합니다.
미리보기 업그레이드 절차 없이 gkectl 또는 콘솔을 사용하여 업그레이드하려면 VMware용 GKE 업그레이드를 참조하세요.

동일한 부 출시 버전 또는 다음 부 출시 버전에 속하는 모든 버전으로 직접 업그레이드할 수 있습니다. 예를 들어 1.14.1에서 1.14.2로 업그레이드하거나 1.13.1에서 1.14.1로 업그레이드할 수 있습니다. 설치된 버전보다 마이너 릴리스 수준이 한 단계 넘게 초과되는 버전으로는 업그레이드가 허용되지 않습니다.

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

관리자 클러스터가 1.14 이상이면 Anthos On-Prem API 클라이언트를 사용하여 사용자 클러스터를 업그레이드할 수 있게 해주는 컨트롤러가 관리자 클러스터에 배포됩니다. 사용자 클러스터를 업그레이드하는 동안 아직 등록되지 않았으면 관리자 클러스터가 Anthos On-Prem API에 등록되므로, 관리자 워크스테이션에서 사용자 클러스터를 업그레이드하기 위해 어떤 명령어도 실행할 필요가 없습니다. 사용자 클러스터 업그레이드를 시작하면 Anthos On-Prem API가 업그레이드 준비를 위해 컨트롤러를 트리거합니다. 이 컨트롤러는 번들을 다운로드하고 설치합니다. 그런 후 사용자 클러스터를 관리하는 새 버전의 구성요소를 배포합니다.

사용자 클러스터를 업그레이드하려면 다음 안내를 따르세요.

콘솔

콘솔에서 GKE Enterprise 클러스터 페이지로 이동합니다.

GKE Enterprise 클러스터 페이지로 이동
Google Cloud 프로젝트를 선택한 후 업그레이드하려는 클러스터를 선택합니다.
세부정보 패널에서 추가 세부정보를 클릭합니다.
클러스터 기본사항 섹션에서 업그레이드를 클릭합니다.
대상 버전 선택 목록에서 업그레이드하려는 버전을 선택합니다. 선별된 목록에는 최신 패치 릴리스만 포함됩니다.
업그레이드를 클릭합니다.

클러스터가 업그레이드되기 전 클러스터 상태 및 노드 상태를 검증하기 위해 프리플라이트 검사가 실행됩니다. 프리플라이트 검사가 통과하면 사용자 클러스터가 업그레이드됩니다. 업그레이드를 완료하는 데 약 30분 정도 걸립니다.

업그레이드 상태를 보려면 클러스터 세부정보 탭에서 세부정보 표시를 클릭합니다.

gcloud CLI

다음 명령어를 실행하여 Google 계정으로 로그인합니다.
```
gcloud auth login
```
Google Cloud CLI 구성요소를 업데이트합니다.
```
gcloud components update
```
업그레이드할 수 있는 버전 목록을 가져옵니다.
```
gcloud container vmware clusters query-version-config \
  --cluster=USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION
```
다음을 바꿉니다.
- USER_CLUSTER_NAME: 사용자 클러스터의 이름입니다.
- FLEET_HOST_PROJECT_ID: 사용자 클러스터가 멤버인 Fleet 프로젝트의 ID입니다. 이 프로젝트는 클러스터를 만들 때 지정된 프로젝트입니다. gkectl을 사용하여 클러스터를 만들었으면 클러스터 구성 파일에서 gkeConnect.projectID 필드의 프로젝트 ID입니다.
- REGION: Anthos On-Prem API가 메타데이터를 실행하고 저장하는 Google Cloud 리전입니다. Anthos On-Prem API 클라이언트를 사용하여 클러스터를 만든 경우 이 리전은 클러스터를 만들 때 지정한 리전입니다. gkectl을 사용하여 클러스터를 만든 경우에는 Anthos On-Prem API를 사용하여 관리할 클러스터를 등록할 때 지정한 리전입니다.
클러스터 업그레이드
```
gcloud container vmware clusters upgrade USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION \
  --version=VERSION
```
다음을 바꿉니다.
- USER_CLUSTER_NAME: 업그레이드할 사용자 클러스터 이름입니다.
- FLEET_HOST_PROJECT_ID: 사용자 클러스터가 멤버인 Fleet 프로젝트의 ID입니다. 이 프로젝트는 클러스터를 만들 때 지정된 프로젝트입니다. gkectl을 사용하여 클러스터를 만들었으면 클러스터 구성 파일에서 gkeConnect.projectID 필드의 프로젝트 ID입니다.
- REGION: Anthos On-Prem API가 메타데이터를 실행하고 저장하는 Google Cloud 리전입니다. Anthos On-Prem API 클라이언트를 사용하여 클러스터를 만든 경우 이 리전은 클러스터를 만들 때 선택한 리전입니다. gkectl을 사용하여 클러스터를 만든 경우에는 Anthos On-Prem API를 사용하여 관리할 클러스터를 등록할 때 지정한 리전입니다.
- VERSION: 업그레이드할 VMware용 GKE 버전입니다. 이전 명령어의 출력에서 버전을 지정합니다. 최신 패치 버전으로 업그레이드하는 것이 좋습니다.
업그레이드를 완료하는 데 약 30분 정도 걸립니다.
클러스터를 업그레이드하는 동안 다른 터미널 창에서 다음 명령어를 실행하여 클러스터 상태를 확인합니다.
```
gcloud container vmware clusters describe USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION
```

필드 및 플래그에 대한 자세한 내용은 gcloud container vmware clusters upgrade를 참조하세요.