Perbarui klaster yang ada ke versi Kubernetes baru

Untuk memperbarui Kubernetes versi untuk cluster Anda

1. Bandingkan Kubernetes versi bidang kontrol cluster Anda ke Kubernetes versi node Anda.

   • Dapatkan Kubernetes versi pesawat kontrol cluster Anda.

     kubectl version
     

   • Dapatkan Kubernetes versi node Anda. Perintah ini mengembalikan semua node Amazon dan Fargate yang dikelola sendiri EC2 dan dikelola. Setiap Fargate Pod terdaftar sebagai simpulnya sendiri.

     kubectl get nodes
     

   Sebelum memperbarui pesawat kontrol Anda ke yang baru Kubernetes versi, pastikan bahwa Kubernetes versi minor dari node terkelola dan node Fargate di cluster Anda sama dengan versi bidang kontrol Anda. Misalnya, jika bidang kontrol Anda menjalankan versi 1.30 dan salah satu node Anda menjalankan versi1.29, maka Anda harus memperbarui node Anda ke versi 1.30 sebelum memperbarui bidang kontrol Anda ke 1,31. Kami juga merekomendasikan agar Anda memperbarui simpul swakelola ke versi yang sama dengan versi bidang pengendalian Anda sebelum memperbarui bidang pengendalian itu. Untuk informasi selengkapnya, silakan lihat Memperbarui grup node terkelola untuk klaster Anda dan Perbarui node yang dikelola sendiri untuk klaster Anda. Jika Anda memiliki node Fargate dengan versi minor lebih rendah dari versi bidang kontrol, pertama-tama hapus Pod yang diwakili oleh node. Kemudian perbarui pesawat kontrol Anda. Sisanya Pods akan memperbarui ke versi baru setelah Anda menerapkannya kembali.

2. Jika Kubernetes versi yang awalnya Anda gunakan untuk menggunakan cluster Anda adalah Kubernetes 1.25atau nanti, lewati langkah ini.

   Secara default, Pod Pengontrol penerimaan kebijakan keamanan diaktifkan di EKS klaster Amazon. Sebelum memperbarui cluster Anda, pastikan yang tepat Pod Kebijakan keamanan sudah ada. Ini untuk menghindari potensi masalah keamanan. Anda dapat memeriksa kebijakan default dengan kubectl get psp eks.privileged perintah.

   kubectl get psp eks.privileged
   

   Jika Anda menerima kesalahan berikut, lihat Amazon EKS default Pod kebijakan keamanan sebelum melanjutkan.

   Error from server (NotFound): podsecuritypolicies.extensions "eks.privileged" not found

3. Jika Kubernetes versi yang awalnya Anda gunakan untuk menggunakan cluster Anda adalah Kubernetes 1.18atau nanti, lewati langkah ini.

   Anda mungkin perlu menghapus istilah yang dihentikan dari CoreDNS nyata.

   1. Periksa untuk melihat apakah Anda CoreDNS manifes memiliki garis yang hanya memiliki kataupstream.

      kubectl get configmap coredns -n kube-system -o jsonpath='{$.data.Corefile}' | grep upstream
      

      Jika tidak ada output yang dikembalikan, ini berarti manifes Anda tidak memiliki baris. Jika ini masalahnya, lompat ke langkah berikutnya. Jika kata upstream dikembalikan, hapus baris.

   2. Hapus baris di dekat bagian atas file yang hanya memiliki kata upstream dalam file configmap. Jangan mengubah apa pun dalam file. Setelah baris dihapus, simpan perubahannya.

      kubectl edit configmap coredns -n kube-system -o yaml
      

4. Perbarui cluster Anda menggunakan eksctl AWS Management Console,, atau AWS CLI.

   penting

   • Jika Anda memperbarui ke versi 1.23 dan menggunakan EBS volume Amazon di klaster, Anda harus menginstal EBS CSI driver Amazon di klaster sebelum memperbarui klaster ke versi 1.23 untuk menghindari gangguan beban kerja. Untuk informasi selengkapnya, silakan lihat Kubernetes1.23 dan Menyimpan Kubernetes volume dengan Amazon EBS.

   • Kubernetes 1.24 dan kemudian digunakan containerd sebagai runtime container default. Jika Anda beralih ke containerd runtime dan sudah memiliki Fluentd dikonfigurasi untuk Container Insights, maka Anda harus bermigrasi Fluentd kepada Fluent Bit sebelum memperbarui cluster Anda. Bagian Fluentd parser dikonfigurasi untuk hanya mengurai pesan log dalam JSON format. Tidak sepertidockerd, runtime containerd container memiliki pesan log yang tidak dalam JSON format. Jika Anda tidak bermigrasi ke Fluent Bit, beberapa yang dikonfigurasi Fluentd's parser akan menghasilkan sejumlah besar kesalahan di dalam Fluentd wadah. Untuk informasi selengkapnya tentang migrasi, lihat Mengatur Fluent Bit sebagai DaemonSet untuk mengirim log ke CloudWatch Log.

   • Karena Amazon EKS menjalankan bidang kontrol yang sangat tersedia, Anda hanya dapat memperbarui satu versi minor dalam satu waktu. Untuk informasi lebih lanjut tentang persyaratan ini, lihat Kubernetes Versi dan Versi Kebijakan Dukungan Skew. Asumsikan bahwa versi cluster Anda saat ini adalah versi 1.29 dan Anda ingin memperbaruinya ke versi1.31. Anda harus terlebih dahulu memperbarui 1.29 klaster versi Anda ke versi 1.30 dan kemudian memperbarui 1.30 klaster versi Anda ke versi1.31.

   • Tinjau versi miring di antara Kubernetes kube-apiserverdan kubelet pada node Anda.

     • Mulai dari Kubernetes versi1.28, kubelet mungkin hingga tiga versi minor yang lebih tua darikube-apiserver. Lihat Kebijakan miring versi upstream Kubernetes.

     • Jika kubelet pada node terkelola dan Fargate Anda aktif Kubernetes versi 1.25 atau yang lebih baru, Anda dapat memperbarui cluster Anda hingga tiga versi ke depan tanpa memperbarui kubelet versi. Misalnya, jika versi kubelet aktif1.25, Anda dapat memperbarui versi EKS cluster Amazon Anda dari 1.25 ke1.26, ke1.27, dan ke 1.28 sementara versi kubelet tetap ada1.25.

     • Jika kubelet pada node terkelola dan Fargate Anda aktif Kubernetes versi 1.24 atau yang lebih lama, mungkin hanya hingga dua versi minor yang lebih tua dari versikube-apiserver. Dengan kata lain, jika versi kubelet is 1.24 atau lebih lama, Anda hanya dapat memperbarui cluster Anda hingga dua versi ke depan. Misalnya, jika versi on1.21, Anda dapat memperbarui versi EKS cluster Amazon Anda dari 1.21 ke1.22, dan ke1.23, tetapi Anda tidak akan dapat memperbarui cluster untuk 1.24 sementara kubelet tetap aktif1.21. kubelet

   • Sebagai praktik terbaik sebelum memulai pembaruan, pastikan bahwa kubelet pada node Anda sama Kubernetes versi sebagai pesawat kontrol Anda.

   • Jika klaster Anda dikonfigurasi dengan versi Amazon VPC CNI plugin for Kubernetes yang lebih awal dari1.8.0, maka kami sarankan Anda memperbarui plugin ke versi terbaru sebelum memperbarui cluster Anda. Untuk memperbarui plugin, lihatTetapkan ke IPs Pods dengan Amazon VPC CNI.

   • Jika Anda memperbarui cluster Anda ke versi 1.25 atau yang lebih baru dan memiliki AWS Load Balancer Controller disebarkan di cluster Anda, lalu perbarui pengontrol ke versi 2.4.7 atau yang lebih baru sebelum memperbarui versi cluster Anda ke1.25. Untuk informasi selengkapnya, lihat catatan Kubernetes1,25 rilis.

   eksctl

   Prosedur ini membutuhkan eksctl versi 0.191.0 atau yang lebih baru. Anda dapat memeriksa versi Anda dengan perintah berikut:

   eksctl version
   

   Untuk petunjuk tentang cara menginstal dan memperbaruieksctl, lihat Instalasi dalam eksctl dokumentasi.

   Perbarui Kubernetes versi pesawat EKS kontrol Amazon Anda. Ganti gugus saya dengan nama cluster Anda. Ganti 1.31 dengan nomor versi yang EKS didukung Amazon yang ingin Anda perbarui cluster Anda. Untuk daftar nomor versi yang didukung, lihatMemahami Kubernetes siklus hidup versi aktif EKS.

   eksctl upgrade cluster --name my-cluster --version 1.31 --approve
   

   Pembaruan memerlukan waktu beberapa menit.

   AWS Management Console

   1. Buka EKS konsol Amazon di https://console.aws.amazon.com/eks/rumah#/cluster.

   2. Pilih nama EKS kluster Amazon untuk diperbarui dan pilih Perbarui versi cluster.

   3. Untuk Kubernetes versi, pilih versi untuk memperbarui cluster Anda dan pilih Perbarui.

   4. Untuk nama Cluster, masukkan nama klaster Anda dan pilih Konfirmasi.

      Pembaruan memerlukan waktu beberapa menit.

   AWS CLI

   1. Perbarui EKS cluster Amazon Anda dengan AWS CLI perintah berikut. Ganti nilai contoh dengan milikmu sendiri. Ganti 1.31 dengan nomor versi yang EKS didukung Amazon yang ingin Anda perbarui cluster Anda. Untuk daftar nomor versi yang didukung, lihatMemahami Kubernetes siklus hidup versi aktif EKS.

      aws eks update-cluster-version --region region-code --name my-cluster --kubernetes-version 1.31
      

      Contoh output adalah sebagai berikut.

      {
          "update": {
              "id": "b5f0ba18-9a87-4450-b5a0-825e6e84496f",
              "status": "InProgress",
              "type": "VersionUpdate",
              "params": [
                  {
                      "type": "Version",
                      "value": "1.31"
                  },
                  {
                      "type": "PlatformVersion",
                      "value": "eks.1"
                  }
              ],
      [...]
              "errors": []
          }
      }

   2. Pantau status pembaruan klaster Anda dengan perintah berikut. Gunakan nama klaster dan perbarui ID yang telah dikembalikan dengan perintah sebelumnya. Ketika Successful status ditampilkan, pembaruan selesai. Pembaruan memerlukan waktu beberapa menit.

      aws eks describe-update --region region-code --name my-cluster --update-id b5f0ba18-9a87-4450-b5a0-825e6e84496f
      

      Contoh output adalah sebagai berikut.

      {
          "update": {
              "id": "b5f0ba18-9a87-4450-b5a0-825e6e84496f",
              "status": "Successful",
              "type": "VersionUpdate",
              "params": [
                  {
                      "type": "Version",
                      "value": "1.31"
                  },
                  {
                      "type": "PlatformVersion",
                      "value": "eks.1"
                  }
              ],
      [...]
              "errors": []
          }
      }

5. Setelah pembaruan klaster Anda selesai, perbarui node Anda ke yang sama Kubernetes versi minor sebagai kluster Anda yang diperbarui. Untuk informasi selengkapnya, silakan lihat Perbarui node yang dikelola sendiri untuk klaster Anda dan Memperbarui grup node terkelola untuk klaster Anda. Yang baru Pods yang diluncurkan di Fargate memiliki kubelet versi yang cocok dengan versi cluster Anda. Fargate yang ada Pods tidak berubah.

6. (Opsional) Jika Anda menerapkan Kubernetes Cluster Autoscaler ke klaster Anda sebelum memperbarui cluster, perbarui Cluster Autoscaler ke versi terbaru yang cocok Kubernetes versi mayor dan minor yang Anda perbarui.

   1. Buka halaman rilis Cluster Autoscaler di browser web dan temukan versi Cluster Autoscaler terbaru yang cocok dengan klaster Anda Kubernetes versi mayor dan minor. Misalnya, jika klaster Anda Kubernetes versi adalah 1.31 temukan rilis Cluster Autoscaler terbaru yang dimulai dengan. 1.31 Catat nomor versi semantik (1.31.n, misalnya) untuk rilis yang akan digunakan pada langkah berikutnya.

   2. Atur citra label Klaster Autoscaler ke versioning yang Anda simpan pada langkah sebelumnya menggunakan perintah berikut. Jika perlu, ganti 1.31.n dengan nilai Anda sendiri.

      kubectl -n kube-system set image deployment.apps/cluster-autoscaler cluster-autoscaler=registry.k8s.io/autoscaling/cluster-autoscaler:v1.31.n
      

7. (Cluster dengan GPU node saja) Jika cluster Anda memiliki grup node dengan GPU dukungan (misalnya,p3.2xlarge), Anda harus memperbarui plugin NVIDIA perangkat untuk Kubernetes DaemonSet di cluster Anda. Ganti vX.X.X dengan NVIDIAs-device-pluginversi/k8 yang Anda inginkan sebelum menjalankan perintah berikut.

   kubectl apply -f https://raw.githubusercontent.com/NVIDIA/k8s-device-plugin/vX.X.X/deployments/static/nvidia-device-plugin.yml
   

8. Perbarui Amazon VPC CNI plugin for Kubernetes, CoreDNS, dan kube-proxy add-on. Kami menyarankan untuk memperbarui add-on ke versi minimum yang tercantum dalam token akun Layanan.

   • Jika Anda menggunakan EKS add-on Amazon, pilih Cluster di EKS konsol Amazon, lalu pilih nama cluster yang Anda perbarui di panel navigasi kiri. Pemberitahuan muncul di konsol. Mereka memberi tahu Anda bahwa versi baru tersedia untuk setiap add-on yang memiliki pembaruan yang tersedia. Untuk memperbarui add-on, pilih tab Add-ons. Di salah satu kotak untuk add-on yang memiliki pembaruan yang tersedia, pilih Perbarui sekarang, pilih versi yang tersedia, lalu pilih Perbarui.

   • Sebagai alternatif, Anda dapat menggunakan AWS CLI atau eksctl untuk memperbarui add-on. Untuk informasi selengkapnya, lihat Memperbarui EKS add-on Amazon.

9. Jika perlu, perbarui versi Andakubectl. Anda harus menggunakan kubectl versi yang berada dalam satu perbedaan versi minor dari bidang kontrol EKS cluster Amazon Anda. Misalnya, 1.30 kubectl klien bekerja dengan Kubernetes 1.29,1.30, dan 1.31 cluster. Anda dapat memeriksa versi yang saat ini diinstal dengan perintah berikut.

   kubectl version --client