Mengupgrade versi cluster AWS Anda

Halaman ini menjelaskan cara mengupgrade versi Kubernetes cluster GKE di AWS.

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:

  • Anda harus mengupgrade melalui setiap versi minor antara versi saat ini dan versi target. Misalnya, untuk mengupgrade dari 1.20 ke 1.22, Anda harus mengupgrade dari 1.20 ke 1.21 terlebih dahulu, lalu mengupgrade dari 1.21 ke 1.22.
  • Anda harus memiliki izin Identity and Access Management gkemulticloud.googleapis.com/awsClusters.update.

Cara GKE on AWS melakukan update

Karena mengupgrade cluster memerlukan memulai ulang node bidang kontrol, GKE di AWS melakukan "update bertahap" dengan langkah-langkah berikut:

  1. Pilih satu instance bidang kontrol yang akan diupdate. GKE on AWS memperbarui instance yang tidak responsif, jika ada, sebelum instance yang responsif.
  2. Buat template peluncuran baru untuk instance.
  3. Perbarui template peluncuran grup Penskalaan Otomatis.
  4. Menghapus instance. AWS membuat ulang instance dan instance melakukan booting dengan konfigurasi baru.
  5. Lakukan health check pada instance baru.
  6. Jika health check berhasil, pilih instance lain dan lakukan langkah-langkah yang sama di instance tersebut. Ulangi siklus ini hingga semua instance dimulai ulang atau dibuat ulang. Jika health check gagal, GKE di AWS akan menempatkan cluster ke status DEGRADED dan menghentikan update. Untuk informasi selengkapnya, lihat bagian berikut.
  7. Hapus template peluncuran asli.

Jika update gagal

Setelah update, GKE di AWS akan melakukan pemeriksaan kondisi cluster. Jika health check gagal, cluster akan ditandai sebagai DEGRADED. Anda dapat menampilkan status cluster dengan perintah Google Cloud CLI berikut:

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

Ganti kode berikut:

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

Lakukan upgrade

Memeriksa versi cluster Anda

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

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

Ganti GOOGLE_CLOUD_LOCATION dengan Google Cloud lokasi tempat Anda mengelola cluster.

Memilih metode upgrade

Anda dapat mengupgrade versi cluster melalui konsol Google Cloud , Google Cloud CLI, atau GKE Multi-Cloud API. Jika ingin menggunakan konsol untuk mengupgrade cluster, Anda harus memilih dan mengonfigurasi metode autentikasi terlebih dahulu untuk login ke cluster. Untuk mengetahui informasi selengkapnya, lihat Menghubungkan dan mengautentikasi ke cluster Anda.

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. Di daftar cluster, pilih nama cluster, lalu pilih Lihat detail 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. Perhatikan bahwa Anda harus melakukan upgrade melalui semua versi minor saat mengupgrade cluster.

gcloud

Untuk mengupgrade versi Kubernetes cluster Anda, jalankan perintah berikut:

gcloud container aws 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:

    • CLUSTER_VERSION: versi cluster yang didukung baru. Perhatikan bahwa Anda harus melakukan upgrade melalui semua versi minor saat mengupgrade cluster

  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/awsClusters/CLUSTER_ID?update_mask=controlPlane.Version

Ganti kode berikut:

Untuk mengetahui informasi selengkapnya, lihat dokumentasi metode projects.locations.awsClusters.patch.

Mengupgrade node pool

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

Langkah berikutnya