All Products
Search
Document Center

Container Service for Kubernetes:Upgrade Versi Platform ECI

Last Updated:Oct 17, 2026

Saat melakukan upgrade kluster, sistem secara otomatis memeriksa kompatibilitas antara Versi Platform ECI dan Kubernetes. Jika Pod berbasis ECI memiliki Versi Platform ECI yang tidak kompatibel dengan versi Kubernetes target, Anda harus menghapus dan membuat ulang Pod tersebut secara manual sebelum meng-upgrade versi Kubernetes pada kluster. Pastikan Versi Platform ECI kompatibel dengan versi Kubernetes sebelum memulai upgrade kluster.

Ikhtisar Versi Platform ECI

Versi Platform ECI merupakan nomor versi lingkungan runtime spesifik pada infrastruktur Elastic Container Instance (ECI). Setiap Versi Platform ECI mengidentifikasi lingkungan runtime ECI yang berbeda. Revisi baru Versi Platform ECI dirilis seiring perkembangan lingkungan runtime ECI, misalnya saat fitur ditambahkan, bug diperbaiki, atau patch diperbarui.

Secara default, Pod berbasis ECI yang dibuat di kluster ACK memiliki annotation dengan kunci k8s.aliyun.com/eci-platform-version. Nilainya adalah nomor Versi Platform ECI. Contoh berikut menunjukkan annotation tersebut:

apiVersion: v1
kind: Pod
metadata:
  annotations:
    k8s.aliyun.com/eci-platform-version: 1.0.0
  name: demo-76d8d9f9d8-l7pwm
  namespace: default
...

Versi Kubernetes yang kompatibel dengan Versi Platform ECI

Seperti yang ditunjukkan pada tabel berikut, setiap Versi Platform ECI kompatibel dengan versi Kubernetes tertentu.

Penting

Versi Platform ECI untuk Pod berbasis ECI yang baru dibuat adalah 1.1.0. Versi Platform ECI untuk Pod berbasis ECI yang sudah ada adalah 1.0.0 atau kosong.

Versi Platform ECI

Versi Kubernetes yang kompatibel

1.1.0

1.12 dan yang lebih baru

1.0.0

1.12, 1.14, 1.16, 1.18, 1.20, 1.22, dan 1.24

Kosong

(annotation k8s.aliyun.com/eci-platform-version tidak ada)

1.12, 1.14, 1.16, 1.18, 1.20, 1.22, dan 1.24

Upgrade Versi Platform ECI

  1. Hubungkan ke kluster. Untuk petunjuk selengkapnya, lihat Mendapatkan KubeConfig kluster dan menghubungkan ke kluster menggunakan kubectl.

  2. Dapatkan informasi tentang Pod berbasis ECI yang memiliki Versi Platform ECI kosong atau 1.0.0.

    Informasi ini mencakup namespace, nama, Versi Platform ECI, dan ID instans ECI dari setiap Pod berbasis ECI. Bidang-bidang tersebut dipisahkan oleh koma (,).

    kubectl get pods -A -o json | jq -r '.items[] | select(.metadata.annotations["k8s.aliyun.com/eci-platform-version"] == "1.0.0" or .metadata.annotations["k8s.aliyun.com/eci-platform-version"] == null or .metadata.annotations["k8s.aliyun.com/eci-platform-version"] == "") | select(.spec.nodeName | startswith("virtual-kubelet")) | "\(.metadata.namespace),\(.metadata.name),\(.metadata.annotations["k8s.aliyun.com/eci-platform-version"] // ""),\(.metadata.annotations["k8s.aliyun.com/eci-instance-id"])"'

    Contoh berikut menunjukkan outputnya:

    default,portal-server-57dfc4fdc8-2gl64,,eci-2zecdr8z5jy******
  3. Hapus dan buat ulang Pod berbasis ECI target.

    Contoh berikut menunjukkan perintahnya:

    kubectl delete pod portal-server-57dfc4fdc8-2gl64 -n default

    Contoh berikut menunjukkan outputnya:

    pod "portal-server-57dfc4fdc8-2gl64" deleted

    Setelah menghapus dan membuat ulang Pod berbasis ECI, Versi Platform ECI pada Pod baru akan secara otomatis di-upgrade ke versi terbaru. Jalankan perintah berikut untuk memverifikasi Versi Platform ECI.

    kubectl get pods -A -o json | jq -r '.items[] | select(.spec.nodeName | startswith("virtual-kubelet")) | "\(.metadata.namespace),\(.metadata.name),\(.metadata.annotations["k8s.aliyun.com/eci-platform-version"] // ""),\(.metadata.annotations["k8s.aliyun.com/eci-instance-id"] // "")"'