Kluster ACK Edge mendukung penambahan mesin fisik dan virtual dari berbagai lingkungan sebagai edge node—termasuk instance Elastic Compute Service (ECS) dari wilayah lain, server IDC on-premises, node dari penyedia cloud lain, serta server yang ditempatkan di pabrik, gerai ritel, kendaraan, dan kapal.
Topik ini menjelaskan cara menambahkan node yang sudah ada ke dalam node pool edge pada kluster ACK Edge.
Prasyarat
Sebelum memulai, pastikan bahwa:
Kluster ACK Edge telah dibuat.
Kluster memiliki kuota node yang mencukupi. Untuk mengajukan peningkatan kuota, buka Quota Center. Untuk batas kuota, lihat Kuota dan batas.
Security group node dikonfigurasi untuk mengizinkan akses ke nama domain yang diperlukan. Untuk detailnya, lihat Konfigurasi routing nama domain dan IP untuk akses edge node.
Node menjalankan sistem operasi yang didukung.
Sistem operasi yang didukung
| Arsitektur sistem | Versi OS | Versi kernel | Versi kluster ACK Edge |
|---|---|---|---|
| AMD64/x86_64 | Anolis7.9, Anolis8.6 | 4.19.X | ≥ 1.16.9-aliyunedge.1 |
| AMD64/x86_64 | Alibaba Cloud Linux 2.1903 | 4.19.X | ≥ 1.20.11-aliyunedge.1 |
| AMD64/x86_64 | Alibaba Cloud Linux 3 | 5.10.X | ≥ 1.20.11-aliyunedge.1 |
| AMD64/x86_64 | CentOS 7.4, 7.5, 7.6, 7.7, 7.8, dan 7.9 | 3.10.X | 1.12.6-aliyunedge.1 ≤ versi ≤ 1.30.7-aliyun.1 |
| AMD64/x86_64 | CentOS 8.0, CentOS 8.2 | 4.18.X | 1.18.8-aliyunedge.1 ≤ versi ≤ 1.30.7-aliyun.1 |
| AMD64/x86_64 | Ubuntu 16.04 | 4.4.X | 1.18.8-aliyunedge.1 ≤ versi ≤ 1.30.7-aliyun.1 |
| AMD64/x86_64 | Ubuntu 18.04 | 4.15.X | 1.12.6-aliyunedge.1 ≤ versi ≤ 1.30.7-aliyun.1 |
| AMD64/x86_64 | Ubuntu 18.04 | 5.4.X | ≥ 1.16.9-aliyunedge.1 |
| AMD64/x86_64 | Ubuntu 18.04 | 5.11.X | ≥ 1.18.8-aliyunedge.1 |
| AMD64/x86_64 | Ubuntu 20.04 | 5.4.X | ≥ 1.18.8-aliyunedge.1 |
| AMD64/x86_64 | Ubuntu 20.04 dan Ubuntu 22.04 | 5.15.X | ≥ 1.26.3-aliyun.1 |
| AMD64/x86_64 | Ubuntu 24.04 | 6.8.X | ≥ 1.30.7-aliyun.1 |
| AMD64/x86_64 | Red Hat Enterprise Linux 8.8, Red Hat Enterprise Linux 8.10 | 4.18.X | 1.26.3-aliyun.1 ≤ versi ≤ 1.30.7-aliyun.1 |
| AMD64/x86_64 | Kylin V10 | 4.19.X | ≥ 1.26.3-aliyun.1 |
| AMD64/x86_64 | UnionTech OS Server 20 | 4.19.X | ≥ 1.26.3-aliyun.1 |
| AMD64/x86_64 | Red Hat Enterprise Linux 9.3 | 5.14.X | ≥ 1.30.7-aliyun.1 |
| Arm64 | CentOS 8.0 | 4.19.X | ≥ 1.14.8-aliyunedge.1 |
| Arm64 | Ubuntu 18.04 | 4.9.X | 1.14.8-aliyunedge.1 ≤ versi ≤ 1.30.7-aliyun.1 |
| Arm64 | Ubuntu 18.04 | 4.19.X | ≥ 1.14.8-aliyunedge.1 |
| Arm64 | Ubuntu 20.04 | 5.10.X | ≥ 1.22.15-aliyunedge.1 |
Untuk menambahkan node GPU, lihat Tambahkan node GPU.
Tambahkan node edge
Langkah-langkahnya berbeda tergantung versi kluster. Gunakan bagian yang sesuai dengan kluster Anda.
Kluster yang menjalankan Kubernetes 1.26 atau lebih baru
Masuk ke Konsol ACK, lalu klik Clusters di panel navigasi sebelah kiri.
Pada halaman Clusters, klik nama kluster target. Di panel navigasi sebelah kiri, pilih Nodes > Node Pools.
Pada halaman Node Pools, temukan node pool target dan klik  > Add Existing Node di kolom Actions.
Pada halaman Add Existing Node, konfigurasikan parameter komunikasi cloud-edge dan opsi lanjutan.
Jika parameter konsol tidak memenuhi kebutuhan Anda, edit langsung parameter edgeadm dalam skrip yang dihasilkan. Lihat referensi parameter edgeadm di bawah.
Konfigurasi komunikasi cloud-edge
Parameter Deskripsi Token validity period Lama waktu skrip yang dihasilkan tetap valid. Default: 1 jam. Atur ke 0 hours agar skrip tidak pernah kedaluwarsa — berguna saat menambahkan node secara batch dalam periode panjang. Enable silent mode Default: Yes. Dalam mode senyap, edgeadm secara otomatis menjawab semua prompt dengan yes(misalnya, ketika ditanya apakah akan menginstal ulang runtime yang sudah ada). Atur ke No untuk meninjau dan mengonfirmasi setiap prompt secara manual.Opsi lanjutan
Parameter Deskripsi Node labels Label yang akan diterapkan pada node. Jika kunci label bertentangan dengan label yang ditetapkan pada node pool, label node pool yang berlaku. Taints Taint yang akan diterapkan pada node. Annotations Anotasi yang akan diterapkan pada node. Jika kunci anotasi bertentangan dengan anotasi yang ditetapkan pada node pool, anotasi node pool yang berlaku. Automatic synchronize time Jika diaktifkan, edgeadm secara otomatis menyinkronkan jam sistem pada node. Node network port Nama antarmuka jaringan (NIC) yang digunakan kubelet untuk mendapatkan IP node dan yang digunakan flannel untuk jaringan kontainer. Biarkan kosong untuk menggunakan NIC yang terkait dengan rute default. The component is downloaded from Sumber gambar komponen sistem. Default: jaringan publik. Memilih jaringan pribadi mengharuskan node terhubung ke node pool jalur sewa. Runtime working directory Direktori kerja untuk runtime kontainer. Hanya berlaku jika manageRuntimediatur ketrue. Default untuk containerd:/var/lib/containerd.
Klik OK. Pada halaman hasil pengiriman, klik Copy, tempel skrip tersebut ke node edge Anda, lalu jalankan. Jika hasil berikut dikembalikan, node edge berhasil ditambahkan ke kluster.

Kluster yang menjalankan Kubernetes versi lebih lama dari 1.26
Masuk ke Konsol ACK dan klik Clusters di panel navigasi sebelah kiri.
Pada halaman Clusters, klik nama kluster target. Di panel navigasi sebelah kiri, pilih Nodes > Node Pools.
Pada halaman Node Pools, temukan node pool target dan klik More
> Add Existing Node di kolom Actions.Pada halaman Add Node, mode Manual dipilih secara default. Mode manual mendukung instance ECS, instance ENS, dan edge node. Klik Next Step untuk menuju halaman Instance Information dan konfigurasikan pengaturan akses node.
Script validity period default-nya adalah 1 jam. Atur ke 0 hours agar skrip tidak pernah kedaluwarsa—berguna saat menambahkan node secara batch dalam periode panjang.

Klik Next Step. Pada halaman Complete, klik Copy, tempel skrip tersebut ke node edge Anda, lalu jalankan. Jika hasil berikut dikembalikan, node edge berhasil ditambahkan ke kluster.

Referensi parameter edgeadm
Jika opsi konsol tidak mencakup skenario Anda, modifikasi langsung parameter edgeadm dalam skrip yang dihasilkan. Tabel berikut mencantumkan semua parameter yang tersedia.
| Parameter | Wajib | Ekuivalen konsol | Default | Deskripsi |
|---|---|---|---|---|
quiet | Tidak | Enable silent mode | true | Mengontrol apakah edgeadm secara otomatis menjawab semua prompt dengan yes. Atur ke false untuk meninjau dan mengonfirmasi setiap prompt — perlu diperhatikan bahwa ini dapat menghentikan atau mengganggu proses join node. |
manageRuntime | Tidak | N/A | true | Mengontrol apakah edgeadm mendeteksi dan menginstal runtime kontainer. Atur ke false jika Anda telah menginstal runtime pada node. |
nodeNameOverride | Tidak | N/A | "" | Nama node. "" menggunakan hostname. "XXX" mengatur nama menjadi XXX. "*" menghasilkan string acak 6 karakter. "*.XXX" menghasilkan string acak 6 karakter dengan akhiran XXX. |
allowedClusterAddons | Tidak | N/A | ["kube-proxy","flannel","coredns"] | Komponen yang akan diinstal pada node. |
gpuVersion | Tidak | N/A | "" | Menentukan model GPU saat menambahkan node berakselerasi GPU. Untuk model GPU yang didukung, lihat Model GPU. Untuk kluster ACK Edge versi 1.26 dan lebih baru, model GPU NVIDIA terdeteksi otomatis — parameter ini tidak diperlukan. |
labels | Tidak | Node labels | {} | Label yang akan diterapkan pada node. Jika kunci label bertentangan dengan label pada node pool, label node pool yang berlaku. |
annotations | Tidak | Annotations | {} | Anotasi yang akan diterapkan pada node. Jika kunci anotasi bertentangan dengan anotasi pada node pool, anotasi node pool yang berlaku. |
taints | Tidak | Taints | [] | Taint yang akan diterapkan pada node. |
nodeIface | Tidak | N/A | "" | NIC yang digunakan kubelet untuk mendapatkan IP node dan yang digunakan flannel untuk jaringan kontainer. Jika dibiarkan kosong, kubelet memeriksa catatan di /etc/hosts yang cocok dengan hostname terlebih dahulu, lalu menggunakan NIC pada rute default. Flannel juga menggunakan NIC rute default. |
runtimeRootDir | Tidak | Runtime working directory | "" | Direktori kerja untuk runtime kontainer. Hanya berlaku jika manageRuntime bernilai true. Default Docker: /var/lib/docker. Default containerd: /var/lib/containerd. |
imageRepoType | Tidak | The component is downloaded from | "" | Sumber gambar komponen sistem. "" memilih secara otomatis: node node pool jalur sewa menggunakan jaringan internal; node node pool biasa menggunakan jaringan publik. public memaksa penggunaan jaringan publik. private memaksa penggunaan jaringan internal dan mengharuskan adanya node pool jalur sewa. |
selfHostNtpServer | Tidak | Automatic synchronize time | false | Mengontrol sinkronisasi waktu. false: edgeadm secara otomatis menyinkronkan jam sistem. true: waktu telah disinkronkan secara manual; lewati sinkronisasi otomatis. |
flannelIface | Tidak | Node network port | "" | Nama NIC untuk flannel. Tidak disarankan — gunakan nodeIface sebagai gantinya. Default-nya adalah NIC pada rute default node. |
enableIptables | Tidak | N/A | false | Mengontrol apakah edgehub mengaktifkan optimasi iptables. Sudah tidak digunakan lagi setelah versi 1.22. |
Langkah selanjutnya
Jika node gagal bergabung, lihat Diagnosa masalah edge node.
Untuk menghapus node yang tidak lagi diperlukan, lihat Hapus edge node.
Untuk menjaga beban kerja tetap berjalan di node saat koneksi jaringan cloud-edge terputus, lihat Konfigurasikan otonomi edge node.