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 admin atau pengguna 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 alatGoogle Cloud standar. GKE On-Prem API berjalan di infrastruktur Google Cloud's. Terraform, konsol Google Cloud , dan Google Cloud CLI adalah klien API, dan menggunakan API untuk membuat, memperbarui, mengupgrade, dan menghapus cluster di pusat data Anda. Jika Anda membuat cluster menggunakan klien standar, cluster akan didaftarkan di GKE On-Prem API, yang berarti Anda dapat menggunakan klien standar untuk mengelola siklus proses cluster (dengan beberapa pengecualian). Jika Anda 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:

1. Pastikan Anda memiliki gcloud CLI versi terbaru. Perbarui komponen gcloud CLI, jika diperlukan:

   gcloud components update
   

Persyaratan IAM

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

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

• roles/container.viewer. Peran ini memungkinkan pengguna melihat halaman GKE Clusters 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 tersedia di GKE On-Prem API.

Anda dapat mengupgrade langsung ke versi yang ada dalam rilis minor yang sama atau rilis minor berikutnya. Misalnya, Anda dapat mengupgrade dari 1.33.100 ke 1.33.200, atau dari 1.32.100 ke 1.33.200. Upgrade ke versi yang lebih dari satu rilis minor setelah versi yang terinstal tidak diizinkan.

Cluster admin dapat mengelola cluster pengguna yang berada di 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

1. Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

   Buka cluster GKE

2. Pilih Google Cloud project, lalu pilih cluster yang ingin Anda upgrade.

3. Di panel Detail, klik Detail selengkapnya.

4. Di bagian Cluster basics, klik Upgrade.

5. Di daftar Pilih versi target, pilih versi yang ingin Anda upgrade. Sebaiknya upgrade ke versi patch terbaru.

6. Klik Upgrade.

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

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

gcloud CLI

1. 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 anggotanya. Jika Anda membuat cluster menggunakan bmctl, ini adalah project ID di kolom gkeConnect.projectID dalam file konfigurasi cluster.

   • Jika Anda menetapkan --location=-, artinya 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.

2. Mendapatkan 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 anggotanya.

   • REGION: Google Cloud region tempat GKE On-Prem API berjalan dan menyimpan metadata cluster.

3. 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 Anda mengupgrade 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 dalam perintah berikut. Buka jendela terminal lain dan jalankan perintah.

   gcloud container bare-metal operations describe OPERATION_ID \
     --project=PROJECT_ID \
     --location=REGION
   

Upgrade memerlukan waktu 30 menit atau lebih untuk selesai, bergantung pada ukuran cluster Anda. Saat cluster diupgrade, Anda dapat menjalankan perintah sebelumnya secara berkala 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.33.100-gke.89      abm-admin-cluster  RUNNING

Untuk mengetahui informasi tambahan tentang kolom dan flag, lihat referensi gcloud container bare-metal admin-clusters.

Mengupgrade cluster pengguna

Konsol

1. Di konsol, buka halaman ringkasan cluster Google Kubernetes Engine.

   Buka cluster GKE

2. Pilih Google Cloud project, lalu pilih cluster yang ingin Anda upgrade.

3. Di panel Detail, klik Detail selengkapnya.

4. Di bagian Cluster basics, klik Upgrade.

5. Di daftar Pilih versi target, pilih versi yang ingin Anda upgrade.

6. Klik Upgrade.

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

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

gcloud CLI

1. 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 anggotanya. Jika Anda membuat cluster menggunakan bmctl, ini adalah project ID di kolom gkeConnect.projectID dalam file konfigurasi cluster.

   • Jika Anda menetapkan --location=-, artinya 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.33.100-gke.89   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.

2. Mendapatkan 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 anggotanya.

   • REGION: Google Cloud region 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.

3. 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 Anda mengupgrade 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 dalam perintah berikut. Buka jendela terminal lain dan jalankan perintah.

   gcloud container bare-metal operations describe OPERATION_ID \
     --project=PROJECT_ID \
     --location=REGION
   

Upgrade memerlukan waktu 30 menit atau lebih untuk selesai, bergantung pada ukuran cluster Anda. Saat cluster diupgrade, Anda dapat menjalankan perintah sebelumnya secara berkala untuk mendapatkan status saat ini.

Untuk mengetahui informasi tambahan tentang kolom dan flag, lihat referensi gcloud container bare-metal clusters.

Terraform

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

1. Ubah ke direktori tempat file konfigurasi Terraform berada.

2. Mendapatkan 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 anggotanya.

   • REGION: Region Google Cloud tempat GKE On-Prem API berjalan dan menyimpan metadatanya.

   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.

3. Dalam konfigurasi Terraform, ubah bare_metal_version ke versi Google Distributed Cloud yang ingin Anda upgrade. Tentukan versi dari output perintah sebelumnya. Sebaiknya Anda mengupgrade ke versi patch terbaru.

4. Lakukan inisialisasi dan buat rencana Terraform:

   terraform init
   

   Terraform menginstal library yang diperlukan, seperti Google Cloud penyedia.

5. Tinjau konfigurasi dan lakukan perubahan jika diperlukan:

   terraform plan
   

6. Terapkan rencana Terraform untuk membuat cluster pengguna:

   terraform apply
   

Untuk mengetahui informasi tentang resource google_gkeonprem_bare_metal_cluster, lihat dokumentasi referensi.