Memperbarui EKS add-on Amazon

Tentukan versi add-on dan add-on saat ini yang diinstal pada cluster Anda. Ganti my-cluster dengan nama klaster Anda.

eksctl get addon --cluster my-cluster

Contoh output adalah sebagai berikut.

NAME        VERSION              STATUS  ISSUES  IAMROLE  UPDATE AVAILABLE
coredns     v1.8.7-eksbuild.2    ACTIVE  0
kube-proxy  v1.23.7-eksbuild.1   ACTIVE  0                v1.23.8-eksbuild.2
vpc-cni     v1.10.4-eksbuild.1   ACTIVE  0                v1.12.0-eksbuild.1,v1.11.4-eksbuild.1,v1.11.3-eksbuild.1,v1.11.2-eksbuild.1,v1.11.0-eksbuild.1

Output Anda mungkin terlihat berbeda, tergantung pada add-on dan versi yang Anda miliki di cluster Anda. Anda dapat melihat bahwa dalam contoh keluaran sebelumnya, dua add-on yang ada di cluster memiliki versi yang lebih baru yang tersedia di UPDATE AVAILABLE kolom.

Perbarui add-on.

1. Salin perintah yang mengikuti ke perangkat Anda. Buat modifikasi berikut pada perintah sesuai kebutuhan:

   • Ganti my-cluster dengan nama klaster Anda.

   • Ganti region-code dengan tempat Wilayah AWS cluster Anda berada.

   • Ganti vpc-cni dengan nama add-on yang dikembalikan dalam output dari langkah sebelumnya yang ingin Anda perbarui.

   • Jika Anda ingin memperbarui ke versi lebih awal dari versi terbaru yang tersedia, maka ganti latest dengan nomor versi yang dikembalikan dalam output dari langkah sebelumnya yang ingin Anda gunakan. Beberapa add-on memiliki versi yang direkomendasikan. Untuk informasi selengkapnya, lihat dokumentasi untuk add-on yang Anda perbarui.

   • Jika add-on menggunakan akun dan IAM peran Kubernetes layanan, ganti 111122223333 dengan ID akun Anda dan role-name dengan nama IAM peran yang ada yang telah Anda buat. Untuk petunjuk tentang cara membuat peran, lihat dokumentasi untuk add-on yang Anda buat. Menentukan peran akun layanan mengharuskan Anda memiliki penyedia IAM OpenID Connect (OIDC) untuk klaster Anda. Untuk menentukan apakah Anda memiliki satu untuk cluster Anda, atau untuk membuatnya, lihatBuat IAM OIDC penyedia untuk klaster Anda.

     Jika add-on tidak menggunakan akun Kubernetes layanan dan IAM peran, hapus serviceAccountRoleARN: arn:aws:iam::111122223333:role/role-name baris.

   • preserveOpsi mempertahankan nilai yang ada untuk add-on. Jika Anda telah menetapkan nilai kustom untuk pengaturan add-on, dan Anda tidak menggunakan opsi ini, Amazon akan EKS menimpa nilai Anda dengan nilai defaultnya. Jika Anda menggunakan opsi ini, sebaiknya Anda menguji setiap bidang dan perubahan nilai pada klaster non-produksi sebelum memperbarui add-on pada cluster produksi Anda. Jika Anda mengubah nilai inioverwrite, semua pengaturan diubah ke nilai EKS default Amazon. Jika Anda telah menetapkan nilai kustom untuk setelan apa pun, nilai tersebut mungkin akan ditimpa dengan nilai EKS default Amazon. 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.

     cat >update-addon.yaml <<EOF
     apiVersion: eksctl.io/v1alpha5
     kind: ClusterConfig
     metadata:
       name: my-cluster
       region: region-code
     
     addons:
     - name: vpc-cni
       version: latest
       serviceAccountRoleARN: arn:aws:iam::111122223333:role/role-name
       resolveConflicts: preserve
     EOF
     

2. Jalankan perintah yang dimodifikasi untuk membuat update-addon.yaml file.

3. Terapkan file konfigurasi ke cluster Anda.

   eksctl update addon -f update-addon.yaml
   

Untuk informasi selengkapnya tentang memperbarui add-on, lihat Memperbarui addons dalam dokumentasi. eksctl

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

Pada panel navigasi sebelah kiri, pilih Klaster.

Pilih nama cluster yang ingin Anda perbarui add-on.

Pilih tab Add-ons.

Pilih add-on yang ingin Anda perbarui.

Pilih Edit.

Pada Konfigurasi name of addonhalaman, lakukan hal berikut:

1. Pilih Versi yang ingin Anda gunakan. Add-on mungkin memiliki versi yang direkomendasikan. Untuk informasi selengkapnya, lihat dokumentasi untuk add-on yang Anda perbarui.

2. Untuk IAMperan Pilih, Anda dapat menggunakan IAM peran node (Tidak disetel) atau peran yang sudah Anda buat untuk digunakan dengan add-on. Jika tidak ada peran untuk dipilih, maka Anda tidak memiliki peran yang ada. Terlepas dari opsi mana yang Anda pilih, lihat dokumentasi untuk add-on yang Anda buat untuk membuat IAM kebijakan dan melampirkannya ke peran. Memilih IAM peran mengharuskan Anda memiliki penyedia IAM OpenID Connect (OIDC) untuk klaster Anda. Untuk menentukan apakah Anda memiliki satu untuk cluster Anda, atau untuk membuatnya, lihatBuat IAM OIDC penyedia untuk klaster Anda.

3. Perluas pengaturan konfigurasi opsional.

4. Dalam nilai Konfigurasi, masukkan informasi konfigurasi khusus add-on apa pun. Untuk informasi selengkapnya, lihat dokumentasi untuk add-on yang Anda perbarui.

5. Untuk metode Resolusi konflik, pilih salah satu opsi. Jika Anda telah menetapkan nilai kustom untuk pengaturan add-on, kami merekomendasikan opsi Preserve. Jika Anda tidak memilih opsi ini, Amazon EKS menimpa nilai Anda dengan nilai defaultnya. Jika Anda menggunakan opsi ini, sebaiknya Anda menguji setiap bidang dan perubahan nilai pada klaster non-produksi sebelum memperbarui add-on pada cluster produksi Anda.

Pilih Simpan perubahan.

Lihat daftar add-on yang diinstal. Ganti my-cluster dengan nama klaster Anda.

aws eks list-addons --cluster-name my-cluster

Contoh output adalah sebagai berikut.

{
    "addons": [
        "coredns",
        "kube-proxy",
        "vpc-cni"
    ]
}

Lihat versi add-on saat ini yang ingin Anda perbarui. Ganti my-cluster dengan nama cluster Anda dan vpc-cni dengan nama add-on yang ingin Anda perbarui.

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

Contoh output adalah sebagai berikut.

v1.10.4-eksbuild.1

Tentukan versi add-on mana yang tersedia untuk versi klaster Anda. Ganti 1.30 dengan versi cluster Anda dan vpc-cni dengan nama add-on yang ingin Anda perbarui.

aws eks describe-addon-versions --kubernetes-version 1.30 --addon-name vpc-cni \
    --query 'addons[].addonVersions[].{Version: addonVersion, Defaultversion: compatibilities[0].defaultVersion}' --output table

Contoh output adalah sebagai berikut.

------------------------------------------
|          DescribeAddonVersions         |
+-----------------+----------------------+
| Defaultversion  |       Version        |
+-----------------+----------------------+
|  False          |  v1.12.0-eksbuild.1  |
|  True           |  v1.11.4-eksbuild.1  |
|  False          |  v1.10.4-eksbuild.1  |
|  False          |  v1.9.3-eksbuild.1   |
+-----------------+----------------------+

Versi dengan True di Defaultversion kolom adalah versi yang add-on dibuat dengan, secara default.

Perbarui add-on Anda. Salin perintah yang mengikuti ke perangkat Anda. Buat modifikasi berikut pada perintah, sesuai kebutuhan, dan kemudian jalankan perintah yang dimodifikasi. Untuk informasi selengkapnya tentang perintah ini, lihat update-addondi Referensi Baris EKS Perintah Amazon.

aws eks update-addon --cluster-name my-cluster --addon-name vpc-cni --addon-version version-number \
    --service-account-role-arn arn:aws:iam::111122223333:role/role-name --configuration-values '{}' --resolve-conflicts PRESERVE

Periksa status pembaruan. Ganti my-cluster dengan nama cluster Anda dan vpc-cni dengan nama add-on yang Anda perbarui.

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

Contoh output adalah sebagai berikut.

{
    "addon": {
        "addonName": "vpc-cni",
        "clusterName": "my-cluster",
        "status": "UPDATING",
[...]

Pembaruan selesai ketika statusnyaACTIVE.