Masalah umum saat menambahkan node edge - Container Service for Kubernetes

Atasi masalah koneksi, peningkatan, dan GPU pada node edge di kluster ACK Edge.

Membedakan antara node cloud dan node edge

ACK Edge menggunakan label alibabacloud.com/is-edge-worker untuk mengidentifikasi node edge.

Saat Anda menambahkan node ke kelompok node cloud atau kelompok node edge, label is-edge-worker ditambahkan secara otomatis. Jika nilai is-edge-worker adalah true, maka node tersebut merupakan node edge. Jika nilainya false, maka node tersebut merupakan node cloud.

Tambahkan node edge melalui Express Connect

Untuk menambahkan node edge ke kluster ACK Edge melalui Express Connect, penuhi persyaratan berikut. Lihat Konfigurasi khusus untuk kluster ACK Edge dalam skenario Express Connect.

Saat membuat kelompok node edge, pilih Dedicated sebagai tipe kelompok node. Kemudian, ikuti petunjuk di Tambahkan node edge untuk menghasilkan skrip koneksi node.

Lihat Kelola kelompok node edge.

Catatan
Jika kluster ACK Edge Anda versi 1.22 atau lebih baru, Anda tidak dapat menggunakan parameter inDedicatedNetwork dalam skrip koneksi node untuk menambahkan node melalui Express Connect. Jika kluster Anda versi sebelum 1.22, lakukan upgrade terlebih dahulu.
Dalam skenario jalur dedicated, onboarding node berinteraksi dengan layanan cloud melalui titik akhir internal. Pastikan konektivitas jaringan ke layanan yang diperlukan seperti OSS, Container Registry, dan Server Load Balancer (SLB).

Tambahkan node berakselerasi GPU

Instal driver GPU sebelum menambahkan node.
Lihat Versi driver NVIDIA yang didukung oleh ACK.

Atur parameter gpuVersion dalam skrip koneksi node agar sesuai dengan model GPU Anda.

Arsitektur OS	Model GPU	Versi kluster ACK Edge
AMD64/x86_64	Nvidia_Tesla_T4	≥1.16.9-aliyunedge.1
AMD64/x86_64	Nvidia_Tesla_P4	≥1.16.9-aliyunedge.1
AMD64/x86_64	Nvidia_Tesla_P100	≥1.16.9-aliyunedge.1
AMD64/x86_64	Nvidia_Tesla_V100	≥1.18.8-aliyunedge.1
AMD64/x86_64	Nvidia_Tesla_A10	≥1.20.11-aliyunedge.1
AMD64/x86_64	Nvidia_L40	≥1.26.3-aliyun.1

Dalam file konfigurasi node, atur bidang gpuVersion sesuai model GPU Anda, misalnya Nvidia_Tesla_T4:

{
  "gpuVersion": "Nvidia_Tesla_T4",
  "enableIptables": true,
  "quiet": true,
  "manageRuntime": true,
  "allowedClusterAddons": [
    "kube-proxy",
    "flannel",
    "coredns"
  ]
}

Setelah dikonfigurasi, tool koneksi akan secara otomatis menginstal nvidia-containerd-runtime. Lihat NVIDIA Container Runtime.

Pemecahan masalah kegagalan skrip koneksi node

Jika skrip gagal, gunakan tabel berikut untuk pemecahan masalah. Jika masalah tidak tercantum, kumpulkan informasi diagnostik node dan submit a ticket. Lihat Cara mengumpulkan informasi diagnostik untuk node dalam kluster ACK Edge.

Pesan error	Penyebab	Solusi
The os XXX unsupport	OS node edge tidak didukung.	Untuk daftar sistem operasi yang didukung, lihat Tambahkan node edge.
invalid nodeName	Nama node tidak valid.	Nama node hanya boleh berisi huruf kecil, tanda hubung (-), dan titik (.). Panjang nama node tidak boleh melebihi 253 karakter. Nama node tidak boleh dimulai dengan "localhost".
Node route overlaps with service cidr	Tabel rute node bertentangan dengan Blok CIDR pod atau layanan yang dikonfigurasi saat pembuatan kluster.	Buat ulang kluster. Pastikan Blok CIDR pod dan layanan tidak bertentangan dengan alamat NameServer atau tabel rute node edge.
response error msg: TOKEN_EXPIRED	Token koneksi telah kedaluwarsa.	Buat ulang skrip koneksi node. Periksa apakah waktu sistem pada node sudah benar.
A node named XXX already exists in the cluster	Node dengan nama yang sama sudah ada di kluster.	Hapus node dengan nama yang sama dari kluster.
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 timeout	Gagal mendapatkan ConfigMap cluster-info.	Untuk menambahkan node edge, edgeadm mengakses server API pada alamat ini. Periksa apakah aturan daftar kontrol akses (ACL) pada instans SLB server API membatasi akses 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 \| 40009	File biner edge-hub sudah ada di node.	Jalankan `edgeadm reset` untuk membersihkan node, lalu tambahkan kembali.
error run phase post-check: timed out waiting for the condition	Komponen sistem gagal dimulai.	Unduh edgeadm versi terbaru. Jalankan `edgeadm reset` dan tambahkan kembali node tersebut. Verifikasi bahwa node edge dapat mengakses titik akhir publik yang diperlukan. Lihat Manajemen jaringan. Kumpulkan informasi diagnostik node edge dan submit a ticket. Lihat Cara mengumpulkan informasi diagnostik untuk node dalam kluster ACK Edge.

Kegagalan peningkatan node edge

Saat Anda melakukan peningkatan kelompok node edge, jika pesan This node has been upgraded successfully tidak muncul, gunakan tabel berikut untuk pemecahan masalah.

Pesan error	Penyebab	Solusi
edgeadm version xxxx does not match cluster version	Versi tool peningkatan tidak sesuai dengan versi kluster.	Verifikasi bahwa lapisan kontrol kluster telah ditingkatkan. Verifikasi bahwa `TARGET_CLUSTER_VERSION` dikonfigurasi dengan benar.
node has already been upgraded to xxx	Node sudah berada pada versi target.	Jika beberapa komponen node belum ditingkatkan, simpan log dan submit a ticket.
kubelet target version xxxx does not match cluster version xxxx	Versi kubelet yang ditentukan untuk peningkatan tidak sesuai dengan versi lapisan kontrol kluster.	Jika Anda menentukan `kubelet-version`, verifikasi nilainya sesuai dengan versi lapisan kontrol kluster. Jika Anda tidak menentukan parameter ini, ajukan tiket untuk mendapatkan bantuan.
Parameter currentVersion cann't null	Versi edgeadm yang digunakan sudah usang.	Verifikasi bahwa edgeadm adalah versi terbaru. Peningkatan kluster yang didukung adalah dari versi 1.18 ke 1.20 dan dari 1.20 ke 1.22.
upgrade kubelet failed at phase install, recover to previous state. error run phase upgrade: xxxx	Peningkatan gagal dan secara otomatis melakukan rollback. Status node tidak terpengaruh.	Simpan log dan ajukan Tiket.
upgrade kubelet failed at phase install, recover to previous state recover kubelet failed, err: xxx error run phase upgrade: xxxx	Peningkatan dan rollback otomatis keduanya gagal. Status node terpengaruh.	Simpan log dan kirim Tiket.

Kumpulkan informasi diagnostik kluster ACK Edge untuk sebuah node

Jika node dalam kluster ACK Edge Anda mengalami masalah, ikuti langkah-langkah berikut untuk mengumpulkan informasi diagnostiknya.

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

Buat skrip diagnostik dapat dieksekusi.

chmod u+x /usr/local/bin/diagnose_edge_node.sh

Berpindah ke direktori skrip:
```
cd /usr/local/bin/
```

Jalankan skrip diagnostik.

./diagnose_edge_node.sh

Contoh output. Setiap kali dijalankan, skrip akan menghasilkan file diagnostik dengan nama unik, seperti diagnose_1578310147.tar.gz.

......
+ echo 'please get diagnose_1578310147.tar.gz for diagnostics'
please get diagnose_1578310147.tar.gz for diagnostics
+ echo 'Please submit diagnose_1578310147.tar.gz to technical support'
Please submit diagnose_1578310147.tar.gz to technical support

Jalankan ll untuk memverifikasi keberadaan file diagnose_1578310147.tar.gz.