**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:
+ Versi server API Kubernetes
+ Komponen pesawat kontrol dan konfigurasinya
+ Versi platform (kembali ke versi platform terbaru untuk versi Kubernetes sebelumnya)
+ **Node pekerja Mode Otomatis EKS**. Untuk cluster yang menjalankan Mode Otomatis EKS, Amazon EKS secara otomatis mengelola rollback node pekerja Mode Otomatis sebelum mengembalikan bidang kontrol. Untuk informasi selengkapnya, lihat [Rollback Kluster Mode Otomatis EKS](rollback-automode.md).
## Apa yang TIDAK diputar kembali
Komponen berikut tidak digulung kembali:
+ **data ** etcd. Semua status cluster, sumber daya, dan konfigurasi dipertahankan.
+ **Beban kerja pelanggan. ** Pod, penerapan, dan layanan Anda terus berjalan.
+ **Pengaya EKS**. Add-on versi tetap tidak berubah. Anda mengelola ini secara terpisah.
+ **Volume dan data yang persisten**. Semua data pelanggan tetap utuh.
+ **Self-managed node dan node hibrida**. Anda bertanggung jawab untuk menggulungnya kembali.
+ **Grup node terkelola**. Anda harus memutar kembali ini secara terpisah dengan menggunakan `UpdateNodegroupVersion` API.
## Prasyarat
Sebelum Anda dapat memutar kembali cluster, semua kondisi berikut harus dipenuhi:
| Persyaratan | Rincian |
| --- | --- |
| **Jendela 7 hari ** | Anda harus memulai rollback dalam waktu 7 hari setelah peningkatan selesai. Setelah 7 hari, rollback tidak lagi tersedia. |
| **Cluster yang ditingkatkan ** | Cluster harus telah ditingkatkan ke versi saat ini melalui peningkatan di tempat. Cluster yang dibuat pada versi saat ini tidak dapat diputar kembali. |
| **Hanya versi tunggal ** | Anda hanya dapat memutar kembali dengan satu versi minor (N ke N-1). Jika Anda memutakhirkan dari 1.31 ke 1.32 dan kemudian ke 1.33, Anda hanya dapat memutar kembali ke 1.32, bukan ke 1.31. |
| **Versi yang didukung ** | Versi rollback tersedia untuk versi [ Amazon EKS yang ](https://docs.aws.amazon.com/eks/latest/userguide/kubernetes-versions.html#kubernetes-release-calendar) saat ini didukung. |
| **Kebijakan dukungan yang diperpanjang ** | Untuk memutar kembali ke versi yang didukung diperpanjang, Anda harus terlebih dahulu mengubah kebijakan pemutakhiran cluster menjadi`EXTENDED`. |
| **Tidak ada peningkatan otomatis dukungan ekstensif yang berakhir ** | Jika cluster Anda ditingkatkan secara otomatis pada akhir dukungan yang diperpanjang, Anda tidak dapat memutar kembali ke versi sebelumnya. Jika cluster Anda ditingkatkan secara otomatis pada akhir dukungan standar, Anda dapat memutar kembali tetapi harus terlebih dahulu mengubah kebijakan pemutakhiran menjadi`EXTENDED`. |
| **Status klaster ** | Cluster harus dalam `ACTIVE` status. Anda tidak dapat memulai rollback saat pembaruan lain sedang berlangsung. |
| **Kompatibilitas fitur EKS ** | Jika fitur EKS yang diaktifkan pada cluster Anda tidak didukung pada versi sebelumnya, permintaan rollback gagal. Pemeriksaan ini tidak dapat dilewati. `--force` |
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:
1. Tinjau wawasan kesiapan rollback untuk mengidentifikasi masalah apa pun yang mungkin memengaruhi rollback.
1. Selesaikan masalah pemblokiran (wawasan status ERROR) atau gunakan `--force` untuk melewati pemeriksaan wawasan.
1. Verifikasi aplikasi, pengontrol khusus, dan alat pihak ketiga Anda kompatibel dengan versi Kubernetes sebelumnya.
1. Jika node pekerja Anda menjalankan versi Kubernetes yang sama dengan bidang kontrol, putar kembali node pekerja terlebih dahulu.
1. Jika Anda memiliki add-on yang menjalankan versi yang tidak kompatibel dengan versi Kubernetes sebelumnya, turunkan versi ke versi yang kompatibel.
1. Mulai pengembalian pesawat kontrol.
1. Pantau kemajuan rollback.
**penting**
Untuk cluster yang menjalankan EKS Auto Mode, langkah 4 ditangani secara otomatis. Saat Anda memulai rollback, Amazon EKS akan memutar kembali node Mode Otomatis sebelum bidang kontrol. Untuk informasi selengkapnya, lihat [Rollback Kluster Mode Otomatis EKS](rollback-automode.md).
## 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: **
1. Buka [konsol Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).
1. Pilih klaster Anda.
1. Pilih ** tab ** Upgrade wawasan. Wawasan kesiapan rollback muncul di sini setelah peningkatan.
1. Tinjau wawasan apa pun dengan status ERROR atau PERINGATAN.
** 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
```
### 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
```
**catatan**
Amazon EKS secara otomatis menyegarkan wawasan saat Anda memulai rollback untuk memastikan bahwa pemeriksaan dijalankan terhadap status cluster terbaru.
### Perilaku status wawasan
Tabel berikut menjelaskan arti dari setiap status wawasan dan pengaruhnya terhadap rollback:
| Status | Arti | Efek pada rollback |
| --- | --- | --- |
| **MELEWATI ** | Tidak ada masalah yang terdeteksi untuk pemeriksaan ini | Kembalikan diperbolehkan |
| **PERINGATAN ** | Masalah potensial terdeteksi, tidak memblokir | Pengembalian diperbolehkan (hanya penasihat) |
| **ERROR ** | Masalah pemblokiran terdeteksi | Rollback diblokir hingga terselesaikan, atau gunakan `--force` untuk mem-bypass |
| **TIDAK DIKETAHUI ** | Tidak dapat menentukan status | Rollback diblokir hingga terselesaikan, atau gunakan `--force` untuk mem-bypass |
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
```
**Awas**
Menggunakan `--force` melewati semua pemeriksaan wawasan (ERROR, WARNING, UNKNOWN) dan melanjutkan langsung dengan rollback. Amazon EKS tidak dapat menjamin keamanan rollback saat pemeriksaan wawasan dilewati. Anda menerima tanggung jawab penuh atas masalah apa pun yang muncul.
`--force`Bendera 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](rollback-automode.md).
### 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 (`maxUnavailable`atau`maxUnavailablePercentage`) 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
1. Buka [konsol Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).
1. Pilih klaster Anda.
1. Pilih menu tarik- ** turun T ** indakan.
1. Pilih versi ** klaster ** Rollback.
1. Tinjau ringkasan rollback, termasuk peringatan wawasan apa pun.
1. Pilih versi ** ** Rollback.
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](rollback-automode.md).
### 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": []
}
}
```
**catatan**
Amazon EKS menjalankan penyegaran wawasan sebelum melakukan rollback jika data wawasan basi.
## 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: **
1. Buka [konsol Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).
1. Pilih klaster Anda.
1. Pilih ** tab Per ** barui riwayat.
1. Cari ID pembaruan yang terkait dengan rollback untuk melihat statusnya saat ini.
### 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](rollback-automode.md).
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:
+ Amazon EKS bertanggung jawab untuk mengembalikan komponen pesawat kontrol dengan aman.
+ Anda bertanggung jawab untuk memastikan bahwa aplikasi, konfigurasi, dan dependensi Anda kompatibel dengan versi sebelumnya.
+ Anda harus meninjau ketidakcocokan antar versi, menilai cluster Anda untuk paparan, dan mengurangi masalah apa pun.
### 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:
1. Periksa kompatibilitas add-on dengan versi target dengan menggunakan wawasan kesiapan rollback.
1. Jika versi add-on tidak kompatibel dengan versi Kubernetes sebelumnya, turunkan versi terlebih dahulu:
```
aws eks update-addon \
--cluster-name my-cluster \
--addon-name vpc-cni \
--addon-version v1.22.4-eksbuild.3 \
--region us-west-2
```
1. Setelah rollback bidang kontrol selesai, verifikasi semua add-on berfungsi dengan benar.
**catatan**
Wawasan kesiapan rollback hanya memeriksa versi EKS-managed add-on. Untuk add-on yang dikelola sendiri, Anda bertanggung jawab untuk memvalidasi kompatibilitas dengan versi target sebelum memutar kembali.
## Sumber daya terkait
+ [Rollback Kluster Mode Otomatis EKS](rollback-automode.md)
+ [Perbarui klaster yang ada ke versi Kubernetes baru](update-cluster.md)
+ [Mempersiapkan peningkatan versi Kubernetes dan memecahkan masalah kesalahan konfigurasi dengan wawasan klaster](cluster-insights.md)
+ [Memahami siklus hidup versi Kubernetes di Amazon EKS ](https://docs.aws.amazon.com/eks/latest/userguide/kubernetes-versions.html)
+ [Memperbarui grup node terkelola ](https://docs.aws.amazon.com/eks/latest/userguide/update-managed-node-group.html)
+ [Praktik terbaik untuk peningkatan cluster ](https://docs.aws.amazon.com/eks/latest/best-practices/cluster-upgrades.html)