Container Service for Kubernetes:Upgrade kelompok node

Pertimbangan

• Persiapan

  • Proses upgrade kluster menggunakan yum untuk mengunduh paket perangkat lunak yang diperlukan. Jika Anda mengubah konfigurasi jaringan node secara manual atau menggunakan citra sistem operasi (OS) kustom, pastikan yum berfungsi dengan benar pada node tersebut. Jalankan yum makecache untuk memverifikasi.

  • ACK tidak memvalidasi citra OS kustom secara penuh dan tidak dapat menjamin keberhasilan upgrade citra tersebut.

  • Jika Anda mengubah konfigurasi kluster, misalnya mengaktifkan swap atau menggunakan metode non-standar seperti masuk ke node (Sesuaikan konfigurasi kubelet kelompok node) untuk mengubah konfigurasi kubelet atau runtime, proses upgrade kluster mungkin gagal atau menimpa konfigurasi kustom Anda.

  • Setelah meng-upgrade kluster ke versi 1.18, ACK mengonfigurasi Kebijakan pemesanan resource node secara default. Jika pemesanan resource tidak dikonfigurasi dan penggunaan resource node tinggi, Pod mungkin tidak terjadwal segera setelah dievakuasi. Cadangkan resource untuk node Anda dengan menjaga penggunaan CPU tetap di bawah 50% dan penggunaan memori di bawah 70%.

  • Pada kluster yang menjalankan versi 1.24 atau lebih lama, Pod yang hanya dikonfigurasi dengan startup probe akan memasuki status NotReady sesaat setelah kubelet di-restart. Terapkan workload dengan multiple replika di seluruh node agar ketersediaan Pod tetap terjaga selama restart node.

  • Pastikan setidaknya 20% kapasitas disk tetap kosong untuk mencegah evakuasi Pod akibat kapasitas disk yang tidak mencukupi selama upgrade.

• Batasan upgrade kelompok node

  • Upgrade kelompok node hanya mendukung operasi scale-out. Operasi scale-in tidak didukung.

  • Jika Anda memiliki worker node yang tidak terkelola dan tidak termasuk dalam kelompok node, lakukan migrasi. Untuk informasi selengkapnya, lihat Migrasi node yang tidak terkelola ke kelompok node.

  • Selama upgrade penggantian disk, ACK menginisialisasi ulang node berdasarkan konfigurasi kelompok node saat ini, termasuk metode login, label, taint, citra OS, dan versi runtime. Perbarui konfigurasi kelompok node seperti yang dijelaskan dalam Edit kelompok node. Perubahan yang dilakukan melalui metode lain akan ditimpa selama upgrade.

  • Jika Pod pada node mereferensikan HostPath yang mengarah ke sistem disk, data dalam direktori HostPath akan hilang setelah upgrade penggantian disk.

  • Saat meng-upgrade kelompok node pada kluster versi 1.31 atau lebih lama, proses tersebut juga meng-upgrade NVIDIA Device Plugin dan mereset semua konfigurasi non-standarnya.

• node scaling dan penjadwalan

  • Jika node scaling diaktifkan, ACK secara otomatis memperbarui cluster-autoscaler ke versi terbaru setelah upgrade kluster agar penskalaan tetap tersedia. Verifikasi bahwa cluster-autoscaler telah diperbarui. Untuk informasi selengkapnya, lihat Aktifkan penyesuaian otomatis node.

  • Selama upgrade kluster, node dengan Scaling Mode diatur ke Swift mungkin gagal di-upgrade karena dimatikan. Jika ada node yang belum di-upgrade karena Swift diaktifkan, hapus node tersebut secara manual.

• Jaringan dan ketersediaan layanan

  • Jika Pod mengakses Pod lain pada node yang sama melalui alamat SLB dari Service LoadBalancer, dan externalTrafficPolicy diatur ke Local, rotasi node mungkin menempatkan Pod pada node yang berbeda sehingga mengganggu konektivitas.

  • Selama upgrade penggantian disk, ACK mengosongkan node dan mengevakuasi Pod ke node lain yang tersedia dengan mematuhi Pod Disruption Budget (PDB). Untuk memastikan Ketersediaan tinggi, terapkan workload dengan multiple replika di seluruh node dan konfigurasikan PDB untuk layanan penting guna membatasi gangguan Pod secara bersamaan.

    Timeout default untuk mengosongkan node adalah 30 menit. Jika migrasi Pod tidak selesai dalam periode ini, ACK menghentikan upgrade untuk menjaga stabilitas layanan.

Fitur

Upgrade kelompok node menyediakan operasi berikut:

• Upgrade kubelet: Meng-upgrade kubelet pada setiap node ke versi control plane. Upgrade in-place digunakan secara default.

• Upgrade container runtime: Meng-upgrade container runtime pada node ketika versi runtime yang lebih baru tersedia.

  • Migrasi dari Docker ke containerd melakukan upgrade penggantian disk, yang menggantikan sistem disk pada setiap node dan menghapus semua data di dalamnya. Backup data sistem disk yang penting sebelum upgrade. Untuk informasi selengkapnya, lihat Migrasi container runtime node dari Docker ke containerd.

  • Kecuali untuk node ContainerOS, meng-upgrade containerd ke versi yang lebih baru menggunakan upgrade in-place secara default. ACK mengganti /etc/containerd/config.toml pada setiap node dengan versi yang disediakan oleh ACK.

    Penting

    • Node ContainerOS tidak mendukung upgrade containerd in-place. Gunakan upgrade penggantian disk. Untuk informasi selengkapnya, lihat Upgrade versi ContainerOS sebelum 3.4 ke versi terbaru.

    • Selama upgrade container runtime, probe Pod dan lifecycle hook mungkin gagal, serta Pod mungkin di-restart secara in-place.

  • Pada kluster yang menjalankan Kubernetes versi sebelum 1.24, meng-upgrade Docker menggunakan upgrade penggantian disk secara default dan menghapus semua data sistem disk. Backup data sistem disk yang penting sebelum upgrade.

Prosedur

1. Masuk ke Konsol ACK. Di panel navigasi kiri, klik Clusters.

2. Pada halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Nodes > Node Pools.

3. Pada halaman Node Pools, temukan kelompok node target, klik ikon di kolom Actions, lalu pilih Kubelet Update. Konfigurasikan parameter berikut.

   Parameter		Deskripsi
   Kubelet Update Information		Lihat versi kubelet saat ini dan pilih versi target.
   Runtime Update Information		Lihat versi container runtime saat ini dan pilih versi target. Migrasi dari Docker ke containerd melakukan upgrade penggantian disk, yang menggantikan sistem disk pada setiap node dan menghapus semua data di dalamnya. Untuk informasi selengkapnya, lihat Migrasi container runtime node dari Docker ke containerd. Kluster yang menjalankan Kubernetes 1.22 dengan containerd 1.6.34 terinstal tidak mendukung upgrade runtime.
   Update Nodes		Pilih node yang akan di-upgrade: semua atau tertentu.
   Metode upgrade		Pilih In-place Upgrade atau Upgrade by Replacing System Disk. Lihat Referensi: Upgrade in-place dan penggantian disk. In-place Upgrade: ACK memperbarui komponen yang diperlukan langsung pada node yang ada. Upgrade in-place tidak mengganti sistem disk atau menginisialisasi ulang node, dan data pada node tetap dipertahankan. Upgrade by Replacing System Disk: ACK menginisialisasi ulang node dengan mengganti sistem disknya. Atribut instans seperti nama, ID, dan alamat IP tetap tidak berubah, tetapi data sistem disk dihapus. Data disk yang terpasang tidak terpengaruh.
   Ignore Warnings		Apakah akan melanjutkan jika Pemeriksaan Awal melaporkan peringatan. Misalnya, pod menggunakan hostPath yang mengarah ke sistem disk.
   Batch Update Policy	Maximum Number of Nodes per Batch	Node di-upgrade secara bertahap hingga batas maksimum ini. Lihat Referensi: Upgrade in-place dan penggantian disk.
   	Automatic Pause Policy	Menentukan kapan upgrade dijeda secara otomatis.
   	Interval Between Batches	Mengatur interval antar-batch saat jeda otomatis dinonaktifkan. Nilai yang valid: 5 hingga 120 menit.
   	Auto Snapshot	Untuk mem-backup dan memulihkan data bisnis penting pada sistem disk node, buat snapshot sebelum meng-upgrade kelompok node. Snapshot dikenakan biaya (lihat Penagihan snapshot), dan kemajuan pembuatannya berubah secara dinamis. Setelah upgrade, hapus snapshot yang tidak diperlukan. Catatan Untuk upgrade penggantian disk, pertimbangkan untuk mengaktifkan pembuatan snapshot otomatis. Biaya snapshot berlaku. Untuk detail penagihan, lihat Penagihan snapshot.

4. Setelah mengonfigurasi parameter, klik Precheck. Jika Pemeriksaan Awal berhasil, ikuti instruksi di layar untuk memulai upgrade.

   Catatan

   Jika Pemeriksaan Awal gagal atau mengembalikan peringatan, lihat Perbaikan untuk item pemeriksaan yang gagal atau lihat Check Report untuk memecahkan masalah.

   Tindakan berikut tersedia selama upgrade:

   • Pause: Menempatkan kelompok node dalam status sementara. Hindari operasi kluster lainnya dan selesaikan upgrade segera. Upgrade yang dijeda lebih dari tujuh hari akan dihentikan secara otomatis, serta event dan log terkait akan dihapus.

     Versi kubelet dan container runtime pada node yang telah di-upgrade tidak dapat dikembalikan (rollback).

   • Cancel: Membatalkan upgrade. Setelah Anda mengklik Cancel, versi kubelet dan container runtime pada node yang telah di-upgrade tidak dapat dikembalikan.

   Untuk memverifikasi upgrade, buka halaman Nodes, klik nama node, dan verifikasi bahwa versi kubelet dan container runtime pada tab Basic Information sudah sesuai harapan.

Referensi: Upgrade in-place dan penggantian disk

FAQ

echo 2 > /proc/sys/vm/drop_caches

Referensi

• Aktifkan upgrade kluster otomatis untuk mengurangi beban maintenance.

• Untuk riwayat rilis containerd, lihat catatan rilis runtime containerd.

• Kelompok node terkelola ACK mendukung patching CVE OS otomatis.

• Mulai Kubernetes 1.24, Docker bukan lagi container runtime yang didukung. Anda harus memigrasikan container runtime node dari Docker ke containerd. Lihat Migrasi container runtime node dari Docker ke containerd.

  Docker dan containerd menggunakan alat baris perintah yang berbeda. Lihat Perbandingan perintah umum untuk Docker dan containerd.

• Jaga agar citra OS tetap diperbarui. Lihat Ubah sistem operasi.