All Products
Search

This Product

    Container Service for Kubernetes:Tambahkan node tepi

    Document Center

    Container Service for Kubernetes:Tambahkan node tepi

    Last Updated:Jun 23, 2026

    Tambahkan edge node ke edge node pool dalam ACK Edge cluster menggunakan ECS node dari berbagai region, IDC node, node dari penyedia cloud lain, atau node on-premises di pabrik, toko, kendaraan, dan kapal.

    Prasyarat

    ACK Edge cluster telah dibuat.

    Batasan

    • Pastikan cluster Anda memiliki kuota node yang mencukupi. Untuk menambahkan lebih banyak node, ajukan permintaan peningkatan kuota di Quota Center. Lihat Kuota dan batasan untuk informasi mengenai batas kuota ACK Edge cluster.

    • Saat menambahkan edge node, konfigurasikan security group-nya agar mengizinkan akses ke nama domain yang diperlukan. Lihat Konfigurasi akses jaringan publik.

    • Pilih sistem operasi yang didukung untuk edge node.

      Arsitektur sistem

      Versi sistem

      Versi kernel

      Versi kluster

      AMD64/x86_64

      Anolis 7.9 dan Anolis 8.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, CentOS 7.5, CentOS 7.6, CentOS 7.7, CentOS 7.8, dan CentOS 7.9

      3.10.X

      1.12.6-aliyunedge.1 ≤ versi kluster ≤ 1.30.7-aliyun.1

      AMD64/x86_64

      CentOS 8.0 dan CentOS 8.2

      4.18.X

      1.18.8-aliyunedge.1 ≤ versi kluster ≤ 1.30.7-aliyun.1

      AMD64/x86_64

      Ubuntu 16.04

      4.4.X

      1.18.8-aliyunedge.1 ≤ versi kluster ≤ 1.30.7-aliyun.1

      AMD64/x86_64

      Ubuntu 18.04

      4.15.X

      1.12.6-aliyunedge.1 ≤ versi kluster ≤ 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 dan Red Hat Enterprise Linux 8.10

      4.18.X

      1.26.3-aliyun.1 ≤ versi kluster ≤ 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 kluster ≤ 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

    Kubernetes 1.26 dan yang lebih baru

    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, pilih Icon > Add Existing Node dari kolom Actions di sebelah kanan kelompok node target.

    4. Pada halaman Add Existing Edge Node, konfigurasikan komunikasi cloud-edge dan opsi lanjutan.

      Catatan

      Jika parameter konsol tidak memenuhi kebutuhan Anda, modifikasi parameter edgeadm dalam skrip yang dihasilkan. Lihat Daftar parameter.

      Kategori

      Parameter

      Deskripsi

      Komunikasi cloud-edge

      Token validity period

      Periode validitas skrip. Default: 1 jam.

      Tentukan periode validitas yang lebih lama untuk menggunakan kembali skrip yang sama saat menambahkan node secara batch.

      Enable silent mode

      Apakah akan mengaktifkan silent mode.

      Saat menambahkan edge node, beberapa langkah memerlukan konfirmasi, seperti apakah akan menginstal ulang runtime yang sudah ada.

      Secara default, semua prompt dijawab secara otomatis dengan yes.

      Lanjutan

      Node labels

      Menambahkan label ke node baru.

      Jika label bertentangan dengan label key kelompok node, label kelompok node akan diutamakan.

      Taints

      Menambahkan taint ke node baru.

      Annotations

      Menambahkan annotation ke node baru.

      Jika annotations bertentangan dengan annotations kelompok node, annotations kelompok node akan diutamakan.

      Automatic time synchronization

      Jika diaktifkan, edgeadm secara otomatis melakukan time synchronization.

      Node network interface

      Antarmuka jaringan host untuk alamat IP node dan komunikasi jaringan kontainer. Jika dikosongkan, antarmuka jaringan rute default akan digunakan.

      Download add-ons from

      Sumber unduhan gambar add-on sistem. Default: Public Network.

      Untuk mengunduh gambar melalui jaringan internal, tambahkan node ke leased line node pool.

      Runtime working directory

      Direktori kerja runtime. Hanya berlaku jika manageRuntime bernilai true.

      Jalur default untuk containerd: /var/lib/containerd.

    5. Setelah konfigurasi selesai, klik OK. Pada halaman hasil, klik Copy, lalu tempel dan jalankan skrip tersebut pada edge node.

      Setelah edge node bergabung ke kluster, terminal akan menampilkan log. Baris output terakhir mengonfirmasi bahwa penambahan node berhasil.

      I0410 10:54:25.801554    19419 join-node.go:241] [join-node] Config the kubelet service configuration successfully.
I0410 10:54:25.801590    19419 join-node.go:246] [join-node] Adding edge hub static yaml
I0410 10:54:25.801662    19419 join-node.go:279] [join-node] Add edge hub static yaml is ok
I0410 10:54:25.801666    19419 join-node.go:384] [join-node] Start to joining node to cluster.
I0410 10:54:27.338166    19419 join-node.go:393] [join-node] Join node to cluster successfully.
I0410 10:54:27.338214    19419 install.go:151] [install-edgehub] Checking edgehub status
I0410 10:54:37.357405    19419 install.go:156] [install-edgehub] Edgehub is ok
I0410 10:54:37.357421    19419 install.go:86] [install-edgehub] Reconfiguring the kubelet configuration files.
I0410 10:54:37.364387    19419 install.go:103] [install-edgehub] Reconfigure the kubelet configuration files successfully.
I0410 10:54:37.364400    19419 install.go:104] [install-edgehub] Restarting the kubelet.
I0410 10:54:52.626540    19419 install.go:127] [install-edgehub] Restart the kubelet successfully.
I0410 10:54:52.626613    19419 postcheck.go:77] [post-check] Checking docker status
I0410 10:54:52.629194    19419 postcheck.go:86] [post-check] docker is ok
I0410 10:54:52.629208    19419 postcheck.go:92] [post-check] Checking kubelet status
I0410 10:54:52.631661    19419 postcheck.go:100] [post-check] Kubelet is ok
I0410 10:54:52.631671    19419 postcheck.go:106] [post-check] Checking edgehub status
I0410 10:54:52.642345    19419 postcheck.go:113] [post-check] Edgehub is ok
I0410 10:54:52.642356    19419 postcheck.go:129] [post-check] Checking addon kube-proxy status.
I0410 10:54:52.683227    19419 postcheck.go:133] [post-check] kube-proxy is OK.
I0410 10:54:52.683243    19419 postcheck.go:129] [post-check] Checking addon flannel status.
I0410 10:54:52.724501    19419 postcheck.go:133] [post-check] flannel is OK.
I0410 10:54:52.724518    19419 postcheck.go:129] [post-check] Checking addon coredns status.
I0410 10:54:52.764745    19419 postcheck.go:133] [post-check] coredns is OK.
I0410 10:54:52.764763    19419 postcheck.go:165] [post-check] Callback to the OpenAPI.
I0410 10:54:53.014706    19419 postcheck.go:178] [post-check] Callback to the OpenAPI successfully.
I0410 10:54:53.014760    19419 postcheck.go:66] This node joined into the cluster successfully.

    Kubernetes versi sebelum 1.26

    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, pada kolom Actions untuk kelompok node target, pilih Icon > Add Existing Node.

    4. Pada halaman Add Node, Manual dipilih secara default untuk menambahkan instans yang sudah ada.

      Catatan

      Dalam mode manual, tambahkan node ECS di cloud, node Edge Node Service (ENS), dan node on-premises.

      1. Klik Next untuk mengonfigurasi parameter akses node pada halaman berikutnya. Lihat Daftar parameter.

        Atur Architecture ke AMD64/X86_64 atau ARM64, pilih Use Lightweight Access Mode, lalu atur parameter akses dalam editor JSON. Misalnya, atur enableIptables, quiet, dan manageRuntime ke true, serta tentukan kube-proxy, flannel, dan coredns dalam allowedClusterAddons.

        Catatan

        Periode validitas skrip default adalah 1 jam. Tentukan periode yang lebih lama untuk menggunakan kembali skrip tersebut saat menambahkan node secara batch. Atur periode validitas skrip menjadi 0 jam untuk skrip yang tidak kedaluwarsa.

      2. Setelah konfigurasi selesai, klik Next. Pada halaman Complete, klik Copy, lalu tempel dan jalankan skrip tersebut pada edge node.

    Daftar parameter

    Jika parameter konsol tidak memenuhi kebutuhan Anda, modifikasi parameter edgeadm dalam skrip yang dihasilkan seperti dijelaskan di bawah ini.

    Parameter

    Parameter konsol yang sesuai

    Deskripsi

    Nilai

    quiet

    Enable silent mode

    Apakah akan mengaktifkan silent mode. Selama pendaftaran node, beberapa langkah memerlukan konfirmasi, seperti apakah akan menginstal ulang runtime yang sudah ada.

    • true (default): Secara otomatis menjawab yes untuk semua prompt.

    • false: Pendaftaran dijeda untuk konfirmasi dan dapat diinterupsi.

    manageRuntime

    N/A

    Apakah edgeadm mendeteksi dan menginstal runtime.

    • true (default): Mendeteksi dan menginstal runtime.

    • false: Tidak menginstal runtime. Instal runtime pada node terlebih dahulu.

    nodeNameOverride

    N/A

    Nama node.

    • "": Default. Menggunakan hostname.

    • "XXX": Nama node adalah XXX.

    • "*": Menghasilkan string acak sepanjang 6 karakter.

    • "*.XXX": Menghasilkan string acak sepanjang 6 karakter dengan akhiran XXX.

    allowedClusterAddons

    N/A

    Add-on yang akan diinstal. Default untuk node standar: ["kube-proxy","flannel","coredns"].

    Default: ["kube-proxy","flannel","coredns"].

    gpuVersion

    N/A

    Apakah node merupakan GPU node. Default: kosong.

    Lihat Model GPU untuk versi GPU yang didukung.

    "" (default): Node tidak ditambahkan sebagai GPU node.

    ACK Edge cluster yang menjalankan Kubernetes 1.26 atau lebih baru dapat menambahkan node GPU NVIDIA tanpa mengonfigurasi gpuVersion. Tool secara otomatis mendeteksi model GPU dan menginstal add-on yang diperlukan.

    labels

    Node labels

    Label yang ditambahkan saat node didaftarkan. Jika label ini bertentangan dengan label key kelompok node, label kelompok node akan diutamakan.

    {}: Tidak ada label yang ditambahkan.

    annotations

    Annotations

    Annotations yang ditambahkan saat node didaftarkan. Jika annotations ini bertentangan dengan annotations kelompok node, annotations kelompok node akan diutamakan.

    {}: Tidak ada annotation yang ditambahkan.

    taints

    Taints

    Taint yang ditambahkan ke node.

    []

    nodeIface

    N/A

    Antarmuka jaringan host, digunakan untuk:

    • Mendapatkan informasi alamat IP node dari antarmuka jaringan yang ditentukan.

    • Antarmuka jaringan yang digunakan oleh plug-in jaringan kontainer Flannel.

    "": Jika dikosongkan, kubelet mendapatkan alamat IP node dalam urutan berikut:

    • Mencari catatan yang cocok dengan hostname di /etc/hosts.

    • Alamat IP dari antarmuka jaringan rute default.

    Flannel menggunakan antarmuka jaringan rute default.

    runtimeRootDir

    Runtime working directory

    Direktori kerja runtime. Hanya berlaku jika manageRuntime bernilai true.

    "": Default.

    • Jika runtime adalah Docker, jalur default-nya adalah /var/lib/docker.

    • Jika runtime adalah Containerd, jalur default-nya adalah /var/lib/containerd.

    imageRepoType

    Download components from

    Sumber tempat node mengunduh gambar add-on sistem.

    • "" (default): Node dalam leased line node pool mengunduh gambar dari jaringan internal; node dalam node pool biasa mengunduh dari jaringan publik.

    • public: Mengunduh gambar dari jaringan publik.

    • private: Mengunduh gambar dari jaringan internal. Node harus berada dalam leased line node pool.

    selfHostNtpServer

    Automatic time synchronization

    Apakah time synchronization dilakukan secara manual.

    • false (default): edgeadm secara otomatis melakukan time synchronization.

    • true: Lewati time synchronization otomatis karena telah dilakukan secara manual.

    flannelIface

    Node network interface

    Antarmuka jaringan yang digunakan oleh Flannel. Gunakan parameter nodeIface sebagai gantinya.

    "" (default): Flannel menggunakan antarmuka jaringan rute default.

    enableIptables

    N/A

    Apakah edgehub mengaktifkan optimasi iptables. Telah ditinggalkan sejak v1.22 dan tidak disarankan.

    false: Optimasi iptables dinonaktifkan.

    Referensi