All Products
Search
Document Center

Container Service for Kubernetes:Pemecahan masalah node edge

Last Updated:Mar 26, 2026

Gunakan halaman ini untuk memecahkan masalah umum terkait kegagalan koneksi dan peningkatan pada node edge di kluster ACK Edge. Cari fragmen pesan error yang Anda lihat di halaman ini—setiap entri memetakan error tersebut ke penyebab dan solusinya.

Jika masalah Anda tidak tercantum, kumpulkan informasi diagnostik dari node tersebut dan submit a ticket. Untuk petunjuknya, lihat Kumpulkan informasi diagnostik node.

Tangani kegagalan koneksi node edge

Jalankan skrip koneksi node untuk menghubungkan node edge ke kluster. Jika skrip gagal, cocokkan pesan error Anda pada tabel di bawah ini.

Pesan errorPenyebabPerbaikan
The os XXX unsupportVersi sistem operasi tidak didukung.Lihat Tambahkan node edge untuk daftar versi sistem operasi yang didukung.
Invalid nodeNameNama node tidak memenuhi aturan penamaan.Gunakan nama yang hanya berisi huruf kecil, tanda hubung (-), dan titik (.); panjang 1–253 karakter; dan tidak dimulai dengan localhost.
Node route overlaps with service cidrRute node bentrok dengan Blok CIDR Pod atau Blok CIDR Service.Buat ulang kluster dan konfigurasi ulang Blok CIDR Pod serta Blok CIDR Service agar tidak tumpang tindih dengan alamat NameServer atau rute node.
response error msg: TOKEN_EXPIREDToken koneksi telah kedaluwarsa.Hasilkan skrip koneksi node baru. Periksa juga apakah jam sistem node akurat.
A node named XXX is already exist in the clusterNode dengan nama ini sudah ada di kluster.Hapus node yang sudah ada dengan nama yang sama dari kluster, lalu jalankan kembali skrip koneksi.
error run phase join-node: failed to get cluster info: failed to get cluster-info configmap, Get "https://xx.xxx.xx.xx:6443/api/v1/namespaces/kube-public/configmaps/cluster-info": dial tcp xx.xxx.xx.xx:6443: i/o timeoutedgeadm tidak dapat mengakses server API.edgeadm terhubung ke server API melalui alamat IP. Periksa apakah aturan daftar kontrol akses (ACL) pada instans Server Load Balancer (SLB) yang menghadap server API memblokir alamat IP node tersebut.
error run phase join-node: Install edge-hub failed: Copy file /tmp/edge-hub to /usr/bin/edge-hub fail: open /usr/bin/edge-hub: text file busy | 40009 | 40009File biner edge-hub sudah ada di node.Jalankan edgeadm reset untuk membersihkan node, lalu jalankan kembali skrip koneksi.
error run phase post-check: timed out waiting for the conditionKomponen sistem gagal dimulai.1. Unduh edgeadm versi terbaru, jalankan edgeadm reset, lalu jalankan kembali skrip koneksi.2. Pastikan node dapat mengakses semua Titik akhir publik yang diperlukan—lihat Konfigurasikan titik akhir dan routing IP untuk node edge.3. Jika masalah tetap berlanjut, kumpulkan informasi diagnostik dan submit a ticket.

Tangani kegagalan peningkatan node edge

Saat Anda memperbarui kelompok node edge, peningkatan dianggap selesai ketika node menampilkan This node has been upgraded successfully. Jika pesan tersebut tidak muncul, cocokkan error Anda pada tabel di bawah ini.

Pesan errorPenyebabSolusi
edgeadm version xxxx does not match cluster versionVersi edgeadm tidak sesuai dengan versi kluster.1. Pastikan lapisan kontrol kluster telah ditingkatkan.2. Periksa bahwa TARGET_CLUSTER_VERSION diatur ke nilai yang benar.
node has already been upgraded to xxxNode sudah berada pada versi target.Jika komponen tertentu pada node belum ditingkatkan, simpan log tersebut dan submit a ticket.
kubelet target version xxxx does not match cluster version xxxxVersi kubelet tidak sesuai dengan versi lapisan kontrol.Jika Anda menentukan kubelet-version, pastikan nilainya sesuai dengan versi lapisan kontrol. Jika parameter tersebut dibiarkan kosong, submit a ticket.
Parameter currentVersion cann't nullMenggunakan versi lama edgeadm.Unduh edgeadm versi terbaru. Perhatikan bahwa jalur peningkatan yang valid adalah Kubernetes 1.18 → 1.20 dan Kubernetes 1.20 → 1.22.

upgrade kubelet failed at phase install, recover to previous state.

error run phase upgrade: xxxx

Peningkatan gagal dan secara otomatis dikembalikan ke kondisi sebelumnya. Status node tidak terpengaruh.Simpan log tersebut dan submit a ticket.

upgrade kubelet failed at phase install, recover to previous state

recover kubelet failed, err: xxx

error run phase upgrade: xxxx

Peningkatan gagal dan proses rollback juga gagal. Status node terpengaruh.Simpan log tersebut dan submit a ticket.

Kumpulkan informasi diagnostik node

Saat node edge di kluster ACK Edge berperilaku tidak normal, jalankan skrip diagnostik untuk mengumpulkan informasi guna analisis lebih lanjut.

  1. Login ke node edge yang bermasalah.

  2. Unduh skrip diagnostik.

    curl -o /usr/local/bin/diagnose_edge_node.sh https://aliacs-k8s-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/public/diagnose/diagnose_k8s.sh
  3. Buat skrip tersebut dapat dieksekusi.

    chmod u+x /usr/local/bin/diagnose_edge_node.sh
  4. Berpindah ke direktori tersebut.

    cd /usr/local/bin/
  5. Jalankan skrip diagnostik.

    ./diagnose_edge_node.sh

    Setiap eksekusi menghasilkan arsip dengan nama unik. Output-nya mirip seperti berikut:

    + echo 'please get diagnose_1578310147.tar.gz for diagnostics'
    please get diagnose_1578310147.tar.gz for diagnostics
    + echo 'Submit the file named diagnose_1578310147.tar.gz to request technical support.'
    Submit the file named diagnose_1578310147.tar.gz to request technical support.
  6. Verifikasi bahwa arsip telah dibuat.

    ll

Lampirkan file .tar.gz yang dihasilkan saat Anda submit a ticket.