Mengonfigurasi strategi upgrade node

Standard

---

Sebagai administrator platform, Anda dapat mengonfigurasi strategi upgrade node untuk menyesuaikan cara GKE mengupgrade node di cluster Google Kubernetes Engine (GKE) Anda. Untuk mempelajari lebih lanjut strategi upgrade node, lihat Strategi upgrade node.

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 menyetel lokasi default, Anda dapat menghindari error di gcloud CLI yang seperti ini: One of [--zone, --region] must be supplied: Please specify location.

Mengonfigurasi strategi upgrade node

Saat mengonfigurasi node pool cluster, Anda dapat memilih dan mengonfigurasi salah satu strategi upgrade node yang didukung, yaitu lonjakan atau biru-hijau. Dengan strategi upgrade ini, Anda dapat mengoptimalkan proses upgrade node pool berdasarkan kebutuhan lingkungan cluster.

Catatan: Secara default, node pool menggunakan strategi upgrade lonjakan dengan maxSurge=1 dan maxUnavailable=0.

Mengonfigurasi upgrade lonjakan

Upgrade lonjakan memungkinkan Anda mengubah jumlah upgrade GKE node pada satu waktu dan jumlah gangguan yang ditimbulkan upgrade pada workload Anda.

Flag max-surge-upgrade dan max-unavailable-upgrade ditentukan untuk setiap node pool. Untuk informasi selengkapnya tentang cara memilih parameter yang tepat, buka Mengoptimalkan konfigurasi upgrade lonjakan.

Catatan: Semua node pool baru akan otomatis dikonfigurasi untuk menggunakan upgrade lonjakan maxSurge=1 maxUnavailable=0. Untuk menyesuaikan konfigurasi Anda, lihat Mengoptimalkan konfigurasi upgrade lonjakan.

Peringatan: Untuk node yang menggunakan Spot VM, nilai upgrade lonjakan diabaikan karena tidak ada jaminan ketersediaan. Selama upgrade, node lama langsung dikosongkan tanpa menunggu node lonjakan yang menggunakan Spot VM siap.

Anda dapat mengubah setelan ini saat membuat atau mengupdate cluster atau node pool.

Variabel berikut digunakan dalam perintah yang tercantum di bawah ini:

• CLUSTER_NAME: nama cluster untuk node pool.
• COMPUTE_ZONE: zona untuk cluster.
• NODE_POOL_NAME: nama node pool.
• NUMBER_NODES: jumlah node dalam node pool di setiap zona cluster.
• SURGE_NODES: jumlah node tambahan (lonjakan) yang akan dibuat pada setiap upgrade node pool.
• UNAVAILABLE_NODES: jumlah node yang tidak tersedia secara bersamaan setiap kali node pool diupgrade.

Membuat cluster dengan parameter lonjakan khusus

Guna membuat cluster dengan setelan khusus untuk upgrade lonjakan, gunakan flag max-surge-upgrade dan max-unavailable-upgrade.

gcloud container clusters create CLUSTER_NAME \
    --max-surge-upgrade=SURGE_NODES --max-unavailable-upgrade=UNAVAILABLE_NODES

Membuat cluster dengan upgrade lonjakan dinonaktifkan

Untuk membuat cluster tanpa upgrade lonjakan, tetapkan nilai untuk flag max-surge-upgrade ke 0.

gcloud container clusters create CLUSTER_NAME \
    --max-surge-upgrade=0 --max-unavailable-upgrade=1

Membuat node pool dengan parameter lonjakan khusus

Guna membuat node pool di cluster yang sudah ada dengan setelan khusus untuk upgrade lonjakan, gunakan flag max-surge-upgrade dan max-unavailable-upgrade.

gcloud container node-pools create NODE_POOL_NAME \
    --num-nodes=NUMBER_NODES --cluster=CLUSTER_NAME \
    --max-surge-upgrade=SURGE_NODES --max-unavailable-upgrade=UNAVAILABLE_NODES

Mengubah setelan upgrade lonjakan untuk node pool yang sudah ada

Untuk mengupdate setelan upgrade node pool yang sudah ada, gunakan flag max-surge-upgrade dan max-unavailable-upgrade. Jika Anda menetapkan max-surge-upgrade ke jumlah yang lebih besar dari 0, GKE akan menghasilkan node lonjakan. Jika Anda menetapkan max-surge-upgrade ke 0, GKE tidak akan menghasilkan node lonjakan.

gcloud container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --max-surge-upgrade=SURGE_NODES --max-unavailable-upgrade=UNAVAILABLE_NODES

Memeriksa apakah upgrade lonjakan diaktifkan pada node pool

Untuk melihat apakah upgrade lonjakan diaktifkan pada node pool, gunakan gcloud untuk mendeskripsikan parameter cluster:

gcloud container node-pools describe NODE_POOL_NAME \
    --cluster=CLUSTER_NAME

Jika upgrade lonjakan diaktifkan pada node pool, strategi yang tercantum adalah SURGE.

Catatan: Meski tidak diperlukan untuk pembuatan ulang node, Resource Compute Engine tambahan diperlukan untuk node upgrade lonjakan. Alokasi resource tunduk pada kuota Compute Engine. Bergantung pada konfigurasi Anda, kuota ini dapat membatasi jumlah upgrade paralel atau bahkan menyebabkan kegagalan upgrade. Jika Anda tidak memiliki kuota atau reservasi tambahan untuk node di node pool, jangan gunakan maxSurge.

Untuk informasi selengkapnya tentang kuota, buka Memastikan resource untuk upgrade node.

Mengonfigurasi upgrade biru-hijau

Dengan upgrade node pool biru-hijau, Anda dapat mengontrol:

• BATCH_NODE_COUNT atau BATCH_PERCENT: ukuran batch node yang dikosongkan GKE pada satu waktu, yang berarti Pod dihapus dari node. Jumlah defaultnya adalah BATCH_NODE_COUNT=1 Jika salah satu setelan ini disetel ke 0, GKE akan melewati fase ini dan melanjutkan ke fase Rendam node pool.
• BATCH_SOAK_DURATION: waktu di antara setiap batch node yang dikosongkan.
• NODE_POOL_SOAK_DURATION: jumlah waktu tunggu bagi Anda untuk memvalidasi workload pada konfigurasi node baru.

Untuk mempelajari lebih lanjut cara kerja fase upgrade biru-hijau, lihat Tahapan upgrade biru-hijau.

Variabel berikut digunakan dalam perintah yang tercantum di bagian berikutnya:

• CLUSTER_NAME: nama cluster untuk node pool.
• NODE_POOL_NAME: nama node pool.
• NUMBER_NODES: jumlah node dalam node pool di setiap zona cluster.
• BATCH_NODE_COUNT: jumlah node biru yang akan dikosongkan dalam batch selama fase pengosongan pool biru. Jumlah defaultnya adalah 1. Jika disetel ke 0, fase pengosongan blue pool akan dilewatkan.
• BATCH_PERCENT: persentase node biru yang akan dikosongkan dalam batch selama fase pengosongan pool biru, dinyatakan sebagai desimal antara 0 dan 1, inklusif. GKE akan membulatkan ke bawah ke node terdekat, ke nilai minimum 1 node, jika persentasenya bukan bilangan bulat node. Jika disetel ke 0, fase pengosongan blue pool akan dilewatkan.
• BATCH_SOAK_DURATION: durasi waktu tunggu dalam satuan detik setelah setiap pengosongan batch. Defaultnya adalah 0.
• NODE_POOL_SOAK_DURATION: durasi dalam detik untuk menunggu setelah menyelesaikan pengosongan semua batch. Default-nya adalah 3.600 detik.

Membuat node pool dengan strategi upgrade biru-hijau

Membuat node pool dengan parameter default upgrade biru-hijau

Untuk membuat node pool di cluster yang sudah ada menggunakan strategi upgrade biru-hijau dengan parameter default, gunakan perintah berikut:

gcloud container node-pools create NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --enable-blue-green-upgrade

Membuat node pool dengan upgrade biru-hijau menggunakan ukuran batch jumlah node absolut

Untuk membuat node pool dengan setelan upgrade biru-hijau kustom, gunakan flag parameter dengan perintah pembuatan node pool.

Perintah ini membuat node pool dengan konfigurasi biru-hijau kustom berikut, menggunakan jumlah node absolut untuk pengosongan batch:

• BATCH_NODE_COUNT = 2
• BATCH_SOAK_DURATION = 10 dtk
• NODE_POOL_SOAK_DURATION = 600 dtk

gcloud container node-pools create NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --enable-blue-green-upgrade \
    --standard-rollout-policy=batch-node-count=2,batch-soak-duration=10s \
    --node-pool-soak-duration=600s

Membuat node pool dengan upgrade biru-hijau menggunakan ukuran batch berbasis persentase

Perintah ini membuat node pool dengan konfigurasi biru-hijau kustom berikut, menggunakan persentase untuk pengosongan batch:

• BATCH_PERCENTAGE = 25% (dari ukuran node pool)
• BATCH_SOAK_DURATION = 10 dtk
• NODE_POOL_SOAK_DURATION = 1.800 dtk

gcloud container node-pools create NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --enable-blue-green-upgrade \
    --standard-rollout-policy=batch-percent=0.25,batch-soak-duration=10s \
    --node-pool-soak-duration=1800s

Mengupdate strategi upgrade biru-hijau node pool yang sudah ada

Mengupdate node pool dengan parameter default upgrade biru-hijau

Untuk mengupdate node pool yang sudah ada ke strategi upgrade biru-hijau, gunakan perintah berikut:

gcloud container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --enable-blue-green-upgrade

Mengupdate node pool dengan upgrade biru-hijau menggunakan ukuran batch jumlah node absolut

Untuk mengupdate node pool yang sudah ada menjadi strategi upgrade biru-hijau dengan setelan kustom, gunakan flag parameter dengan perintah pembuatan node pool.

Perintah ini mengupdate node pool agar menggunakan konfigurasi biru-hijau kustom berikut, menggunakan jumlah node absolut untuk pengosongan batch:

• BATCH_NODE_COUNT = 2
• BATCH_SOAK_DURATION = 10 dtk
• NODE_POOL_SOAK_DURATION = 600 dtk

gcloud container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --enable-blue-green-upgrade \
    --standard-rollout-policy=batch-node-count=2,batch-soak-duration=10s \
    --node-pool-soak-duration=600s

Mengupdate node pool dengan upgrade biru-hijau menggunakan ukuran batch berbasis persentase

Perintah ini membuat node pool dengan konfigurasi biru-hijau kustom berikut, menggunakan persentase untuk pengosongan batch:

• BATCH_PERCENTAGE = 25% (dari ukuran node pool)
• BATCH_SOAK_DURATION = 10 dtk
• NODE_POOL_SOAK_DURATION = 1.800 dtk

gcloud container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --enable-blue-green-upgrade \
    --standard-rollout-policy=batch-percent=0.25,batch-soak-duration=10s \
    --node-pool-soak-duration=1800s

Beralih kembali ke upgrade lonjakan

Anda dapat mengubah perilaku upgrade blue-green dengan setelan, dan mengontrol proses upgrade dengan perintah.

Namun, jika Anda ingin menggunakan upgrade lonjakan, jalankan perintah berikut untuk beralih kembali ke upgrade lonjakan:

gcloud container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --enable-surge-upgrade

Memeriksa setelan upgrade node pool

Untuk memeriksa setelan upgrade node pool saat ini, Anda dapat menggunakan perintah berikut untuk mendeskripsikan node pool:

gcloud container node-pools describe NODE_POOL_NAME \
    --cluster=CLUSTER_NAME

Cuplikan berikut adalah contoh output perintahnya. Kolom strategy menunjukkan strategi upgrade yang sedang digunakan: SURGE menunjukkan bahwa strategi upgrade lonjakan diaktifkan, dan BLUE_GREEN menunjukkan bahwa strategi upgrade biru-hijau diaktifkan.

upgradeSettings:
  blueGreenSettings:
    nodePoolSoakDuration: 1800s
    standardRolloutPolicy:
      batchNodeCount: 1
      batchSoakDuration: 10s
  strategy: BLUE_GREEN

Perintah ini juga menunjukkan fase saat ini dari upgrade biru-hijau yang sedang berlangsung. Pelajari lebih lanjut cara memeriksa setelan upgrade node pool.

Langkah selanjutnya

• Pelajari strategi upgrade node lebih lanjut.
• Pelajari cara mengupgrade node pool secara manual.