Bantu meningkatkan halaman ini

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Untuk berkontribusi pada panduan pengguna ini, pilih GitHub tautan Edit halaman ini di yang terletak di panel kanan setiap halaman.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Kembalikan cluster ke versi Kubernetes sebelumnya

Dengan rollback versi Amazon EKS, Anda dapat mengembalikan bidang kontrol Kubernetes cluster Anda ke versi minor sebelumnya setelah melakukan peningkatan di tempat. Jika Anda mengalami masalah setelah memutakhirkan, seperti ketidakcocokan aplikasi, penggunaan API yang tidak digunakan lagi, atau perilaku tak terduga, Anda dapat memutar kembali untuk memulihkan cluster ke status baik yang diketahui.

Selama rollback, Amazon EKS mengembalikan server API Kubernetes dan komponen bidang kontrol ke versi sebelumnya sambil mempertahankan semua data etcd, beban kerja pelanggan, dan volume persisten.

Apa yang digulirkan kembali

Komponen berikut digulung kembali:

Apa yang TIDAK diputar kembali

Komponen berikut tidak digulung kembali:

Prasyarat

Sebelum Anda dapat memutar kembali cluster, semua kondisi berikut harus dipenuhi:

Selain persyaratan sebelumnya, kondisi tertentu membuat rollback tidak mungkin bahkan dengan --force bendera. Kondisi ini termasuk yang berikut: cluster dibuat pada versi saat ini, lebih dari 7 hari telah berlalu sejak peningkatan, cluster telah ditingkatkan lagi ke versi yang lebih baru, atau fitur EKS yang tidak kompatibel ke belakang diaktifkan pada batas versi saat ini.

Ringkasan

Berikut ini adalah ringkasan tingkat tinggi dari proses rollback cluster Amazon EKS:

Langkah 1: Tinjau wawasan kesiapan rollback

Amazon EKS secara otomatis mengevaluasi cluster Anda terhadap serangkaian pemeriksaan kesiapan rollback point-in-time dan memunculkan masalah apa pun melalui wawasan cluster di bawah kategori. ROLLBACK_READINESS Wawasan ini muncul setelah Anda melakukan peningkatan dan tetap tersedia selama jendela kelayakan rollback 7 hari.

Melihat wawasan kesiapan rollback

AWS Konsol:

AWS CLI:

aws eks list-insights \
  --cluster-name my-cluster \
  --region us-west-2 \
  --filter '{"categories": ["ROLLBACK_READINESS"]}'

Untuk mendapatkan detail tentang wawasan tertentu:

aws eks describe-insight \
  --cluster-name my-cluster \
  --region us-west-2 \
  --id <insight-id>

Wawasan yang menyegarkan

Amazon EKS menyegarkan wawasan setiap 24 jam. Anda dapat memicu penyegaran secara manual setelah menyelesaikan masalah dengan memilih tombol Refresh di konsol Amazon EKS, atau dengan menggunakan CLI:

aws eks start-insights-refresh \
  --cluster-name my-cluster \
  --region us-west-2

Perilaku status wawasan

Tabel berikut menjelaskan arti dari setiap status wawasan dan pengaruhnya terhadap rollback:

Wawasan dengan status ER ROR atau UN KNOWN memblokir rollback. Wawasan dengan status PASSING atau WARNING tidak menghalangi Anda untuk memutar kembali.

Pemeriksaan kesiapan rollback

Amazon EKS melakukan serangkaian pemeriksaan sebagai bagian dari wawasan kesiapan rollback. Pemeriksaan ini mengevaluasi kompatibilitas penggunaan API (termasuk deteksi perubahan tingkat bidang), kesehatan cluster, kemiringan versi kubelet, kemiringan versi kube-proxy, dan kompatibilitas versi add-on. Untuk cluster yang menjalankan Mode Otomatis EKS, pemeriksaan tambahan mengevaluasi anggaran NodePool gangguan, anotasi jangan ganggu, dan konfigurasi. PodDisruptionBudget

Menggunakan bendera --force

Jika wawasan kesiapan rollback menunjukkan status ERROR dan Anda ingin melanjutkan tanpa menyelesaikan masalah, Anda dapat menggunakan tanda --force untuk melewati semua pemeriksaan wawasan:

aws eks update-cluster-version \
  --name my-cluster \
  --kubernetes-version 1.30 \
  --force \
  --region us-west-2

--forceBendera hanya melewati pemeriksaan wawasan. Itu tidak melewati validasi prasyarat seperti jendela 7 hari, pemeriksaan versi pembuatan, atau pemeriksaan rollback berurutan. Untuk cluster Mode Otomatis, --force tidak mengesampingkan kontrol gangguan. NodePool anggaran gangguan, PDB, dan anotasi yang tidak mengganggu masih dihormati.

Langkah 2: Siapkan node pekerja

Sebelum memutar kembali bidang kontrol, pastikan node pekerja Anda kompatibel dengan versi target. Kebijakan miring versi Kubernetes mengharuskan node pekerja tidak dapat menjalankan versi yang lebih baru dari bidang kontrol.

Mode Otomatis EKS

Tidak ada tindakan diperlukan. Saat Anda memulai rollback, Amazon EKS secara otomatis memutar kembali node Mode Otomatis sebelum bidang kontrol. Untuk informasi selengkapnya, lihat Rollback Kluster Mode Otomatis EKS.

Grup node terkelola (MNG)

Anda harus memutar kembali grup node terkelola Anda ke versi sebelumnya sebelum memutar kembali bidang kontrol. Gunakan UpdateNodegroupVersion API:

aws eks update-nodegroup-version \
  --cluster-name my-cluster \
  --nodegroup-name my-nodegroup \
  --kubernetes-version 1.30 \
  --region us-west-2

Pembaruan grup simpul menghormati pengaturan pembaruan yang dikonfigurasi (maxUnavailableataumaxUnavailablePercentage) dan strategi pembaruan (Rolling atau Force).

Self-managed node dan node hibrida

Anda bertanggung jawab untuk memutar kembali node yang dikelola sendiri dan node hybrid. Perbarui AMI atau konfigurasi node Anda untuk menggunakan versi Kubernetes sebelumnya sebelum memutar kembali bidang kontrol.

Fargate

Versi rollback tidak didukung untuk node pekerja Fargate. Anda dapat memutar kembali bidang kontrol cluster yang menggunakan Fargate, tetapi pod Fargate yang menjalankan versi Kubernetes yang sama sebagai bidang kontrol memicu wawasan miring versi kubelet dengan status ERROR.

Amazon EKS tidak dapat secara otomatis mengembalikan pod Fargate ke versi kubelet yang lebih lama.

Solusi: Jika Anda memiliki pod Fargate yang menjalankan versi Kubernetes yang sama dengan bidang kontrol, hapus pod tersebut sebelum memulai rollback. Kemudian putar kembali pesawat kontrol Anda. Pod yang tersisa diluncurkan dengan versi rolled-back saat Anda menyebarkannya kembali.

Atau, gunakan --force untuk melewati pemeriksaan wawasan. Namun, melanjutkan dengan pelanggaran kemiringan versi kubelet dapat mengakibatkan perilaku tak terduga untuk beban kerja Fargate Anda sampai pod tersebut diganti.

Langkah 3: Putar kembali bidang kontrol cluster

Anda dapat memulai rollback dengan menggunakan Kon AWS sol, AWS CLI, atau EKS API.

Putar kembali cluster dengan menggunakan AWS Konsol

Rollback membutuhkan waktu beberapa menit untuk menyelesaikannya. Untuk cluster Mode Otomatis, fase rollback node mungkin memakan waktu lebih lama. Untuk informasi selengkapnya, lihat Rollback Kluster Mode Otomatis EKS.

Putar kembali cluster dengan menggunakan AWS CLI

Gunakan update-cluster-version perintah yang ada dengan versi Kubernetes sebelumnya (N-1):

aws eks update-cluster-version \
  --name my-cluster \
  --kubernetes-version 1.30 \
  --region us-west-2

Contoh respons:

{
    "update": {
        "id": "e4091a28-ea14-48fd-a8c7-975aeb469e8a",
        "status": "InProgress",
        "type": "VersionRollback",
        "params": [
            {
                "type": "Version",
                "value": "1.30"
            },
            {
                "type": "PlatformVersion",
                "value": "eks.16"
            }
        ],
        "createdAt": "2026-05-12T16:56:01.082000-04:00",
        "errors": []
    }
}

Langkah 4: Pantau kemajuan rollback

Anda dapat memantau status rollback cluster Anda dengan menggunakan konsol Amazon EKS atau AWS CLI.

AWS CLI:

aws eks describe-update \
  --name my-cluster \
  --region us-west-2 \
  --update-id e4091a28-ea14-48fd-a8c7-975aeb469e8a

AWS Konsol:

Transisi status

Untuk cluster standar (tanpa Mode Otomatis):

InProgress → Successful
InProgress → Failed

Untuk cluster Mode Otomatis, status cluster tetap ada ACTIVE saat node bergulir kembali dan berubah menjadi UPDATING hanya ketika rollback bidang kontrol dimulai. Gunakan describe-update untuk melacak kemajuan rollback secara keseluruhan. Untuk informasi selengkapnya, lihat Rollback Kluster Mode Otomatis EKS.

Ketika Successful status ditampilkan, rollback selesai.

Pertimbangan dan peringatan

Wawasan adalah upaya terbaik dan titik waktu

Wawasan cluster dievaluasi pada saat rollback dipicu. Jika Anda membuat perubahan pada cluster setelah wawasan diperiksa tetapi sebelum rollback selesai (misalnya, membuat sumber daya menggunakan API baru), perubahan tersebut tidak ditangkap oleh pemeriksaan wawasan awal dan dapat menyebabkan masalah setelah rollback selesai.

pelestarian data etcd

Amazon EKS menyimpan data etcd selama rollback. Sumber daya yang tidak kompatibel dilewati dengan menggunakan --force bendera tetap ada dan bukan sampah yang dikumpulkan.

Biaya dukungan yang diperpanjang

Jika Anda memutar kembali dari versi di bawah dukungan standar ke versi di bawah dukungan diperpanjang, cluster Anda mulai dikenakan biaya dukungan tambahan. Misalnya, jika Anda meningkatkan dari 1,30 (dukungan diperpanjang) ke 1,31 (dukungan standar) dan kemudian memutar kembali ke 1,30, biaya dukungan diperpanjang akan dilanjutkan.

Model tanggung jawab bersama untuk rollback

Amazon EKS mengembalikan bidang kontrol Kubernetes ke versi yang diinginkan. Sebagai bagian dari model tanggung jawab bersama, Anda bertanggung jawab untuk memverifikasi kompatibilitas aplikasi dengan versi sebelumnya:

CloudFormation perilaku rollback tumpukan

Jika pembaruan CloudFormation stack AWS gagal dan memicu rollback tumpukan, pengembalian ke versi template sebelumnya yang menentukan versi Kubernetes yang lebih rendah tidak memicu rollback versi cluster. Versi rollback harus dimulai secara eksplisit melalui UpdateClusterVersion API, CLI, atau konsol.

Rollback dan add-on

Amazon EKS tidak secara otomatis mengembalikan versi add-on selama rollback versi cluster. Anda harus mengelola versi add-on secara terpisah.

Sebelum memutar kembali bidang kontrol:

Sumber daya terkait