Perbarui Amazon VPC CNI (add-on Amazon EKS)

Perbarui jenis Amazon EKS dari Amazon VPC CNI plugin for Kubernetes add-on. Jika Anda belum menambahkan jenis add-on Amazon EKS ke cluster Anda, Anda dapat menginstalnya dengan mengikutiBuat Amazon VPC CNI (add-on Amazon EKS). Atau, perbarui jenis instalasi VPC CNI lainnya dengan mengikuti. Perbarui Amazon VPC CNI (add-on yang dikelola sendiri)

1. Lihat versi add-on mana yang diinstal pada cluster Anda. Ganti my-cluster dengan nama klaster Anda.

   aws eks describe-addon --cluster-name my-cluster --addon-name vpc-cni --query "addon.addonVersion" --output text

   Contoh output adalah sebagai berikut.

   v1.16.4-eksbuild.2

   Bandingkan versi dengan tabel versi terbaru diAmazon VPC CNI versi. Jika versi yang dikembalikan sama dengan versi untuk klaster Anda Kubernetes versi dalam tabel versi terbaru, maka Anda sudah memiliki versi terbaru yang diinstal pada cluster Anda dan tidak perlu menyelesaikan sisa prosedur ini. Jika Anda menerima kesalahan, alih-alih nomor versi dalam output Anda, maka Anda tidak memiliki jenis add-on Amazon EKS yang diinstal pada cluster Anda. Anda perlu membuat add-on sebelum Anda dapat memperbaruinya dengan prosedur ini. Untuk membuat jenis Amazon EKS dari add-on VPC CNI, Anda dapat mengikuti. Buat Amazon VPC CNI (add-on Amazon EKS)

2. Simpan konfigurasi add-on yang Anda instal saat ini.

   kubectl get daemonset aws-node -n kube-system -o yaml > aws-k8s-cni-old.yaml

3. Perbarui add-on Anda menggunakan AWS CLI. Jika Anda ingin menggunakan AWS Management Console atau eksctl memperbarui add-on, lihatPerbarui add-on Amazon EKS. Salin perintah yang mengikuti ke perangkat Anda. Buat modifikasi berikut pada perintah, sesuai kebutuhan, dan kemudian jalankan perintah yang dimodifikasi.

   • Ganti my-cluster dengan nama klaster Anda.

   • Ganti v1.19.0-eksbuild.1 dengan versi terbaru yang tercantum dalam tabel versi terbaru untuk versi cluster Anda.

   • Ganti 111122223333 dengan ID akun Anda dan AmazonEKSVPCCNIRole dengan nama peran IAM yang ada yang telah Anda buat. Untuk membuat peran IAM untuk VPC CNI, lihat. Langkah 1: Buat Amazon VPC CNI plugin for Kubernetes Peran IAM Menentukan peran mengharuskan Anda memiliki IAM OpenID Connect (OIDC) penyedia untuk cluster Anda. Untuk menentukan apakah Anda memiliki satu untuk cluster Anda, atau untuk membuatnya, lihatBuat IAM OIDC penyedia untuk klaster Anda.

   • --resolve-conflicts PRESERVEOpsi ini mempertahankan nilai konfigurasi yang ada untuk add-on. Jika Anda telah menetapkan nilai kustom untuk pengaturan add-on, dan Anda tidak menggunakan opsi ini, Amazon EKS menimpa nilai Anda dengan nilai defaultnya. Jika Anda menggunakan opsi ini, kami sarankan untuk menguji setiap bidang dan perubahan nilai pada klaster non-produksi sebelum memperbarui add-on pada cluster produksi Anda. Jika Anda mengubah nilai ini menjadiOVERWRITE, semua pengaturan diubah ke nilai default Amazon EKS. Jika Anda telah menetapkan nilai kustom untuk setelan apa pun, nilai tersebut mungkin akan ditimpa dengan nilai default Amazon EKS. Jika Anda mengubah nilai ininone, Amazon EKS tidak mengubah nilai pengaturan apa pun, tetapi pembaruan mungkin gagal. Jika pembaruan gagal, Anda menerima pesan galat untuk membantu menyelesaikan konflik.

   • Jika Anda tidak memperbarui pengaturan konfigurasi, hapus --configuration-values '{"env":{"AWS_VPC_K8S_CNI_EXTERNALSNAT":"true"}}' dari perintah. Jika Anda memperbarui pengaturan konfigurasi, ganti "env":{"AWS_VPC_K8S_CNI_EXTERNALSNAT":"true"} dengan pengaturan yang ingin Anda atur. Dalam contoh ini, variabel AWS_VPC_K8S_CNI_EXTERNALSNAT lingkungan diatur ketrue. Nilai yang Anda tentukan harus valid untuk skema konfigurasi. Jika Anda tidak tahu skema konfigurasi, jalankanaws eks describe-addon-configuration --addon-name vpc-cni --addon-version v1.19.0-eksbuild.1 , ganti v1.19.0-eksbuild.1 dengan nomor versi add-on yang ingin Anda lihat konfigurasinya. Skema dikembalikan dalam output. Jika Anda memiliki konfigurasi kustom yang ada, ingin menghapus semuanya, dan mengatur nilai untuk semua pengaturan kembali ke default Amazon EKS, hapus "env":{"AWS_VPC_K8S_CNI_EXTERNALSNAT":"true"} dari perintah, sehingga Anda kosong. {} Untuk penjelasan tentang setiap pengaturan, lihat Variabel Konfigurasi CNI pada GitHub.

     aws eks update-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version v1.19.0-eksbuild.1 \
         --service-account-role-arn arn:aws: iam::111122223333:role/AmazonEKSVPCCNIRole \
         --resolve-conflicts PRESERVE --configuration-values '{"env":{"AWS_VPC_K8S_CNI_EXTERNALSNAT":"true"}}'

     Mungkin perlu beberapa detik untuk pembaruan selesai.

4. Konfirmasikan bahwa versi add-on telah diperbarui. Ganti my-cluster dengan nama klaster Anda.

   aws eks describe-addon --cluster-name my-cluster --addon-name vpc-cni

   Mungkin perlu beberapa detik untuk pembaruan selesai.

   Contoh output adalah sebagai berikut.

   {
       "addon": {
           "addonName": "vpc-cni",
           "clusterName": "my-cluster",
           "status": "ACTIVE",
           "addonVersion": "v1.19.0-eksbuild.1",
           "health": {
               "issues": []
           },
           "addonArn": "arn:aws: eks:region:111122223333:addon/my-cluster/vpc-cni/74c33d2f-b4dc-8718-56e7-9fdfa65d14a9",
           "createdAt": "2023-04-12T18:25:19.319000+00:00",
           "modifiedAt": "2023-04-12T18:40:28.683000+00:00",
           "serviceAccountRoleArn": "arn:aws: iam::111122223333:role/AmazonEKSVPCCNIRole",
           "tags": {},
           "configurationValues": "{\"env\":{\"AWS_VPC_K8S_CNI_EXTERNALSNAT\":\"true\"}}"
       }
   }