Mengurutkan peluncuran upgrade cluster

Autopilot Standard

---

Halaman ini menunjukkan cara mengelola upgrade cluster GKE menggunakan urutan peluncuran. Untuk mempelajari lebih lanjut, lihat Tentang upgrade cluster dengan urutan peluncuran.

Sebelum memulai

Sebelum memulai, pastikan Anda telah menjalankan tugas berikut:

• Aktifkan Google Kubernetes Engine API.
Aktifkan Google Kubernetes Engine API
• Jika ingin menggunakan Google Cloud CLI untuk tugas ini, instal lalu lakukan inisialisasi gcloud CLI. Jika sebelumnya Anda telah menginstal gcloud CLI, dapatkan versi terbaru dengan menjalankan gcloud components update.
  Catatan: Untuk penginstalan gcloud CLI yang ada, pastikan untuk menyetel properti compute/region dan compute/zone. Dengan menetapkan lokasi default, Anda dapat menghindari error di gcloud CLI seperti berikut: One of [--zone, --region] must be supplied: Please specify location.

• Pastikan Anda telah mengaktifkan API yang diperlukan untuk fleet. API ini harus diaktifkan di project host fleet Anda untuk membuat jenis urutan peluncuran apa pun.
• Pastikan Anda telah mengaktifkan GKE Enterprise di project host fleet jika ingin membuat urutan peluncuran berbasis tim (Pratinjau).
• Untuk petunjuk Terraform, pastikan Anda menggunakan versi 5.13.0 atau yang lebih baru dari penyedia google.

Peran yang diperlukan

• Pastikan Anda memiliki izin IAM yang diperlukan untuk pendaftaran cluster. Anda harus memberikan izin berikut:
  • Izin pendaftaran cluster di project host fleet Anda.
  • Izin admin cluster untuk cluster GKE apa pun yang akan didaftarkan.
  • Izin pendaftaran cluster lintas project untuk cluster GKE apa pun yang akan didaftarkan ke fleet di project berbeda.

Mengonfigurasi urutan peluncuran

Dokumen ini menjelaskan cara membuat urutan peluncuran menggunakan grup cluster yang diatur berdasarkan fleet atau cakupan tim. Dokumen ini menggunakan istilah grup untuk merujuk ke cakupan tim dan fleet, karena Anda dapat membuat urutan peluncuran yang diatur dengan salah satu metode pengelompokan.

Anda dapat membuat urutan hingga tiga grup cluster, dan dapat memilih durasi waktu pengujian perendaman yang diinginkan setelah upgrade cluster selesai dalam sebuah grup (maksimum 30 hari). Anda dapat menyertakan cluster Autopilot dan Standard.

Untuk membuat urutan peluncuran, cluster harus diatur ke dalam grup fleet atau cakupan tim. Untuk panduan cara mengatur cluster, lihat contoh bank komunitas. Setelah cluster diatur ke dalam grup, Anda dapat membuat urutan peluncuran dengan menentukan hubungan grup upstream dan waktu berdiam setiap grup. Upstream, dalam urutan peluncuran, mengacu pada grup sebelumnya, dan downstream mengacu pada grup berikutnya.

Mengatur cluster ke dalam grup

Dalam urutan peluncuran, semua cluster di semua grup harus didaftarkan di saluran rilis yang sama dan berada di versi minor yang sama. Jika persyaratan ini tidak terpenuhi dan ada perbedaan versi antar-cluster, hal ini dapat menyebabkan masalah pada peluncuran versi. Untuk mengetahui informasi selengkapnya, lihat Kelayakan peluncuran.

Anda dapat membuat urutan peluncuran antar-fleet, atau urutan peluncuran antar-cakupan tim tim (Pratinjau).

Seperti yang Anda lihat di Tentang upgrade cluster dengan urutan peluncuran, cakupan tim adalah konstruksi tingkat fleet perusahaan untuk mengaitkan subset cluster fleet dengan tim aplikasi tertentu. Anda harus mengaktifkan GKE Enterprise untuk menggunakan cakupan tim. Batasan berikut berlaku saat menggunakan atau membuat cakupan tim untuk urutan peluncuran:

• Urutan berbasis tim memerlukan cluster single-tenancy: dengan kata lain, setiap cluster hanya dikaitkan dengan satu tim. Cluster bersama (yang didukung dalam pengelolaan tim armada umum) tidak didukung untuk pengurutan peluncuran.

• Setiap cakupan tim harus berada di fleet yang berbeda untuk membuat urutan peluncuran di antara keduanya. Pembuatan urutan peluncuran antar-cakupan tim yang berbeda dalam satu fleet tidak didukung.

Jika cluster telah diatur ke dalam grup, Anda dapat melewati langkah-langkah berikut dan melanjutkan ke Membuat urutan peluncuran.

Fleet

Untuk membuat urutan peluncuran berbasis fleet, pertama-tama Anda harus mengelompokkan cluster ke dalam fleet. Anda dapat mengatur cluster berdasarkan lingkungan deployment, seperti Pengujian, Staging, dan Produksi, seperti yang ditunjukkan dalam contoh urutan peluncuran berbasis fleet.

Daftarkan setiap cluster ke fleet berdasarkan pengelompokan yang Anda pilih.

Tim

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk membuat urutan peluncuran berbasis tim, Anda harus mengelompokkan cluster ke dalam cakupan tim. Untuk melakukannya, pertama-tama atur cluster ke dalam fleet berdasarkan lingkungan deployment, seperti Pengujian, Staging, dan Produksi, seperti yang ditunjukkan dalam contoh urutan peluncuran berbasis cakupan. Kemudian, Anda dapat membagi lagi cluster Anda menjadi cakupan untuk cluster tim yang berbeda.

1. Untuk setiap cluster dalam urutan ini, daftarkan cluster Anda ke fleet. Cluster harus terdaftar ke fleet dalam project tempat Anda akan membuat cakupan tim untuk cluster ini. Jika ingin mendaftarkan cluster ke fleet yang berada di project host berbeda, pastikan Anda telah menetapkan izin yang diperlukan untuk pendaftaran lintas project.

2. Buat 2-3 cakupan tim untuk mengatur cluster Anda. Buat setiap cakupan di project host untuk fleet tim masing-masing. Anda dapat memiliki hingga tiga cakupan tim dalam urutan peluncuran.

   Baca referensi gcloud container fleet scopes create untuk mengetahui daftar lengkap flag. Dengan perintah create, Anda dapat menggunakan flag dalam petunjuk untuk membuat urutan peluncuran.

3. Tambahkan setiap cluster ke cakupan.

Membuat urutan peluncuran

Urutan peluncuran diatur sebagai daftar tertaut yang berisi maksimal tiga elemen.

Saat membuat urutan peluncuran, Anda menetapkan properti berikut untuk setiap grup cluster, entah itu fleet atau cakupan tim:

• Grup upstream: Cakupan tim atau fleet upstream, yang memenuhi syarat versi baru untuk grup downstream. Anda tidak perlu menetapkan grup upstream untuk grup pertama dalam sebuah urutan.
• Waktu berdiam: Waktu berdiam untuk sebuah grup adalah waktu antara saat upgrade selesai (atau peluncuran telah berlangsung 30 hari) dan saat upgrade dapat dimulai di grup downstream. Untuk mempelajari lebih lanjut, lihat Cara kerja kualifikasi versi dalam urutan peluncuran.

Catatan: Di konsol Google Cloud, Anda hanya dapat membuat, melihat, dan mengedit urutan peluncuran berbasis fleet, bukan urutan peluncuran berbasis tim.

Fleets - gcloud

Petunjuk berikut menggunakan perintah gcloud container fleet clusterupgrade update, tetapi Anda dapat menetapkan properti yang sama dengan perintah gcloud container fleet clusterupgrade create.

Untuk setiap perintah berikut, ganti SOAK_TIME dengan waktu berdiam untuk fleet yang Anda perbarui.

Buat urutan peluncuran:

1. Tetapkan waktu berdiam untuk fleet pertama dalam urutan:

   gcloud container fleet clusterupgrade update \
       --default-upgrade-soaking=SOAK_TIME \
       --project=FIRST_FLEET_PROJECT_ID
   

   Ganti FIRST_FLEET_PROJECT_ID dengan project ID untuk project host fleet.

2. Tetapkan fleet upstream dan waktu berdiam untuk fleet kedua dalam urutan:

   gcloud container fleet clusterupgrade update \
       --upstream-fleet=FIRST_FLEET_PROJECT_ID \
       --default-upgrade-soaking=SOAK_TIME \
       --project=SECOND_FLEET_PROJECT_ID
   

   Ganti FIRST_FLEET_PROJECT_ID dengan project ID untuk project host fleet pertama, dan SECOND_FLEET_PROJECT_ID dengan project ID untuk project host fleet.

3. Opsional: Jika Anda ingin menggunakan tiga fleet dalam sebuah urutan peluncuran, tetapkan fleet upstream untuk fleet ketiga dalam urutan itu:

   Catatan: Anda harus menetapkan waktu berdiam untuk setiap grup, termasuk grup terakhir dalam sebuah urutan peluncuran.

   gcloud container fleet clusterupgrade update \
       --upstream-fleet=SECOND_FLEET_PROJECT_ID \
       --default-upgrade-soaking=SOAK_TIME \
       --project=THIRD_FLEET_PROJECT_ID
   

   Ganti SECOND_FLEET_PROJECT_ID dengan project ID untuk project host fleet kedua, dan THIRD_FLEET_PROJECT_ID dengan project ID untuk project host fleet.

Fleet - konsol

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

1. Buka halaman Rollout Sequencing di konsol Google Cloud.

   Buka Urutan Peluncuran

2. Klik Create rollout sequence.

3. Di panel Create a rollout sequence, pilih dua fleet pertama dalam urutan:

   1. Di bagian Fleet 1, pilih fleet pertama dalam urutan.
   2. Di bagian Waktu berdiam untuk fleet upstream, tetapkan waktu berdiam untuk fleet pertama menggunakan kolom Hari, Jam, dan Menit.
   3. Di bagian Fleet 2, pilih fleet kedua dalam urutan.
   4. Klik Create.

4. Opsional: Jika Anda ingin menggunakan tiga fleet dalam urutan peluncuran ini, lakukan langkah-langkah tambahan berikut:

   1. Di Grafik peluncuran, klik elemen untuk grup perangkat kedua.
   2. Klik Tambahkan grup downstream.
   3. Di bagian Waktu berdiam untuk fleet upstream, tetapkan waktu berdiam untuk fleet kedua menggunakan kolom Hari, Jam, dan Menit.
   4. Di bagian Next fleet in the sequence, pilih fleet ketiga dalam urutan.
   5. Klik Simpan.

Fleet - Terraform

Bagian ini menunjukkan cara membuat urutan berbasis fleet menggunakan Terraform. Anda juga dapat menggunakan referensi ini untuk memperbarui urutan. Untuk mempelajari lebih lanjut, lihat dokumentasi referensi untuk google_gke_hub_feature.

Untuk setiap perintah berikut, ganti SOAK_TIME dengan waktu berdiam untuk fleet yang Anda perbarui.

Buat urutan peluncuran:

1. Tambahkan blok berikut ke konfigurasi Terraform untuk menetapkan waktu berdiam untuk fleet pertama dalam urutan:

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = []
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "FIRST_FLEET_PROJECT_ID"
   }
   

   Ganti FIRST_FLEET_PROJECT_ID dengan project ID untuk project host fleet.

2. Tambahkan blok berikut ke konfigurasi Terraform untuk menetapkan fleet upstream dan waktu berdiam untuk fleet kedua dalam urutan:

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = ["FIRST_FLEET_PROJECT_ID"]
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "SECOND_FLEET_PROJECT_ID"
   }
   

   Ganti FIRST_FLEET_PROJECT_ID dengan project ID untuk project host fleet pertama, dan SECOND_FLEET_PROJECT_ID dengan project ID untuk project host fleet.

3. Opsional: Jika Anda ingin menggunakan tiga fleet dalam sebuah urutan peluncuran, tambahkan blok berikut ke konfigurasi Terraform untuk menetapkan fleet upstream untuk fleet dalam urutan tersebut:

   resource "google_gke_hub_feature" "feature" {
     name = "clusterupgrade"
     location = "global"
     spec {
       clusterupgrade {
         upstream_fleets = ["SECOND_FLEET_PROJECT_ID"]
         post_conditions {
           soaking = "SOAK_TIME"
         }
       }
     }
     project = "THIRD_FLEET_PROJECT_ID"
   }
   

   Ganti SECOND_FLEET_PROJECT_ID dengan project ID untuk project host fleet kedua, dan THIRD_FLEET_PROJECT_ID dengan project ID untuk project host fleet.

Tim - gcloud

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Anda dapat menetapkan properti ini saat membuat atau memperbarui cakupan tim. Petunjuk berikut menggunakan perintah gcloud container fleet scopes update, tetapi Anda dapat menetapkan properti yang sama saat membuat cakupan tim dengan perintah gcloud container fleet scopes create.

Untuk setiap perintah ini, ganti kode berikut:

• Variabel dengan nama cakupan tim yang terkait atau ID project host fleet cakupan tim.
• SOAK_TIME dengan waktu berdiam untuk cakupan tim yang Anda perbarui.

Buat urutan peluncuran:

1. Tetapkan waktu berdiam untuk cakupan pertama dalam urutan:

   gcloud container fleet scopes update projects/FIRST_SCOPE_PROJECT_ID/locations/global/scopes/FIRST_SCOPE_NAME \
       --default-upgrade-soaking=SOAK_TIME \
       --project=FIRST_SCOPE_PROJECT_ID
   

2. Tetapkan cakupan upstream dan waktu berdiam untuk cakupan kedua dalam urutan:

   gcloud container fleet scopes update projects/SECOND_SCOPE_PROJECT_ID/locations/global/scopes/SECOND_SCOPE_NAME \
       --upstream-scope=projects/FIRST_SCOPE_PROJECT_ID/locations/global/scopes/FIRST_SCOPE_NAME \
       --default-upgrade-soaking=SOAK_TIME \
       --project=SECOND_SCOPE_PROJECT_ID
   

3. Opsional: Jika Anda ingin menggunakan tiga cakupan tim dalam sebuah urutan peluncuran, tetapkan cakupan upstream untuk cakupan ketiga dalam urutan itu:

   Catatan: Anda harus menetapkan waktu berdiam untuk setiap grup, termasuk grup terakhir dalam sebuah urutan peluncuran.

   gcloud container fleet scopes update projects/THIRD_SCOPE_PROJECT_ID/locations/global/scopes/THIRD_SCOPE_NAME \
       --upstream-scope=projects/SECOND_SCOPE_PROJECT/locations/global/scopes/SECOND_SCOPE_NAME \
       --default-upgrade-soaking=SOAK_TIME \
       --project=THIRD_SCOPE_PROJECT_ID
   

Memeriksa status urutan peluncuran

Anda dapat memeriksa status urutan peluncuran dengan salah satu metode berikut:

• Pantau representasi visual urutan peluncuran di konsol Google Cloud (Pratinjau, khusus urutan peluncuran berbasis fleet).
• Gunakan gcloud CLI atau GKE Hub API untuk memeriksa status urutan peluncuran.

Memantau urutan peluncuran di konsol Google Cloud

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Catatan: Di konsol Google Cloud, Anda hanya dapat membuat, melihat, dan mengedit urutan peluncuran berbasis armada, bukan urutan peluncuran berbasis tim.

1. Buka halaman Rollout Sequencing di konsol Google Cloud.

   Buka Urutan Peluncuran

2. Lihat urutan di bagian Memantau urutan peluncuran. Jika Anda tidak melihat urutan peluncuran, beralihlah ke urutan peluncuran yang berbeda, atau buat urutan peluncuran jika Anda belum melakukannya.

Cara menggunakan konsol untuk memantau urutan peluncuran

Di halaman ini, Anda dapat melihat urutan peluncuran yang terkait dengan fleet project Anda. Anda dapat melakukan hal berikut untuk melihat progres urutan peluncuran:

• Lihat seluruh urutan peluncuran, atau lihat status setiap fleet dan cluster dalam fleet tersebut, serta waktu tunggu antara fleet. Anda juga dapat melihat urutan yang tidak memiliki upgrade aktif, jika ingin memeriksa konfigurasi urutan.
• Filter menurut jenis upgrade (upgrade node atau panel kontrol) dan versi tertentu (misalnya, 1.31.6-gke.500).

Anda dapat memantau seluruh urutan peluncuran secara visual saat GKE mengupgrade semua cluster dalam urutan, yang memenuhi syarat untuk versi baru di seluruh lingkungan sebelum mengupgrade cluster lingkungan produksi. Saat memantau, Anda dapat mengelola urutan peluncuran dengan gcloud CLI, melakukan perubahan sesuai kebutuhan.

Beralih ke urutan peluncuran yang berbeda

Halaman ini menampilkan urutan peluncuran berbasis fleet jika project aktif di konsol Google Cloud adalah project host fleet untuk fleet yang terdaftar dalam urutan peluncuran.

Jika Anda ingin melihat urutan peluncuran yang berbeda, pilih project host fleet yang terkait dengan urutan peluncuran yang berbeda dari pemilih project di bagian atas halaman.

Menggunakan gcloud CLI

Gunakan perintah ini di bagian berikut untuk memeriksa progres upgrade dalam sebuah urutan peluncuran. Untuk mempelajari lebih lanjut detail yang tersedia, lihat Informasi status untuk urutan peluncuran

Untuk menjalankan perintah ini, pastikan Anda memiliki izin yang diperlukan untuk setiap project host fleet. Misalnya, jika urutan memiliki cakupan lintas project di fleet berbeda, Anda memerlukan izin di setiap project untuk menjelaskan urutan tersebut.

Untuk perintah berikut, jika Anda hanya memerlukan informasi tentang satu fleet atau cakupan dalam urutan itu, ganti flag --show-linked-cluster-upgrade dengan --show-cluster-upgrade.

Fleet

Periksa status urutan peluncuran berbasis fleet:

gcloud container fleet clusterupgrade describe \
    --show-linked-cluster-upgrade --project=FLEET_PROJECT_ID

Ganti FLEET_PROJECT_ID dengan project ID dari project host untuk fleet apa pun dalam urutan itu.

Baca referensi gcloud container fleet clusterupgrade describe untuk mengetahui daftar lengkap flag.

Tim

Periksa status urutan peluncuran berbasis tim:

gcloud container fleet scopes describe SCOPE_NAME \
    --show-linked-cluster-upgrade
    --project=SCOPE_PROJECT_ID

Ganti SCOPE_NAME dengan nama cakupan tim apa pun dalam urutan peluncuran itu, dan SCOPE_PROJECT_ID dengan project ID untuk cakupan tim ini.

Baca referensi gcloud container fleet scopes describe untuk mengetahui daftar lengkap flag.

Untuk melihat status cluster individual dalam cakupan tim atau fleet, jalankan perintah berikut di project host fleet dan lihat bagian membershipStates:

gcloud container fleet features describe clusterupgrade

Informasi status untuk urutan peluncuran

Saat memeriksa status peluncuran versi, Anda dapat melihat progres setiap grup dan cluster dalam grup tersebut.

Lihat tabel berikut untuk mengetahui status potensial cluster atau grup:

Status	Untuk satu cluster	Untuk grup (cakupan tim atau armada)
INELIGIBLE	Cluster ini tidak memenuhi syarat untuk upgrade ini	Satu atau beberapa cluster dalam grup ini tidak memenuhi syarat untuk upgrade ini.
PENDING	Upgrade belum dimulai atau upgrade sedang berlangsung untuk cluster ini.	Upgrade belum dimulai untuk cluster mana pun dalam grup ini.
IN_PROGRESS	T/A	Upgrade telah dimulai di setidaknya satu cluster, tetapi belum selesai untuk semua cluster.
SOAKING	Upgrade telah selesai di cluster ini, tetapi waktu berdiam belum habis.	Upgrade telah selesai di semua cluster, tetapi waktu berdiam belum habis.
FORCED_SOAKING	Upgrade memerlukan waktu lebih lama daripada waktu upgrade maksimum (30 hari) dan oleh karena itu kita memaksanya untuk memasuki fase berdiam. Upgrade masih dapat dilanjutkan di cluster.	Upgrade memerlukan waktu lebih lama daripada waktu upgrade maksimum (30 hari) dan oleh karena itu kita memaksanya untuk memasuki fase berdiam. Upgrade masih dapat dilanjutkan di cluster.
COMPLETE	Upgrade dianggap "selesai", yang berarti upgrade telah menyelesaikan waktu berdiam di cluster ini.	Upgrade dianggap "selesai" dan siap digunakan oleh grup downstream, yang berarti upgrade telah menyelesaikan waktu berdiam.

Dalam output perintah ini, atribut clusterUpgrade(s).spec dan clusterUpgrade(s).state berisi informasi tambahan tentang upgrade cluster seperti waktu berdiam, pengabaian upgrade cluster, dan status upgrade.

Mengelola urutan peluncuran

Anda dapat mengontrol upgrade cluster otomatis dengan urutan peluncuran dalam beberapa cara, seperti yang dijelaskan di bagian berikut.

Mengubah waktu berdiam untuk grup

Anda dapat mengubah waktu berdiam default untuk grup atau mengubah waktu berdiam saat grup tersebut diupgrade ke versi tertentu. Durasi maksimumnya adalah 30 hari.

Memperbarui waktu berdiam default

Anda dapat memperbarui waktu perendaman default di konsol Google Cloud (khusus Pratinjau, urutan peluncuran berbasis fleet) atau dengan gcloud CLI.

Catatan: Di konsol Google Cloud, Anda hanya dapat membuat, melihat, dan mengedit urutan peluncuran berbasis armada, bukan urutan peluncuran berbasis tim.

gcloud

Untuk mengubah waktu berdiam default untuk sebuah grup, gunakan perintah gcloud CLI dari petunjuk untuk Membuat urutan peluncuran dengan menghapus flag untuk menetapkan grup upstream.

Fleet - konsol

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

1. Buka halaman Rollout Sequencing di konsol Google Cloud.

   Buka Urutan Peluncuran

2. Lihat urutan di bagian Memantau urutan peluncuran. Jika Anda tidak melihat urutan peluncuran, beralihlah ke urutan peluncuran yang berbeda, atau buat urutan peluncuran jika Anda belum melakukannya.

3. Di Grafik peluncuran, klik elemen Waktu tunggu setelah elemen armada tempat Anda ingin memperbarui waktu tunggu.

4. Klik Edit waktu perendaman.

5. Di bagian Set a new soak time, masukkan waktu perendaman baru menggunakan kolom Days, Hours, dan Minutes.

6. Untuk menyimpan setelan, klik Save.

Mengabaikan waktu berdiam default

Anda dapat mengubah waktu berdiam untuk peluncuran versi tertentu agar berbeda dengan waktu berdiam default untuk grup. Misalnya, jika Anda telah memenuhi syarat untuk sebuah versi baru dan siap memulai upgrade di grup berikutnya, Anda dapat menetapkan waktu berdiam ke nol. Anda juga dapat menggunakannya jika menghendaki lebih banyak waktu daripada waktu berdiam default untuk memenuhi syarat versi tertentu.

Karena waktu berdiam ditetapkan per grup, jika Anda ingin mengabaikan waktu berdiam untuk grup lain dalam urutan ini, perbarui menggunakan perintah ini juga dengan mengganti nama fleet atau cakupan, bergantung pada jenis urutan.

Untuk petunjuk di bagian ini, ganti variabel berikut:

• SOAK_TIME: waktu berdiam yang akan digunakan selain waktu default (misalnya, "0d" jika Anda ingin melewati waktu berdiam untuk satu peluncuran versi).
• UPGRADE_NAME: jenis upgrade, baik k8s_control_plane untuk upgrade bidang kontrol atau k8s_node untuk upgrade node.

• VERSION: versi GKE tempat Anda ingin mengganti waktu berdiam default setelah versi (misalnya, 1.25.2-gke.400) diluncurkan ke grup ini.

Fleets - gcloud

Jalankan perintah ini di project host dari fleet tempat Anda ingin mengabaikan waktu berdiam yang digunakan untuk peluncuran versi dari versi tertentu.

Mengubah waktu berdiam fleet:

gcloud container fleet clusterupgrade update
    --add-upgrade-soaking-override=SOAK_TIME \
    --upgrade-selector=name=UPGRADE_NAME,version=VERSION

Fleet - Terraform

Tambahkan blok gke_upgrades_overrides berikut ke konfigurasi Terraform Anda dalam blok clusterupgrade untuk mengganti waktu berdiam yang digunakan untuk peluncuran versi dari versi tertentu:

gke_upgrade_overrides {
    upgrade {
      name = "UPGRADE_NAME"
      version = "VERSION"
    }
    post_conditions {
      soaking = "SOAK_TIME"
    }
  }

Tim - gcloud

Jalankan perintah ini di project host dari fleet cakupan tim. Ganti SCOPE_NAME dengan nama cakupan tim yang ingin Anda ganti waktu berdiamnya yang digunakan untuk peluncuran versi dari sebuah versi tertentu.

Mengubah waktu berdiam cakupan tim:

gcloud container fleet scopes update SCOPE_NAME \
    --add-upgrade-soaking-override=SOAK_TIME \
    --upgrade-selector=name=UPGRADE_NAME,version=VERSION

Memperbarui grup dalam urutan peluncuran

Anda dapat memperbarui urutan peluncuran yang ada untuk menambahkan, menghapus, atau mengubah urutan grup dalam urutan. Untuk membuat perubahan ini, perbarui pengaitan antar-grup.

Anda dapat melakukan langkah-langkah ini di konsol Google Cloud (khusus Pratinjau, urutan deployment berbasis fleet) atau dengan gcloud CLI.

Catatan: Di konsol Google Cloud, Anda hanya dapat membuat, melihat, dan mengedit urutan peluncuran berbasis armada, bukan urutan peluncuran berbasis tim.

Fleets - gcloud

Gunakan perintah gcloud container fleet clusterupgrade update dengan flag --upstream-fleet untuk menambahkan atau mengubah fleet upstream. Gunakan flag --reset-upstream-fleet untuk menghapus fleet upstream.

Anda dapat melakukan tindakan seperti berikut:

• Tambahkan fleet lain ke awal urutan peluncuran dengan menambahkan fleet upstream ke fleet pertama dalam urutan.
• Ubah urutan fleet dalam urutan peluncuran dengan mengubah asosiasi fleet upstream.
• Hapus fleet pertama dalam urutan peluncuran dengan menghapus fleet upstream dari fleet kedua.

Fleet - konsol

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

1. Buka halaman Rollout Sequencing di konsol Google Cloud.

   Buka Urutan Peluncuran

2. Lihat urutan di bagian Memantau urutan peluncuran. Jika Anda tidak melihat urutan peluncuran, beralihlah ke urutan peluncuran yang berbeda, atau buat urutan peluncuran jika Anda belum melakukannya.

3. Di Grafik peluncuran, klik elemen untuk grup yang ada dalam urutan. Setelah mengklik elemen tersebut, Anda dapat melakukan beberapa tindakan berikut untuk melakukan perubahan:

   • Klik Tambahkan grup downstream.
   • Klik Tambahkan fleet upstream.
   • Klik Hapus armada.

Anda dapat melakukan tindakan seperti berikut:

• Tambahkan fleet lain ke akhir urutan peluncuran dengan menambahkan fleet downstream ke fleet terakhir dalam urutan.
• Tambahkan fleet lain ke awal urutan peluncuran dengan menambahkan fleet upstream ke fleet pertama dalam urutan.
• Ubah urutan fleet dalam urutan peluncuran dengan menghapus fleet, lalu menambahkan kembali fleet dengan fleet upstream atau downstream yang berbeda.
• Hapus fleet pertama dalam urutan peluncuran.
• Hapus fleet terakhir dalam urutan peluncuran.
• Hapus fleet tengah dalam urutan peluncuran, setelah menghapus fleet pertama atau terakhir dalam urutan.

Tim - gcloud

Gunakan perintah gcloud container fleet scopes update dengan flag --upstream-scope untuk menambahkan atau mengubah cakupan tim upstream. Gunakan flag --reset-upstream-scope untuk menghapus cakupan tim upstream.

Anda dapat melakukan tindakan seperti berikut:

• Tambahkan cakupan tim lain ke awal urutan peluncuran dengan menambahkan cakupan tim upstream ke cakupan tim pertama dalam urutan.
• Ubah urutan cakupan tim dalam urutan peluncuran dengan mengubah asosiasi cakupan tim upstream.
• Hapus cakupan tim pertama dalam urutan peluncuran dengan menghapus cakupan tim upstream dari cakupan tim kedua.

Menunda penyelesaian peluncuran versi grup

Jika tidak ingin grup menyelesaikan peluncuran cluster versi barunya untuk sementara waktu, Anda dapat menambahkan pengecualian pemeliharaan ke cluster mana pun yang belum diupgrade ke versi target. Tindakan ini akan menjeda grup sehingga tidak masuk ke waktu berdiam atau grup downstream-nya selama 30 hari. Setelah 30 hari, grup akan mulai memasuki waktu berdiam.

Anda juga dapat mengubah waktu berdiam untuk grup tersebut menjadi 30 hari untuk memaksimalkan durasi tunggu urutan peluncuran sebelum melanjutkan ke grup berikutnya.

Jika perlu menunda upgrade lebih lanjut yang dimulai untuk grup berikutnya, Anda dapat menggunakan pengecualian pemeliharaan untuk cluster di grup berikutnya.

Beralih antara urutan peluncuran berbasis fleet dan berbasis tim

Anda dapat beralih dari urutan berbasis fleet ke urutan berbasis tim, atau urutan berbasis tim ke urutan berbasis fleet. Petunjuk ini mengasumsikan bahwa Anda mentransfer cluster di antara urutan yang diatur seperti yang diilustrasikan dalam contoh diagram.

Fleet ke tim

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk mengubah cluster dari urutan peluncuran berbasis fleet ke urutan peluncuran berbasis tim, lakukan langkah-langkah berikut:

1. Konfigurasi pengecualian pemeliharaan untuk semua cluster di setiap fleet guna mencegah upgrade selagi Anda memodifikasi konfigurasi.
2. Pastikan Anda telah mengaktifkan GKE Enterprise di project host fleet Anda.
3. Di setiap fleet, buat satu atau beberapa cakupan tim untuk membagi lagi grup cluster dalam fleet tersebut.
4. Buat satu atau beberapa urutan peluncuran antara cakupan tim yang cocok di setiap fleet.
5. Tambahkan cluster Anda ke cakupan tim barunya.
6. Hapus pengecualian pemeliharaan yang Anda konfigurasi untuk perubahan ini.

Tim ke fleet

Untuk mengubah cluster dari urutan peluncuran berbasis tim ke urutan peluncuran berbasis fleet, lakukan langkah-langkah berikut:

1. Konfigurasi pengecualian pemeliharaan untuk semua cluster di setiap fleet guna mencegah upgrade selagi Anda memodifikasi konfigurasi.
2. Buat urutan peluncuran antar-fleet Anda.
3. Hapus cluster Anda dari cakupan timnya. Sekarang cluster ini hanya terdaftar ke fleet terkait dalam cakupan yang, pada langkah sebelumnya, Anda ikuti dalam urutan peluncuran.
4. Hapus cakupan tim.
5. Hapus pengecualian pemeliharaan yang Anda konfigurasi untuk perubahan ini.

Menghapus urutan

Untuk menghapus urutan, hapus pengaitan upstream untuk grup kedua dan ketiga (jika urutan peluncuran terdiri atas tiga grup).

Anda dapat melakukan langkah-langkah ini di konsol Google Cloud (khusus Pratinjau, urutan deployment berbasis fleet) atau dengan gcloud CLI.

Catatan: Di konsol Google Cloud, Anda hanya dapat membuat, melihat, dan mengedit urutan peluncuran berbasis armada, bukan urutan peluncuran berbasis tim.

Fleets - gcloud

Jalankan perintah berikut di project host fleet dari fleet kedua dan ketiga dalam urutan peluncuran:

gcloud container fleet clusterupgrade update --reset-upstream-fleet

Fleet - konsol

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

1. Buka halaman Rollout Sequencing di konsol Google Cloud.

   Buka Urutan Peluncuran

2. Lihat urutan di bagian Memantau urutan peluncuran. Jika Anda tidak melihat urutan peluncuran, beralihlah ke urutan peluncuran yang berbeda, atau buat urutan peluncuran jika Anda belum melakukannya.

3. Di Grafik peluncuran, klik elemen untuk grup perangkat ketiga.

4. Klik Hapus armada.

5. Untuk menghapus armada, klik Hapus.

6. Ulangi tiga langkah sebelumnya untuk fleet kedua.

   Berhasil: Setelah Anda menghapus koneksi yang tersisa di antara fleet, Grafik peluncuran akan terus menampilkan satu fleet tanpa koneksi apa pun. Jika statusnya adalah ini, Anda telah berhasil menghapus urutan peluncuran.

Tim - gcloud

Jalankan perintah berikut di project host fleet dari cakupan tim kedua dan ketiga dalam urutan peluncuran:

gcloud container fleet scopes update SCOPE_NAME --reset-upstream-scope

Ganti SCOPE_NAME dengan nama cakupan kedua dan ketiga.

Pemecahan masalah

Memecahkan masalah kelayakan peluncuran

Jika semua cluster dalam urutan peluncuran tidak memiliki target upgrade yang sama, GKE mungkin tidak dapat melanjutkan upgrade cluster. Upgrade otomatis tidak dapat dilanjutkan jika grup upstream tidak memenuhi syarat satu target upgrade untuk diteruskan ke grup downstream. Upgrade otomatis juga tidak dapat dilanjutkan jika cluster di grup upstream memenuhi syarat target upgrade yang tidak valid untuk cluster di grup downstream.

Untuk memeriksa apakah urutan peluncuran Anda memiliki masalah kelayakan peluncuran atau tidak, periksa status urutan peluncuran. Jika grup tidak memenuhi syarat, ikuti petunjuk untuk melihat status masing-masing cluster di sebuah grup.

Untuk segera melanjutkan upgrade cluster, hapus semua cluster yang berstatus INELIGIBLE dengan mengikuti petunjuk dalam Melanjutkan peluncuran yang memenuhi syarat sebagian.

Memperbaiki kelayakan di sebuah grup

Di sebuah grup, jika sebuah cluster tidak memenuhi syarat karena menggunakan versi lebih lama (misalnya sebagian besar cluster di grup tersebut diupgrade dari 1.23 ke 1.24 dan cluster menggunakan versi 1.22), Anda dapat mengupgrade cluster secara manual ke versi 1.24 untuk mengatasi perbedaan versi.

Di sebuah grup, jika sebuah cluster tidak memenuhi syarat karena menggunakan versi yang lebih baru (misalnya sebagian besar cluster di grup tersebut diupgrade dari 1.23 ke 1.24 dan cluster menggunakan versi 1.25), Anda tidak dapat mendowngrade cluster secara manual untuk menyelesaikan perbedaan versi dan harus menghapus cluster tersebut.

Memperbaiki kelayakan antargrup

Antara grup, jika ada ketidakcocokan dalam target upgrade di mana grup downstream menggunakan versi yang lebih baru (misalnya grup upstream diupgrade dari 1.23 ke 1.24 dan cluster dalam grup downstream menggunakan versi 1.25), Anda dapat mengupgrade cluster di grup upstream secara manual ke versi 1.25 untuk memastikan upgrade dapat dilanjutkan.

Antara grup, jika ada ketidakcocokan dalam target upgrade di mana grup downstream menggunakan versi yang lebih lama (misalnya grup upstream diupgrade dari 1.24 ke 1.25 dan cluster dalam grup downstream menggunakan versi 1.23), Anda dapat mengupgrade cluster di grup downstream secara manual ke 1.24 atau 1.25 untuk memastikan upgrade dapat dilanjutkan.

Melanjutkan peluncuran yang memenuhi syarat sebagian

Jika upgrade cluster di sebuah grup tidak dapat diselesaikan karena ada masalah terkait kelayakan peluncuran (misalnya perbedaan versi dalam grup), Anda dapat menghapus cluster yang tidak memenuhi syarat untuk target upgrade grup dari suatu grup untuk menyelesaikan peluncuran versi dan memulai waktu berdiam atau beralih ke grup berikutnya dalam urutan peluncuran itu. Anda juga dapat menghapus cluster dari grup karena alasan lain, misalnya jika penggunaan cluster ini tidak lagi terkait dengan cluster lain dalam grup tersebut.

Ikuti petunjuk untuk membatalkan pendaftaran cluster dari fleet atau menghapus cluster dari cakupan tim, bergantung pada jenis urutan peluncuran.

Setelah Anda menghapus semua cluster yang mencegah diselesaikannya peluncuran versi di sebuah grup, peluncuran versi di grup tersebut akan dapat diselesaikan. Konfirmasi hal ini dengan mengikuti petunjuk untuk Memeriksa status peluncuran versi.

Langkah berikutnya

• Tentang upgrade cluster dengan urutan peluncuran