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

이 페이지에서는 Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 Anthos On-Prem API로 관리되는 관리자 또는 사용자 클러스터를 업그레이드하는 방법을 설명합니다. 진행하기 전에 업그레이드 권장사항에서 업그레이드 요구사항, 권장사항, 업그레이드 프로세스에 대한 추가 정보를 참조하세요.

Anthos On-Prem API란?

Anthos On-Prem API는 표준 Google Cloud 애플리케이션을 사용하여 온프레미스 사용자 클러스터의 수명 주기를 관리할 수 있게 해주는 Google Cloud 호스팅 API입니다. Anthos On-Prem API는 Google Cloud 인프라에서 실행됩니다. Google Cloud 콘솔 및 gcloud CLI는 API의 클라이언트이며 API를 사용하여 데이터 센터에서 클러스터를 생성, 업데이트, 업그레이드, 삭제합니다. bmctl을 사용하여 클러스터를 만든 경우 표준 클라이언트를 사용할 수 있도록 Anthos On-Prem API에서 관리하도록 클러스터를 구성할 수 있습니다.

시작하기 전에

명령줄 도구 설치

gcloud CLI를 사용하여 클러스터를 업그레이드하거나 관리자 워크스테이션과 반대로 Connect 게이트웨이를 사용하여 로컬 컴퓨터에서 kubectl 명령어를 실행하려면 다음 명령줄 도구가 설치되었는지 확인합니다.

gcloud CLI의 최신 버전
Kubernetes 클러스터에 명령어를 실행하기 위한 kubectl. kubectl을 설치해야 하는 경우 이 안내를 따르세요.

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.13.1에서 1.13.2로 업그레이드하거나 1.12.1에서 1.13.1로 업그레이드할 수 있습니다. 설치된 버전보다 마이너 릴리스 수준이 한 단계 넘게 초과되는 버전으로는 업그레이드가 허용되지 않습니다.

관리자 클러스터는 동일하거나 이전 부 버전에 있는 사용자 클러스터를 관리할 수 있습니다. 관리되는 사용자 클러스터는 관리자 클러스터보다 부 버전이 둘 이상 낮아지면 안 됩니다.

유의해야 할 제한사항은 다음과 같습니다.

콘솔 또는 gcloud CLI를 사용하여 1.13.1 이상의 사용자 클러스터만 업그레이드할 수 있습니다. 사용자 클러스터 버전이 1.13.0 이하이면 bmctl을 사용하여 클러스터를 업그레이드합니다.
연결된 사용자 클러스터를 업그레이드하기 전에 관리자 클러스터를 업그레이드해야 합니다. 하지만 관리자 클러스터를 1.13.5로 업그레이드하기 전에 연관된 사용자 클러스터가 1.12.0 이상 버전인지 확인하세요.

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

관리자 클러스터가 Anthos On-Prem API에 등록되었는지 확인합니다. 자세한 내용은 Anthos On-Prem API에서 관리할 클러스터 구성을 참조하세요.

콘솔

Console에서 Anthos 클러스터 페이지로 이동합니다.

Anthos 클러스터 페이지로 이동
클라우드 프로젝트를 선택한 후 업그레이드하려는 클러스터를 선택합니다.
세부정보 패널에서 추가 세부정보를 클릭합니다.
클러스터 기본사항 섹션에서 업그레이드를 클릭합니다.
대상 버전 선택 목록에서 업그레이드하려는 버전을 선택합니다. 최신 패치 버전으로 업그레이드하는 것이 좋습니다.
업그레이드를 클릭합니다.

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

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

gcloud CLI

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

필드 및 플래그에 대한 자세한 내용은 gcloud alpha container bare-metal admin-clusters 참조를 확인하세요.

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

콘솔

Console에서 Anthos 클러스터 페이지로 이동합니다.

Anthos 클러스터 페이지로 이동
클라우드 프로젝트를 선택한 후 업그레이드하려는 클러스터를 선택합니다.
세부정보 패널에서 추가 세부정보를 클릭합니다.
클러스터 기본사항 섹션에서 업그레이드를 클릭합니다.
대상 버전 선택 목록에서 업그레이드하려는 버전을 선택합니다. 최신 패치 버전으로 업그레이드하는 것이 좋습니다.
업그레이드를 클릭합니다.

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

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

gcloud CLI

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

필드 및 플래그에 대한 자세한 내용은 gcloud alpha container bare-metal clusters 참조를 확인하세요.