Upgrade versi cluster Azure Anda

Halaman ini menjelaskan cara mengupgrade versi Kubernetes GKE pada cluster Azure.

Prasyarat

Mengupgrade versi Kubernetes cluster Anda adalah kasus khusus dari operasi update cluster yang lebih umum. Anda dapat membaca tentang operasi update cluster secara umum di halaman mengupdate cluster. Untuk mengupgrade versi cluster:

  • Anda harus mengupgrade setiap versi minor antara versi saat ini dan target. Misalnya, untuk mengupgrade dari 1.20 ke 1.22, Anda harus mengupgrade dari versi 1.20 ke 1.21 terlebih dahulu, lalu mengupgrade dari 1.21 ke 1.22.
  • Anda harus memiliki izin Pengelolaan Akses dan Identitas gkemulticloud.googleapis.com/azureClusters.update.

Cara GKE di Azure melakukan update

Karena upgrade cluster memerlukan pengaktifan ulang node bidang kontrol, GKE di Azure melakukan "update berkelanjutan" dengan langkah-langkah berikut:

  1. Pilih satu instance bidang kontrol untuk diperbarui. GKE di Azure mengupdate instance yang tidak responsif, jika ada, sebelum instance yang responsif.
  2. Menghapus instance. GKE di Azure membuat ulang instance dan instance melakukan booting dengan konfigurasi baru.
  3. Lakukan health check pada instance baru.
  4. Jika health check berhasil, pilih instance lain dan lakukan langkah yang sama pada instance tersebut. Ulangi siklus ini hingga semua instance dimulai ulang atau dibuat ulang. Jika health check gagal, GKE di Azure akan menempatkan cluster dalam status DEGRADED dan menghentikan update. Untuk mengetahui informasi selengkapnya, lihat bagian berikut.

Jika update gagal

Setelah diupdate, GKE di Azure melakukan health check pada cluster. Jika health check gagal, cluster akan ditandai sebagai DEGRADED. Anda dapat menampilkan status cluster dengan perintah Google Cloud CLI berikut:

gcloud container azure clusters describe CLUSTER_NAME \
  --location=GOOGLE_CLOUD_LOCATION

Ganti kode berikut:

  • CLUSTER_NAME: nama cluster Anda
  • GOOGLE_CLOUD_LOCATION: region Google Cloud yang mengelola cluster Anda

Melakukan upgrade

Memeriksa versi cluster

Sebelum mengupgrade versi cluster, gunakan perintah berikut untuk memeriksa versi yang tersedia di region Anda:

gcloud container azure get-server-config \
    --location=GOOGLE_CLOUD_LOCATION

Ganti GOOGLE_CLOUD_LOCATION dengan lokasi Google Cloud tempat Anda mengelola cluster.

Pilih metode upgrade

Anda dapat mengupgrade versi cluster melalui Google Cloud Console, Google Cloud CLI, atau GKE Multi-Cloud API. Jika ingin menggunakan konsol untuk mengupgrade cluster, Anda harus terlebih dahulu memilih dan mengonfigurasi metode autentikasi untuk login ke cluster. Untuk mengetahui informasi lebih lanjut, baca bagian Menghubungkan dan melakukan autentikasi ke cluster.

Konsol

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

    Buka cluster GKE

  2. Pilih project Google Cloud tempat cluster berada.

  3. Dalam daftar cluster, pilih nama cluster, lalu pilih View details di panel samping.

  4. Di tab Detail, pilih Upgrade.

  5. Di kotak dialog Upgrade the Kubernetes version for the cluster, pilih versi yang ingin Anda upgrade, lalu klik Done. Perlu diperhatikan bahwa Anda harus mengupgrade cluster di semua versi minor saat mengupgrade cluster.

gcloud

Untuk mengupgrade versi Kubernetes cluster Anda, jalankan perintah berikut:

gcloud container azure clusters update CLUSTER_NAME \
    --location=GOOGLE_CLOUD_LOCATION \
    --cluster-version=CLUSTER_VERSION

Ganti kode berikut:

API

Untuk mengupdate cluster melalui API, gunakan operasi PATCH di GKE Multi-Cloud API.

  1. Buat file JSON bernama cluster_update.json dengan konten berikut:

    {
        "controlPlane": {
           "version": "CLUSTER_VERSION",
        },
    }
    

    Ganti kode berikut:

  2. Perbarui setelan ini melalui GKE Multi-Cloud API dengan perintah berikut.

    curl -d @cluster_update.json -X PATCH \
       ENDPOINT/projects/PROJECT_ID/locations/GOOGLE_CLOUD_LOCATION/azureClusters/CLUSTER_ID?update_mask=controlPlane.Version
    

Ganti kode berikut:

Untuk informasi selengkapnya, lihat dokumentasi metode projects.locations.azureClusters.patch.

Mengupgrade kumpulan node

Setelah mengupgrade versi cluster, upgrade node pool untuk menyelesaikan prosesnya. Untuk mempelajari caranya, lihat Mengupdate node pool.

Langkah selanjutnya