All Products
Search

This Product

    Container Service for Kubernetes:Upgrade edge node

    Document Center

    Container Service for Kubernetes:Upgrade edge node

    Last Updated:Jun 17, 2026

    Setelah lapisan kontrol ditingkatkan, jalankan perintah upgrade secara manual pada setiap edge node.

    Prasyarat

    Sebelum memulai:

    • Lapisan kontrol kluster tepi ACK telah ditingkatkan. Lihat Upgrade kluster Tepi ACK.

    • Jenis mode interkoneksi edge node telah diidentifikasi: basic (jaringan publik) atau private (sirkuit Express Connect).

    Batasan

    Constraint Details
    Rentang versi yang didukung Versi 1.18 hingga 1.24: gunakan langkah-langkah ini. Versi 1.26 hingga 1.30: submit a ticket untuk menghubungi tim Container Service. Versi lainnya: tidak didukung.
    Upgrade versi minor secara berurutan Setiap upgrade hanya meningkatkan satu versi minor. Untuk naik dari 1.18 ke 1.22, lakukan dalam dua langkah: 1.18 → 1.20, lalu 1.20 → 1.22.
    Perbedaan versi antara lapisan kontrol dan edge node Lapisan kontrol dan edge node boleh berbeda paling banyak dua versi minor. Misalnya, jika lapisan kontrol menjalankan versi 1.22, edge node harus menjalankan minimal versi 1.20. Usahakan agar versi tetap selaras bila memungkinkan.
    Ukuran batch Lakukan upgrade maksimal 20 node per batch untuk membatasi dampak.
    Node cloud Lihat Upgrade kelompok node on-cloud.

    Upgrade edge node

    Ikuti langkah-langkah sesuai runtime kontainer Anda.

    Jika runtime adalah Docker (upgrade ke 1.24)

    Kubernetes 1.24 menghentikan dukungan terhadap runtime Docker. Lakukan migrasi dari Docker ke containerd sebelum upgrade ke 1.24.

    Opsi 1 (disarankan): Migrasi rolling ke kelompok node baru

    1. Buat kelompok node dengan containerd. Lihat Manajemen kelompok node tepi.

    2. Migrasikan workload ke kelompok node baru:

    3. Nonaktifkan kelompok node lama setelah semua workload berhasil dimigrasikan.

    Opsi 2: Pembaruan in-place

    Me-restart semua kontainer pada node tersebut.

    1. Ubah runtime kontainer dari Docker ke containerd.

    2. Lakukan drain pada node sebelum upgrade. Lihat Status penjadwalan dan draining node.

    3. Upgrade setiap node satu per satu:

      Parameter Description Example
      TARGET_CLUSTER_VERSION Versi Kubernetes dari lapisan kontrol yang telah diperbarui 1.24.6-aliyunedge.1 — lihat Catatan rilis untuk versi Kubernetes yang didukung
      REGION ID wilayah kluster cn-hangzhou — lihat Wilayah yang didukung
      INTERCONNECT_MODE Jenis jaringan: basic untuk jaringan publik, private untuk sirkuit Express Connect basic 
      export REGION="" INTERCONNECT_MODE="" TARGET_CLUSTER_VERSION=""; export ARCH=$(uname -m | awk '{print ($1 == "x86_64") ? "amd64" : (($1 == "aarch64") ? "arm64" : "amd64")}') INTERNAL=$( [ "$INTERCONNECT_MODE" = "private" ] && echo "-internal" || echo "" ); wget http://aliacs-k8s-${REGION}.oss-${REGION}${INTERNAL}.aliyuncs.com/public/pkg/run/attach/${TARGET_CLUSTER_VERSION}/${ARCH}/edgeadm -O edgeadm; chmod u+x edgeadm;./edgeadm upgrade --interconnect-mode=${INTERCONNECT_MODE} --region=${REGION}

      Tetapkan parameter-parameter ini sebelum menjalankan perintah:

    4. Verifikasi bahwa upgrade berhasil. Output menampilkan:

      This node has been upgraded successfully

      Upgrade success output

    Jika runtime bukan Docker

    Upgrade setiap node satu per satu:

    export REGION="" INTERCONNECT_MODE="" TARGET_CLUSTER_VERSION=""; export ARCH=$(uname -m | awk '{print ($1 == "x86_64") ? "amd64" : (($1 == "aarch64") ? "arm64" : "amd64")}') INTERNAL=$( [ "$INTERCONNECT_MODE" = "private" ] && echo "-internal" || echo "" ); wget http://aliacs-k8s-${REGION}.oss-${REGION}${INTERNAL}.aliyuncs.com/public/pkg/run/attach/${TARGET_CLUSTER_VERSION}/${ARCH}/edgeadm -O edgeadm; chmod u+x edgeadm;./edgeadm upgrade --interconnect-mode=${INTERCONNECT_MODE} --region=${REGION}

    Tetapkan parameter-parameter ini sebelum menjalankan perintah:

    Parameter Description Example
    TARGET_CLUSTER_VERSION Versi Kubernetes dari lapisan kontrol yang telah diperbarui 1.24.6-aliyunedge.1 — lihat Catatan rilis untuk versi Kubernetes yang didukung
    REGION ID wilayah kluster cn-hangzhou — lihat Wilayah yang didukung
    INTERCONNECT_MODE Jenis jaringan: basic untuk jaringan publik, private untuk sirkuit Express Connect basic

    Verifikasi bahwa upgrade berhasil. Output menampilkan:

    This node has been upgraded successfully
    Upgrade success output

    FAQ

    Apa yang harus saya lakukan jika upgrade edge node gagal?

    Jika output tidak mencantumkan This node has been upgraded successfully, lihat Apa yang harus saya lakukan jika edge node gagal di-upgrade saat saya melakukan upgrade kluster Tepi ACK?.

    Langkah selanjutnya