Tambahkan instance ECS yang ada sebagai node pekerja ACK - Container Service for Kubernetes

Tambahkan instance ECS yang ada sebagai node pekerja atau tambahkan kembali node yang sebelumnya dihapus untuk menggunakan kembali sumber daya komputasi tanpa mengganggu workload.

ACK mendukung mode otomatis dan manual untuk menambahkan node. Metode penagihan dan tipe instans tetap tidak berubah setelah Anda menambahkan instans tersebut.

Item

Mode Otomatis

Mode Manual

Reset OS

Mereset dan menginisialisasi OS berdasarkan konfigurasi kelompok node.

Disk sistem dilepas dan datanya hilang.
Snapshot manual dari disk sistem dipertahankan. Retensi snapshot otomatis bergantung pada apakah pengaturan Delete Automatic Snapshots While Releasing Disk diaktifkan.

Untuk mengonfigurasi pengaturan ini, login ke ECS console dan lihat Setel atribut 'Delete Automatic Snapshots While Releasing Disk'.
Disk data dipertahankan dan datanya disimpan, tetapi ID disk berubah.

Mempertahankan OS asli untuk fleksibilitas yang lebih besar.

Kasus penggunaan

Anda ingin konfigurasi instans sesuai dengan kelompok node untuk manajemen terstandarisasi.

Anda perlu mempertahankan OS instans atau konfigurasi tertentu.

Batasan

Pastikan lingkungan dan instans Anda memenuhi persyaratan berikut.

Kategori	Item	Deskripsi
Instans dan kelompok node	Kuota node kluster	Jumlah node kluster tidak boleh melebihi kuota. Untuk menambah kuota, buka Quota Center. Kuota node default untuk kluster ACK Basic adalah 10.
	Kepemilikan instans	Instans dan kluster harus berada dalam akun Alibaba Cloud, wilayah, dan VPC yang sama. Jika tidak, migrasikan instans tersebut atau buat instans atau kluster yang memenuhi persyaratan. Anda tidak dapat menambahkan instance ECS dari ujung lain koneksi peering VPC.
	Kepemilikan kluster	Anda tidak dapat menambahkan instans yang termasuk dalam kluster ACK lain. Pertama-tama hapus node tersebut dari kluster asal, lalu tambahkan ke kluster baru.
	Kepemilikan grup penskalaan (ESS)	Anda tidak dapat menambahkan instans yang termasuk dalam grup penskalaan lain. Pertama-tama hapus dari grup penskalaan tersebut.
	Tipe kelompok node	Anda tidak dapat menambahkan node yang ada ke kelompok node Mode Otomatis. Anda tidak dapat menambahkan node yang ada ke kelompok node yang memiliki auto scaling diaktifkan. Setelah Anda menambahkan node yang ada, Anda tidak dapat mengaktifkan auto scaling untuk kelompok node tersebut.
	Sistem operasi	Swap harus dinonaktifkan pada sistem operasi. Pada mode manual, Anda tidak dapat menambahkan instans yang menjalankan Windows atau ContainerOS. Lihat Sistem operasi.
	Tipe instans	Instans tersebut tidak boleh merupakan tipe instans ECS yang tidak didukung. Untuk instans GPU ECS Bare Metal (keluarga instans ECS ebmgn7 dan ebmgn7e), pembersihan Multi-Instance GPU (MIG) otomatis tidak didukung. Saat Anda menambahkan instans tersebut, pengaturan MIG-nya akan direset. Proses reset ini mungkin memakan waktu lama dan menyebabkan penambahan node otomatis gagal. Untuk troubleshooting, lihat Apa yang harus saya lakukan jika gagal menambahkan node instans bare metal?.
Jaringan	Akses API Server	Alamat IP instans harus berada dalam daftar putih akses API Server. Jika tidak, node tidak dapat berkomunikasi dengan lapisan kontrol. Lihat Konfigurasikan kontrol akses untuk API Server.
	Security group	Konsistensi tipe: Tipe security group instans (basic atau enterprise) harus sesuai dengan kelompok node. Kompatibilitas aturan: Security group instans harus mengizinkan akses ke titik akhir internal API Server pada port 6443, dan aturannya tidak boleh bertentangan dengan aturan security group kluster atau kelompok node. Temukan titik akhir internal API Server di tab Basic Information pada halaman Cluster Information. Kuota: Instans tidak dapat bergabung ke lebih banyak security group daripada yang diizinkan oleh kuota security group. Untuk mengubah tipe security group instans atau menambahkan instans ke security group kelompok node terlebih dahulu, lihat Asosiasikan security group dengan instans (ENI primer). Untuk menambah kuota security group, lihat Lihat atau tingkatkan kuota ECS.
	Terway - Pod maksimum	Jumlah maksimum pod yang didukung instans harus memenuhi persyaratan berikut: Jumlah maksimum pod yang didukung dalam mode antarmuka jaringan elastis (ENI) berbeda-beda tergantung pada jumlah maksimum ENI yang didukung oleh tipe instans. Untuk menghitung batas ini, lihat Cara menghitung kuota pod untuk node. Untuk mode ENI bersama, jumlah maksimum pod yang didukung harus lebih dari 10. Untuk mode ENI eksklusif, jumlah maksimum pod yang didukung harus lebih dari 5. Jika persyaratan tidak terpenuhi, lakukan peningkatan dan penurunan sumber daya node atau beli instans baru.
	Terway - Konfigurasi vSwitch	Jika instans dan kelompok node berada di zona ketersediaan yang berbeda, perbarui konfigurasi vSwitch Terway. Jika tidak, Terway akan mengalokasikan alamat IP pod dari vSwitch ENI primer, yang dapat menyebabkan kesalahan alokasi IP pod. Lihat Ubah vSwitch pod.
	Terway - ENI	Saat Anda menambahkan instans, ENI yang terikat padanya dipertahankan, dan alamat IP pod dialokasikan dari vSwitch yang terkait dengan ENI tersebut. Pastikan instans hanya memiliki satu ENI primer. Jika alamat IP pod tidak termasuk dalam vSwitch yang dikonfigurasi, hapus node dari kluster, hapus semua ENI sekunder, lalu tambahkan kembali node tersebut.
	Terway - Peran RAM pekerja	Instans harus diikat ke peran RAM Pekerja kelompok node untuk mencegah masalah izin yang dapat menyebabkan perhitungan MaxPod salah. Di halaman Node Pools, klik nama kelompok node untuk melihat peran RAM Pekerjanya di tab Basic Information. Untuk memberikan peran RAM, lihat Berikan peran RAM ke instans ECS.
	Terway - Dual-stack IPv6	Jika dual-stack IPv6 diaktifkan untuk kluster, tetapkan alamat IPv6 ke ENI primer instans. Lihat Komunikasi IPv6.
	Flannel	Entri rute kustom dalam tabel rute sistem VPC kluster tidak boleh melebihi kuota tabel rute. Untuk menambah kuota, buka Quota Center.

Catatan penggunaan

Backup data: Sebelum memulai, buat snapshot manual untuk disk sistem dan disk data guna mencegah kehilangan data.

Untuk memastikan kuota snapshot mencukupi, hapus snapshot manual dan otomatis yang tidak diperlukan agar pembuatan tidak gagal.
Pelepasan instans dan penagihan: Untuk kelompok node yang tidak mengaktifkan jumlah node yang diharapkan, instans yang ditambahkan ke kelompok node tidak akan dilepas saat Anda menghapus kluster atau kelompok node. Anda harus menghapus node secara manual. Pantau penagihan ECS untuk menghindari biaya tak terduga.

Prosedur

Waktu yang dibutuhkan: Penambahan node, termasuk penggantian disk sistem (hanya mode otomatis) dan inisialisasi node, membutuhkan waktu sekitar 5 menit. Waktu aktual bervariasi tergantung kondisi jaringan, ukuran citra OS, dan faktor lainnya.

Menambahkan node yang ada tidak memengaruhi node kluster atau aplikasi yang sudah ada. Jangan menginisialisasi instans ECS yang sudah menjalankan layanan sebagai node pekerja untuk menghindari masalah kompatibilitas.

Login ke ACK console. Di panel navigasi kiri, klik Clusters.
Di halaman Clusters, klik nama kluster Anda. Di panel navigasi kiri, klik Nodes > Node Pools.
Di halaman Node Pools, temukan kelompok node target, klik di kolom Actions, lalu klik Add Existing Node.

Jika instans ECS target tidak muncul dalam daftar server, artinya instans tersebut tidak memenuhi persyaratan untuk ditambahkan ke kluster. Pilih Show Unavailable Instances untuk melihat instans ECS yang tidak tersedia beserta alasannya. Lihat Batasan dan Catatan penggunaan.
Baca catatan di layar dan pilih metode untuk menambahkan node.

Tambah manual

Dapatkan perintah instalasi dan jalankan di instans target. Anda hanya dapat menambahkan satu instans ECS dalam satu waktu.

Atur Method ke Manual. Pilih instans ECS yang akan ditambahkan dari daftar server cloud yang ada, lalu klik Next.

Di halaman Specify Instance Information, konfirmasi detail kluster dan instans. Konfigurasikan disk data dan nama instans, lalu klik Next.

Parameter	Deskripsi
Data Disk	Menentukan apakah data kontainer dan citra disimpan di disk data, memisahkan disk sistem dari disk data untuk meningkatkan stabilitas. Jika instans ECS memiliki disk data yang terpasang dan sistem file disk data terakhir belum diinisialisasi, ACK secara otomatis memformat disk data terakhir sebagai ext4. Disk tersebut menyimpan data secara eksklusif di /var/lib/containerd atau /var/lib/docker (direktori runtime kontainer default) dan /var/lib/kubelet (direktori kubelet default). Penting Pemformatan akan menghapus data yang ada di disk data. Buat snapshot untuk mencadangkan data Anda terlebih dahulu. Jika Anda menyimpan kontainer dan citra di disk data, hanya sistem file ext4 dan xfs yang didukung. Jika instans ECS tidak memiliki disk data yang terpasang, ACK tidak akan memasang disk data baru, terlepas dari apakah Anda memilih opsi ini atau tidak.
Retain Instance Name	Diaktifkan: Menggunakan nama instans sebagai nama node. Nonaktif: ACK mengganti nama node berdasarkan aturan penamaan node kustom.

Di halaman Complete, salin perintah join node yang dihasilkan oleh ACK, lalu klik Finish.
Login ke ECS console. Di panel navigasi kiri, pilih Instances & Images > Instance. Pilih wilayah kluster dan instans target.
Klik Connect untuk instans target dan pilih metode koneksi jarak jauh.
Masukkan dan jalankan skrip yang Anda salin pada langkah 3 untuk mengonfigurasi dan menambahkan instans ke kluster.

Setelah skrip berhasil dijalankan, pesan sukses akan muncul. Di daftar node, tunggu hingga status node baru berubah menjadi Ready.
```
Worker node joined successfully
+ exit_code=0
+ set +x
```

Tambah otomatis

Tambahkan instans secara otomatis dari konsol.

Atur Method ke Auto. Pilih instans ECS yang akan ditambahkan dari daftar server cloud yang ada, lalu klik Next.

Di halaman Specify Instance Information, konfirmasi detail kluster dan instans. Konfigurasikan disk data dan nama instans, lalu klik Next.

Parameter	Deskripsi
Data Disk	Menentukan apakah data kontainer dan citra disimpan di disk data, memisahkan disk sistem dari disk data untuk meningkatkan stabilitas. Jika instans ECS memiliki disk data yang terpasang dan sistem file disk data terakhir belum diinisialisasi, ACK secara otomatis memformat disk data terakhir sebagai ext4. Disk tersebut menyimpan data secara eksklusif di /var/lib/containerd atau /var/lib/docker (direktori runtime kontainer default) dan /var/lib/kubelet (direktori kubelet default). Penting Pemformatan akan menghapus data yang ada di disk data. Buat snapshot untuk mencadangkan data Anda terlebih dahulu. Jika Anda menyimpan kontainer dan citra di disk data, hanya sistem file ext4 dan xfs yang didukung. Jika instans ECS tidak memiliki disk data yang terpasang, ACK tidak akan memasang disk data baru, terlepas dari apakah Anda memilih opsi ini atau tidak.
Logon method and password	Jika Logon Type kelompok node diatur ke Password, reset password instans.
Retain Instance Name	Diaktifkan: Menggunakan nama instans sebagai nama node. Nonaktif: ACK mengganti nama node berdasarkan aturan penamaan node kustom.

Di kotak dialog, baca catatan dan klik OK.

Setelah node ditambahkan, tunggu hingga node tersebut diinisialisasi di daftar node sampai statusnya berubah menjadi Ready.

FAQ

Apakah penambahan node memengaruhi workload?

Menambahkan node yang ada dalam mode manual atau otomatis tidak memengaruhi workload kluster yang sudah ada.

Bagaimana penskalaan instans memengaruhi workload?

Peningkatan dan penurunan instans ECS dapat mengubah tipe instans, metode penagihan bandwidth publik, bandwidth publik, atau metode penagihan disk data. Lihat Ikhtisar perubahan konfigurasi instans. Dampaknya bervariasi tergantung metode peningkatan dan penurunan yang digunakan.

Operasi yang tidak memerlukan restart: Dampaknya bergantung pada skenario Anda.
Operasi yang memerlukan restart instans ECS: Operasi seperti peningkatan dan penurunan tipe instans menyebabkan gangguan layanan. Sebelum melakukan operasi tersebut, seperti peningkatan dan penurunan sumber daya node, periksa workload saat ini untuk menentukan apakah Anda memerlukan node redundan untuk mengambil alih pod. Kemudian drain node tersebut untuk melakukan peningkatan dan penurunan serta menghapusnya dari grup penskalaan dan kluster ACK. Lihat Hapus node.

Setelah peningkatan dan penurunan selesai, tambahkan kembali node tersebut ke kluster dengan mengikuti topik ini.

Apakah saya dapat menggunakan tipe instans yang berbeda?

Ya. ACK memungkinkan Anda mengelola node dengan berbagai tipe instans dalam kelompok node yang sama, mencegah kegagalan skala keluar akibat ketidaktersediaan tipe instans atau stok yang tidak mencukupi. Sebelum menambahkan instans ECS, pastikan tipe instansnya ada dalam daftar tipe instans kelompok node. Ikuti langkah-langkah berikut:

Edit atau buat kelompok node dan konfigurasikan tipe instans node yang diperlukan. Lihat Buat dan kelola kelompok node.
Drain dan hapus node target. Jangan lepas instans ECS-nya. Lihat Hapus node.
Tambahkan instans ECS dengan tipe instans berbeda ke kelompok node dengan mengikuti bagian Batasan dan Prosedur dalam topik ini.

Bagaimana cara memindahkan node antar kluster?

ACK tidak mendukung pemindahan node langsung antar kluster. Sebagai gantinya, tambahkan node yang ada. Ikuti langkah-langkah berikut:

Drain dan hapus node target dari kluster sumber. Jangan lepas instans ECS-nya. Lihat Hapus node.
Tambahkan instans ECS target ke kelompok node di kluster tujuan dengan mengikuti bagian Batasan dan Prosedur dalam topik ini.

Apakah saya dapat menambahkan node dengan OS yang sudah EOL?

Mode manual: Anda dapat menambahkan instans yang ada yang menjalankan OS yang tidak didukung ke kelompok node, tetapi pastikan versi OS instans kompatibel dengan versi kluster saat ini. Lihat Sistem operasi.

Contohnya, CentOS 7 dan Alibaba Cloud Linux 2 hanya didukung di kluster versi 1.30 dan sebelumnya.
Mode otomatis: ACK menginisialisasi instans menggunakan citra OS yang ditentukan dalam konfigurasi kelompok node.

Apakah user data ditimpa saat menambahkan node?

Apakah user data instans asli ditimpa atau tidak bergantung pada metode penambahan.

Mode otomatis: ACK menginisialisasi disk sistem, menimpa user data instans asli dengan user data yang dikonfigurasi untuk kelompok node.
Mode manual: User data instans asli tidak ditimpa. Setelah instans bergabung ke kelompok node, instans tersebut terus menggunakan user data aslinya.

Bagaimana memperbaiki timeout saat penambahan node?

Periksa konektivitas jaringan antara node dan API Server CLB. Pertama-tama verifikasi bahwa security group memenuhi persyaratan. Untuk batasan security group saat menambahkan node yang ada, lihat Batasan. Untuk masalah konektivitas jaringan lainnya, lihat FAQ manajemen jaringan.

Apakah penambahan node mengubah jumlah yang diharapkan?

Ya. Setelah Anda menambahkan node yang ada, jumlah Expected Nodes bertambah sesuai jumlah node yang ditambahkan. Misalnya, jika Expected Nodes diatur ke 5 dan Anda menambahkan satu instans ECS, jumlahnya menjadi 6.

Referensi

Selain melalui konsol, tambahkan instans ECS ke kluster ACK dengan memanggil operasi API (Dapatkan skrip untuk menambahkan node yang ada ke kelompok node) atau menjalankan perintah CLI (Tambahkan instans ECS yang ada).
Kluster lama yang dibuat sebelum fitur kelompok node mungkin berisi node bebas (node yang tidak termasuk dalam kelompok node apa pun). Migrasikan ke kelompok node untuk manajemen terpusat. Lihat Migrasikan node bebas ke kelompok node.
Jika node, pod, atau komponen lain tidak berfungsi sebagaimana mestinya, lakukan troubleshooting. Lihat Troubleshoot exception node, Troubleshoot exception pod, dan FAQ tentang node dan kelompok node.