Cluster Anthos on bare metal kini menjadi Google Distributed Cloud (khusus software) untuk bare metal. Untuk mengetahui informasi selengkapnya, lihat ringkasan produk.

Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupgrade cluster admin atau pengguna menggunakan klien GKE On-Prem API

Halaman ini menjelaskan cara menggunakan Konsol Google Cloud atau Google Cloud CLI untuk mengupgrade cluster pengguna atau admin Google Distributed Cloud yang terdaftar di GKE On-Prem API. Jika membuat cluster pengguna menggunakan Terraform, Anda dapat menggunakan Terraform untuk mengupgrade cluster pengguna. Untuk persyaratan upgrade, praktik terbaik, dan informasi tambahan tentang proses upgrade, tinjau Praktik terbaik upgrade dan Siklus proses dan tahap upgrade cluster sebelum melanjutkan.

Apa yang dimaksud dengan GKE On-Prem API?

GKE On-Prem API adalah API yang dihosting Google Cloud yang memungkinkan Anda mengelola siklus proses cluster on-premise menggunakan Terraform dan alat Google Cloud standar. GKE On-Prem API berjalan di infrastruktur Google Cloud. Terraform, konsol Google Cloud, dan Google Cloud CLI adalah klien API, dan ketiganya menggunakan API untuk membuat, mengupdate, mengupgrade, dan menghapus cluster di pusat data Anda. Jika Anda membuat cluster menggunakan klien standar, cluster akan terdaftar di GKE On-Prem API, yang berarti Anda dapat menggunakan klien standar untuk mengelola siklus proses cluster (dengan beberapa pengecualian). Jika membuat cluster menggunakan bmctl, Anda dapat mendaftarkan cluster di GKE On-Prem API, yang memungkinkan Anda menggunakan klien standar.

Sebelum memulai

Menyiapkan gcloud CLI

Untuk menggunakan gcloud CLI atau Terraform guna mengupgrade cluster:

Pastikan Anda memiliki gcloud CLI versi terbaru. Perbarui komponen gcloud CLI, jika diperlukan:
```
gcloud components update
```

Persyaratan IAM

Jika bukan pemilik project, Anda harus diberi peran Identity and Access Management roles/gkeonprem.admin di project Google Cloud tempat cluster dibuat. Untuk mengetahui detail tentang izin yang disertakan dalam peran ini, lihat Peran on-prem GKE dalam dokumentasi IAM.

Untuk menggunakan konsol guna mengupgrade cluster, setidaknya Anda memerlukan hal berikut:

roles/container.viewer. Peran ini memungkinkan pengguna melihat halaman Cluster GKE dan resource penampung lainnya di konsol. Untuk mengetahui detail tentang izin yang disertakan dalam peran ini, atau untuk memberikan peran dengan izin baca/tulis, lihat peran Kubernetes Engine dalam dokumentasi IAM.
roles/gkehub.viewer. Peran ini memungkinkan pengguna melihat cluster di konsol. Untuk mengetahui detail tentang izin yang disertakan dalam peran ini, atau untuk memberikan peran dengan izin baca/tulis,lihat peran GKE Hub dalam dokumentasi IAM.

Persyaratan versi

Diperlukan waktu sekitar 7 hingga 14 hari setelah rilis Google Distributed Cloud agar versi tersebut tersedia di GKE On-Prem API.

Anda dapat mengupgrade langsung ke versi yang berada dalam rilis minor yang sama atau rilis minor berikutnya. Misalnya, Anda dapat mengupgrade dari 1.30.100 ke 1.30.200, atau dari 1.29.100 ke 1.30.200. Mengupgrade ke versi yang lebih dari satu rilis minor setelah versi yang diinstal tidak diizinkan.

Cluster admin dapat mengelola cluster pengguna yang menggunakan versi minor yang sama atau sebelumnya. Cluster pengguna terkelola tidak boleh lebih dari satu versi minor lebih rendah dari cluster admin. Jadi, sebelum mengupgrade cluster admin ke versi minor baru, pastikan semua cluster pengguna terkelola berada di versi minor yang sama dengan cluster admin.

Mengupgrade cluster admin

Konsol

Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

Buka cluster GKE
Pilih project Google Cloud, lalu pilih cluster yang ingin Anda upgrade.
Di panel Detail, klik Detail selengkapnya.
Di bagian Dasar-dasar cluster, klik Upgrade.
Dalam daftar Choose target version, pilih versi yang ingin Anda upgrade. Sebaiknya upgrade ke versi patch terbaru.
Klik Upgrade.

Sebelum cluster diupgrade, pemeriksaan pra-penerbangan akan dijalankan untuk memvalidasi status cluster dan kesehatan node. Jika pemeriksaan pra-penerbangan lulus, cluster admin akan diupgrade. Diperlukan waktu 30 menit atau lebih untuk menyelesaikan upgrade, bergantung pada ukuran cluster Anda.

Untuk melihat status upgrade, klik Show Details di tab Cluster Details.

gcloud CLI

Atau, cantumkan semua cluster admin yang terdaftar dalam project untuk mengonfirmasi nama dan region cluster:
```
gcloud container bare-metal admin-clusters list \
  --project=PROJECT_ID \
  --location=-
```
- Ganti PROJECT_ID dengan ID project host fleet tempat cluster menjadi anggota. Jika Anda membuat cluster menggunakan bmctl, ini adalah project ID di kolom gkeConnect.projectID dalam file konfigurasi cluster.
- Jika Anda menetapkan --location=-, artinya Anda mencantumkan semua cluster di semua wilayah. Jika Anda perlu mempersempit cakupan daftar, tetapkan --location ke region tertentu.
Jika Anda mendapatkan error PERMISSION_DENIED, periksa kembali project ID yang Anda masukkan. Jika project ID sudah benar, jalankan gcloud auth login untuk login ke Google Cloud CLI dengan akun yang memiliki akses ke project.
Dapatkan daftar versi yang tersedia untuk diupgrade:
```
gcloud container bare-metal admin-clusters query-version-config \
  --admin-cluster=ADMIN_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION
```
Ganti kode berikut:
- ADMIN_CLUSTER_NAME: Nama cluster admin.
- PROJECT_ID: ID project host fleet tempat cluster menjadi anggota.
- REGION: Region Google Cloud tempat GKE On-Prem API berjalan dan menyimpan metadata cluster.
Upgrade cluster admin:
```
gcloud container bare-metal admin-clusters update ADMIN_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --version=VERSION
```
Ganti VERSION dengan versi Google Distributed Cloud yang ingin Anda upgrade. Tentukan versi dari output perintah sebelumnya. Sebaiknya upgrade ke versi patch terbaru.

Output dari perintah ini akan mirip dengan berikut ini:
```
Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.
```
Dalam contoh output, string operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179 adalah OPERATION_ID dari operasi yang berjalan lama.

Untuk mengetahui status operasi, salin OPERATION_ID dari output Anda ke perintah berikut. Buka jendela terminal lain dan jalankan perintah.
```
gcloud container bare-metal operations describe OPERATION_ID \
  --project=PROJECT_ID \
  --location=REGION
```

Diperlukan waktu 30 menit atau lebih untuk menyelesaikan upgrade, bergantung pada ukuran cluster Anda. Saat cluster diupgrade, Anda dapat menjalankan perintah sebelumnya setiap saat untuk mendapatkan status saat ini.

Setelah upgrade selesai, Anda akan melihat sesuatu yang mirip dengan berikut di jendela terminal tempat Anda menjalankan perintah gcloud ... update:

Updated Anthos on bare metal Admin Cluster [https://gkeonprem.googleapis.com/v1/projects/example-project-1234/locations/us-central1/bareMetalAdminClusters/abm-admin-cluster].
NAME               LOCATION     VERSION     MEMBERSHIP         STATE
abm-admin-cluster  us-central1  1.30.300-gke.84      abm-admin-cluster  RUNNING

Untuk informasi tambahan tentang kolom dan flag, lihat referensi cluster admin bare metal penampung gcloud.

Mengupgrade cluster pengguna

Konsol

Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

Buka cluster GKE
Pilih project Google Cloud, lalu pilih cluster yang ingin Anda upgrade.
Di panel Detail, klik Detail selengkapnya.
Di bagian Dasar-dasar cluster, klik Upgrade.
Dalam daftar Choose target version, pilih versi yang ingin Anda upgrade.
Klik Upgrade.

Sebelum cluster diupgrade, pemeriksaan pra-penerbangan akan dijalankan untuk memvalidasi status cluster dan kesehatan node. Jika pemeriksaan pra-penerbangan lulus, cluster pengguna akan diupgrade. Diperlukan waktu 30 menit atau lebih untuk menyelesaikan upgrade, bergantung pada ukuran cluster Anda.

Untuk melihat status upgrade, klik Show Details di tab Cluster Details.

gcloud CLI

Atau, cantumkan semua cluster pengguna yang terdaftar dalam project untuk mengonfirmasi nama dan region cluster:
```
gcloud container bare-metal clusters list \
  --project=PROJECT_ID \
  --location=-
```
- Ganti PROJECT_ID dengan ID project host fleet tempat cluster menjadi anggota. Jika Anda membuat cluster menggunakan bmctl, ini adalah project ID di kolom gkeConnect.projectID dalam file konfigurasi cluster.
- Jika Anda menetapkan --location=-, artinya Anda mencantumkan semua cluster di semua wilayah. Jika Anda perlu mempersempit cakupan daftar, tetapkan --location ke region tertentu.
Output perintah ini akan mirip dengan berikut ini:
```
NAME              LOCATION     VERSION  ADMIN_CLUSTER      STATE
abm-user-cluster  us-central1  1.30.300-gke.84   abm-admin-cluster  RUNNING
```
Jika Anda mendapatkan error PERMISSION_DENIED, periksa kembali project ID yang Anda masukkan. Jika project ID sudah benar, jalankan gcloud auth login untuk login ke Google Cloud CLI dengan akun yang memiliki akses ke project.
Dapatkan daftar versi yang tersedia untuk diupgrade:
```
gcloud container bare-metal clusters query-version-config \
  --cluster=USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION
```
Ganti kode berikut:
- USER_CLUSTER_NAME: Nama cluster pengguna yang akan diupgrade.
- PROJECT_ID: ID project host fleet tempat cluster menjadi anggota.
- REGION: Region Google Cloud tempat GKE On-Prem API berjalan dan menyimpan metadata cluster.
Output perintah ini akan mirip dengan berikut ini
```
versions:
- hasDependencies: true
version: 1.15.2
- hasDependencies: true
version: 1.15.1
- hasDependencies: true
version: 1.15.0
- version: 1.14.6
```
Pilih versi yang tidak tercantum di bagian - hasDependencies: true. Dalam contoh ini, satu-satunya versi yang tersedia yang dapat Anda gunakan untuk mengupgrade cluster pengguna adalah 1.14.6.
Upgrade cluster pengguna:
```
gcloud container bare-metal clusters update USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --version=VERSION
```
Ganti VERSION dengan versi Google Distributed Cloud yang ingin Anda upgrade. Tentukan versi dari output perintah sebelumnya. Sebaiknya upgrade ke versi patch terbaru.

Output dari perintah ini akan mirip dengan berikut ini:
```
Waiting for operation [projects/example-project-12345/locations/us-west1/operations/operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179] to complete.
```
Dalam contoh output, string operation-1679543737105-5f7893fd5bae9-942b3f97-75e59179 adalah OPERATION_ID dari operasi yang berjalan lama.

Untuk mengetahui status operasi, salin OPERATION_ID dari output Anda ke perintah berikut. Buka jendela terminal lain dan jalankan perintah.
```
gcloud container bare-metal operations describe OPERATION_ID \
  --project=PROJECT_ID \
  --location=REGION
```

Untuk informasi tambahan tentang kolom dan flag, lihat referensi cluster bare metal penampung gcloud.

Terraform

Untuk mengupgrade cluster menggunakan Terraform, Anda menggunakan konfigurasi Terraform yang sama dengan yang digunakan untuk membuat cluster.

Ubah ke direktori tempat file konfigurasi Terraform berada.
Dapatkan daftar versi yang tersedia untuk diupgrade:
```
gcloud container bare-metal clusters query-version-config \
  --cluster=USER_CLUSTER_NAME \
  --project=PROJECT_ID \
  --location=REGION
```
Ganti kode berikut:
- USER_CLUSTER_NAME: Nama cluster pengguna yang akan diupgrade.
- PROJECT_ID: ID project host fleet tempat cluster pengguna tersebut menjadi anggota.
- REGION: Region Google Cloud tempat GKE On-Prem API berjalan dan menyimpan metadata-nya.
Jika Anda mendapatkan error PERMISSION_DENIED, periksa kembali project ID yang Anda masukkan. Jika project ID sudah benar, jalankan gcloud auth login untuk login ke Google Cloud CLI dengan akun yang memiliki akses ke project.
Dalam konfigurasi Terraform, ubah bare_metal_version ke versi Google Distributed Cloud yang ingin Anda upgrade. Tentukan versi dari output perintah sebelumnya. Sebaiknya upgrade ke versi patch terbaru.
Lakukan inisialisasi dan buat rencana Terraform:
```
terraform init
```
Terraform menginstal library yang diperlukan, seperti penyedia Google Cloud.
Tinjau konfigurasi dan buat perubahan jika diperlukan:
```
terraform plan
```
Terapkan rencana Terraform untuk membuat cluster pengguna:
```
terraform apply
```

Untuk informasi tentang resource google_gkeonprem_bare_metal_cluster, lihat dokumentasi referensi.