Masalah umum saat menambahkan node edge - Container Service for Kubernetes

Topik ini menjawab pertanyaan umum mengenai node edge dalam kluster ACK Edge dan menyediakan solusi untuk masalah umum.

Membedakan antara node cloud dan node edge

ACK Edge menggunakan label alibabacloud.com/is-edge-worker untuk menentukan apakah suatu node merupakan node edge.

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

Tambahkan node edge melalui Express Connect

Perhatikan persyaratan berikut saat menambahkan node edge ke kluster ACK Edge melalui Express Connect. Untuk informasi selengkapnya, lihat Konfigurasi khusus untuk kluster ACK Edge dalam skenario Express Connect.

Saat membuat kelompok node edge, pilih Dedicated sebagai tipe kelompok node. Kemudian, buat skrip koneksi node dengan mengikuti langkah-langkah dalam Tambahkan node edge.

Untuk informasi lebih lanjut tentang kelompok node dedicated, lihat Kelola kelompok node edge.

Catatan
Jika kluster ACK Edge Anda menggunakan versi 1.22 atau yang lebih baru, Anda tidak dapat menggunakan parameter inDedicatedNetwork dalam skrip koneksi node untuk menambahkan node melalui sirkuit Express Connect. Jika versi kluster Anda sebelum 1.22, lakukan upgrade kluster terlebih dahulu.
Pastikan node tersebut dapat terhubung ke semua layanan cloud yang diperlukan, seperti OSS, Container Registry, dan SLB.

Tambahkan node berakselerasi GPU

Instal driver GPU sebelum menambahkan node.
Untuk informasi mengenai versi driver yang didukung, lihat Versi driver NVIDIA yang didukung oleh ACK.

Saat membuat skrip koneksi node, Anda harus mengonfigurasi parameter gpuVersion. Tabel berikut mencantumkan versi GPU yang didukung.

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 ke model GPU yang Anda gunakan, misalnya Nvidia_Tesla_T4. Contoh konfigurasinya sebagai berikut:

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

Setelah Anda mengonfigurasi parameter tersebut, tool koneksi akan secara otomatis menginstal nvidia-containerd-runtime. Untuk informasi selengkapnya, lihat NVIDIA Container Runtime.

Atasi kegagalan skrip koneksi node

Jika skrip gagal dijalankan, gunakan tabel berikut untuk mengatasi masalah tersebut. Jika masalah tidak tercantum, kumpulkan informasi diagnostik untuk node tersebut dan submit a ticket. Untuk informasi cara mengumpulkan informasi diagnostik untuk node edge, lihat Cara mengumpulkan informasi diagnostik untuk node dalam kluster ACK Edge.

Pesan error	Penyebab	Solusi
The os XXX unsupport	Sistem operasi node edge tidak didukung.	Untuk daftar sistem operasi yang didukung untuk node edge, 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 diawali dengan "localhost".
Node route overlaps with service cidr	Tabel rute node bertentangan dengan blok CIDR pod atau blok CIDR layanan yang dikonfigurasi saat kluster dibuat.	Buat ulang kluster tersebut. Pastikan blok CIDR pod dan blok CIDR 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.	Saat edgeadm menambahkan node edge, alamat ini digunakan untuk mengakses API server. Periksa apakah aturan daftar kontrol akses (ACL) pada instans SLB API server membatasi akses dari alamat ini.
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	Instalasi edge-hub gagal karena file biner edge-hub sudah ada di node.	Jalankan perintah `edgeadm reset` untuk membersihkan node, lalu tambahkan kembali node tersebut.
error run phase post-check: timed out waiting for the condition	Komponen sistem gagal dimulai.	Unduh ulang tool edgeadm. Jalankan perintah `edgeadm reset` dan tambahkan kembali node tersebut. Pastikan Anda menggunakan versi edgeadm terbaru. Periksa apakah node edge dapat mengakses titik akhir publik yang diperlukan. Untuk daftar titik akhir, lihat Manajemen jaringan. Kumpulkan informasi diagnostik untuk node edge dan kirimkan Tiket. Untuk informasi selengkapnya tentang cara mengumpulkan informasi diagnostik, lihat Cara mengumpulkan informasi diagnostik untuk node di Kluster ACK Edge.

Kegagalan upgrade node edge

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

Pesan error	Penyebab	Solusi
edgeadm version xxxx does not match cluster version	Versi tool upgrade tidak sesuai dengan versi kluster.	Periksa apakah lapisan kontrol kluster telah di-upgrade. Periksa apakah parameter `TARGET_CLUSTER_VERSION` dikonfigurasi dengan benar.
node has already been upgraded to xxx	Node sudah berada pada versi target.	Jika Anda mengonfirmasi bahwa beberapa komponen pada node tidak ditingkatkan, simpan log dan ajukan tiket.
kubelet target version xxxx does not match cluster version xxxx	Versi kubelet yang ditentukan untuk upgrade tidak sesuai dengan versi lapisan kontrol kluster.	Jika Anda menentukan parameter `kubelet-version`, periksa apakah nilainya benar dan sesuai dengan versi lapisan kontrol kluster. Jika Anda tidak menentukan parameter ini, kirim Tiket untuk mendapatkan bantuan.
Parameter currentVersion cann't null	Versi edgeadm yang digunakan sudah usang.	Periksa apakah versi edgeadm yang digunakan adalah versi terbaru. Upgrade 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	Upgrade gagal dan secara otomatis dikembalikan ke kondisi sebelumnya. 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	Upgrade gagal, dan proses rollback otomatis juga gagal. Status node terpengaruh.	Simpan log dan ajukan Tiket.

Kumpulkan informasi diagnostik kluster ACK Edge untuk sebuah node

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

Jalankan perintah berikut untuk mengunduh 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

Jalankan perintah berikut untuk memberikan izin eksekusi pada skrip diagnostik.
```
chmod u+x /usr/local/bin/diagnose_edge_node.sh
```
Jalankan perintah berikut:
```
cd /usr/local/bin/
```
Jalankan perintah berikut untuk menjalankan skrip diagnostik.
```
./diagnose_edge_node.sh
```
Outputnya mirip dengan berikut: Setiap kali Anda menjalankan skrip, file informasi diagnostik dengan nama berbeda akan dihasilkan. Dalam contoh ini, file tersebut bernama diagnose_1578310147.tar.gz. Nama file aktualnya bervariasi.
```
......
+ 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 perintah ll untuk memverifikasi bahwa file informasi diagnostik diagnose_1578310147.tar.gz tersedia.