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

Halaman ini menjelaskan cara menggunakan Google Cloud konsol atau Google Cloud CLI untuk mengupgrade cluster admin atau pengguna Google Distributed Cloud yang terdaftar di GKE On-Prem API. Jika Anda membuat cluster pengguna menggunakan Terraform, Anda dapat menggunakan Terraform untuk mengupgrade cluster pengguna. Untuk mengetahui 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 lokal menggunakan Terraform dan alat standar Google Cloud GKE On-Prem API berjalan di Google Cloud's infrastruktur Google Cloud. Terraform, the Google Cloud console, dan Google Cloud CLI adalah klien API, dan 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 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. Update komponen gcloud CLI, jika diperlukan:

    gcloud components update

Persyaratan IAM

Jika Anda bukan pemilik project, Anda harus diberi peran Identity and Access Management role roles/gkeonprem.admin di Google Cloud project 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 minimal hal berikut:

  • roles/container.viewer. Peran ini memungkinkan pengguna melihat halaman Cluster GKE dan resource container 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 berada dalam rilis minor yang sama atau rilis minor berikutnya. Misalnya, Anda dapat mengupgrade dari 1.36.100 ke 1.36.200, atau dari 1.35.100 ke 1.36.200. Upgrade ke versi yang lebih dari satu rilis minor setelah versi yang diinstal 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 Anda ingin upgrade.

  3. Di panel Detail, klik Detail selengkapnya.

  4. Di bagian Dasar-dasar cluster, klik Upgrade.

  5. Dalam 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 akan dijalankan untuk memvalidasi status cluster dan kesehatan node. Jika pemeriksaan pra-penerbangan lulus, cluster admin akan diupgrade. Upgrade memerlukan waktu 30 menit atau lebih untuk selesai, bergantung pada ukuran cluster Anda.

Untuk melihat status upgrade, klik Tampilkan Detail di tab Detail Cluster.

gcloud CLI

  1. Secara opsional, 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 mencantumkan semua cluster di semua region. Jika Anda perlu mempersempit daftar, tetapkan --location ke a 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. 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 tempat Google Cloud 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 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 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 sesekali untuk mendapatkan status saat ini.

Setelah upgrade selesai, Anda akan melihat sesuatu yang mirip dengan berikut ini 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.36.200-gke.118      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 Anda ingin upgrade.

  3. Di panel Detail, klik Detail selengkapnya.

  4. Di bagian Dasar-dasar cluster, klik Upgrade.

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

  6. 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. Upgrade memerlukan waktu 30 menit atau lebih untuk selesai, bergantung pada ukuran cluster Anda.

Untuk melihat status upgrade, klik Tampilkan Detail di tab Detail Cluster.

gcloud CLI

  1. Secara opsional, 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 mencantumkan semua cluster di semua region. Jika Anda perlu mempersempit daftar, tetapkan --location ke a region tertentu.

    Output perintah ini akan mirip dengan berikut ini:

    NAME              LOCATION     VERSION  ADMIN_CLUSTER      STATE
abm-user-cluster  us-central1  1.36.200-gke.118   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. 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 tempat Google Cloud 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 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 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 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 sesekali 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. 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 tempat Google Cloud 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 upgrade 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.