**Bantu tingkatkan 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 **Edit halaman ini pada GitHub** tautan 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.
# Perbarui add-on Amazon EKS
Amazon EKS tidak secara otomatis memperbarui add-on ketika versi baru dirilis atau setelah Anda memperbarui klaster Anda ke versi minor Kubernetes yang baru. Untuk memperbarui add-on untuk cluster yang ada, Anda harus memulai pembaruan. Setelah Anda memulai pembaruan, Amazon EKS memperbarui add-on untuk Anda. Sebelum memperbarui add-on, tinjau dokumentasi saat ini untuk add-on. Untuk daftar add-on yang tersedia, lihat[AWS add-on](workloads-add-ons-available-eks.md). Jika add-on memerlukan peran IAM, lihat detail untuk add-on spesifik di add-on [Amazon EKS](workloads-add-ons-available-eks.md) yang Tersedia AWS untuk detail tentang membuat peran.
## Prasyarat
Selesaikan hal-hal berikut sebelum Anda membuat add-on:
+ Periksa apakah add-on Anda memerlukan peran IAM. Untuk informasi selengkapnya, lihat [Add-on Amazon EKS](eks-add-ons.md).
+ Verifikasi bahwa versi add-on Amazon EKS kompatibel dengan cluster Anda. Untuk informasi selengkapnya, lihat [Verifikasi kompatibilitas versi add-on Amazon EKS dengan klaster](addon-compat.md).
## Prosedur
Anda dapat memperbarui add-on Amazon EKS menggunakan`eksctl`, Konsol Manajemen AWS, atau AWS CLI.
## Perbarui add-on (eksctl)
1. 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.
1. 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 AWS Wilayah tempat klaster 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. Untuk daftar add-on, lihat[AWS add-on](workloads-add-ons-available-eks.md). **\$1** Jika add-on menggunakan akun layanan Kubernetes dan peran IAM, ganti *111122223333* dengan ID akun Anda dan *role-name* dengan nama peran IAM yang sudah ada yang telah Anda buat. Untuk petunjuk tentang cara membuat peran, lihat dokumentasi untuk add-on yang Anda buat. Untuk daftar add-on, lihat[AWS add-on](workloads-add-ons-available-eks.md). 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, lihat[Buat penyedia IAM OIDC untuk klaster Anda](enable-iam-roles-for-service-accounts.md).
Jika add-on tidak menggunakan akun layanan Kubernetes dan peran IAM, hapus baris tersebut. `serviceAccountRoleARN: arn:aws: iam::111122223333:role/role-name `
+ *preserve*Opsi mempertahankan nilai 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, sebaiknya Anda menguji setiap bidang dan perubahan nilai pada klaster non-produksi sebelum memperbarui add-on pada cluster produksi Anda. Jika Anda mengubah nilai ini menjadi`overwrite`, 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 ini`none`, 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 <
1. Buka [konsol Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).
1. Pada panel navigasi sebelah kiri, pilih **Klaster**.
1. Pilih nama cluster yang ingin Anda perbarui add-on.
1. Pilih tab **Add-ons**.
1. Pilih add-on yang ingin Anda perbarui.
1. Pilih **Edit**.
1. Pada *name of addon* halaman **Konfigurasi**, 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. Untuk daftar add-on, lihat[AWS add-on](workloads-add-ons-available-eks.md).
1. Anda memiliki dua opsi untuk mengonfigurasi peran untuk add-on: EKS Pod Identities IAM role dan IAM role for service account (IRSA). Ikuti langkah yang sesuai di bawah ini untuk opsi pilihan Anda. Jika semua add-on yang Anda pilih memiliki **Memerlukan langganan** di bawah **Status**, pilih **Berikutnya**. Untuk add-on yang tidak memiliki **langganan Memerlukan** di bawah **Status**, lakukan hal berikut:
1. Untuk **peran IAM Pod Identity untuk akun layanan**, Anda dapat menggunakan peran IAM EKS Pod Identity yang sudah ada atau membuatnya menggunakan tombol Create **Recommended Role**. Bidang ini hanya akan memberikan opsi dengan kebijakan kepercayaan yang sesuai. Jika tidak ada peran untuk dipilih, maka Anda tidak memiliki peran yang ada dengan kebijakan kepercayaan yang cocok. Untuk mengonfigurasi peran IAM Identitas Pod EKS untuk akun layanan dari add-on yang dipilih, pilih **Buat peran yang direkomendasikan**. Wizard pembuatan peran terbuka di jendela terpisah. Wizard akan secara otomatis mengisi informasi peran sebagai berikut. Untuk setiap add-on di mana Anda ingin membuat peran EKS Pod Identity IAM, selesaikan langkah-langkah di wizard IAM sebagai berikut.
+ Pada langkah **Pilih entitas tepercaya**, opsi AWS layanan untuk **EKS** dan kasus penggunaan untuk **EKS - Pod Identity** telah dipilih sebelumnya, dan kebijakan kepercayaan yang sesuai akan diisi secara otomatis untuk add-on. Misalnya, peran akan dibuat dengan kebijakan kepercayaan yang sesuai yang berisi Pods.eks.amazonaws.com IAM Principal sebagaimana dirinci dalam. [Manfaat Identitas EKS Pod](pod-identities.md#pod-id-benefits) Pilih **Berikutnya**.
+ Pada langkah **Tambah izin**, kebijakan terkelola yang sesuai untuk kebijakan peran telah dipilih sebelumnya untuk add-on. Misalnya, untuk add-on Amazon VPC CNI, peran akan dibuat dengan kebijakan `AmazonEKS_CNI_Policy` terkelola seperti yang dijelaskan dalam. [Plugin Amazon VPC CNI untuk Kubernetes](workloads-add-ons-available-eks.md#add-ons-vpc-cni) Pilih **Berikutnya**.
+ Pada langkah **Nama, tinjau, dan buat**, di **Nama peran**, nama peran default secara otomatis diisi untuk add-on. **Misalnya, untuk add-on **Amazon VPC CNI**, peran akan dibuat dengan nama Amazon. EKSPod IdentityAmazon VPCCNIRole** Dalam **Deskripsi**, deskripsi default secara otomatis diisi dengan deskripsi yang sesuai untuk add-on. Misalnya, untuk add-on Amazon VPC CNI, peran akan dibuat dengan deskripsi **Memungkinkan pod yang berjalan di klaster Amazon EKS** untuk mengakses sumber daya. AWS Dalam **kebijakan Trust**, lihat kebijakan kepercayaan terisi untuk add-on. Pilih **Buat peran**.
**catatan**
Mempertahankan nama peran default memungkinkan EKS untuk memilih peran untuk add-on di cluster baru atau saat menambahkan add-on ke cluster yang ada. Anda masih dapat mengganti nama ini dan peran akan tersedia untuk add-on di seluruh cluster Anda, tetapi peran tersebut harus dipilih secara manual dari drop-down.
1. Untuk add-on yang tidak memiliki **langganan Memerlukan** di bawah **Status** dan di mana Anda ingin mengonfigurasi peran menggunakan IRSA, lihat dokumentasi untuk add-on yang Anda buat untuk membuat kebijakan IAM dan melampirkannya ke peran. Untuk daftar add-on, lihat[AWS add-on](workloads-add-ons-available-eks.md). Memilih peran IAM mengharuskan Anda memiliki penyedia IAM OpenID Connect (OIDC) untuk klaster Anda. Untuk menentukan apakah Anda memiliki satu untuk cluster Anda, atau untuk membuatnya, lihat[Buat penyedia IAM OIDC untuk klaster Anda](enable-iam-roles-for-service-accounts.md).
1. Perluas **pengaturan konfigurasi opsional**.
1. Dalam **nilai Konfigurasi**, masukkan informasi konfigurasi khusus add-on apa pun. Untuk informasi selengkapnya, lihat dokumentasi untuk add-on yang Anda perbarui. Untuk daftar add-on, lihat[AWS add-on](workloads-add-ons-available-eks.md)... 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. Jika Anda mengubah nilai ini menjadi menimpa, 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 ini menjadi tidak ada, Amazon EKS tidak mengubah nilai pengaturan apa pun, tetapi pembaruan mungkin gagal. Jika pembaruan gagal, Anda menerima pesan galat untuk membantu menyelesaikan konflik.
1. Pilih **Simpan perubahan**.
## Perbarui add-on (AWS CLI)
1. Anda memerlukan versi `2.12.3` atau yang lebih baru atau versi `1.27.160` atau yang lebih baru dari AWS Command Line Interface (AWS CLI) diinstal dan dikonfigurasi pada perangkat Anda atau. AWS CloudShell Untuk memeriksa versi Anda saat ini, gunakan`aws --version | cut -d / -f2 | cut -d ' ' -f1`. Package manager seperti `yum``apt-get`,, atau Homebrew untuk macOS seringkali merupakan beberapa versi di belakang versi terbaru CLI. AWS Untuk menginstal versi terbaru, lihat [Menginstal](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) dan [Konfigurasi cepat dengan aws configure](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) di *Panduan Pengguna Antarmuka Baris AWS Perintah*. Versi AWS CLI yang diinstal AWS CloudShell mungkin juga beberapa versi di belakang versi terbaru. Untuk memperbaruinya, lihat [Menginstal AWS CLI ke direktori home Anda](https://docs.aws.amazon.com/cloudshell/latest/userguide/vm-specs.html#install-cli-software) di * AWS CloudShell Panduan Pengguna*.
1. 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"
]
}
```
1. 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
```
1. Tentukan versi add-on mana yang tersedia untuk versi klaster Anda. Ganti *1.35* dengan versi cluster Anda dan *vpc-cni* dengan nama add-on yang ingin Anda perbarui.
```
aws eks describe-addon-versions --kubernetes-version 1.35 --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.
1. 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-addon di](https://docs.aws.amazon.com/cli/latest/reference/eks/update-addon.html) Referensi Baris Perintah Amazon EKS.
+ Ganti *my-cluster* dengan nama klaster Anda.
+ Ganti *vpc-cni* dengan nama add-on yang ingin Anda perbarui yang dikembalikan dalam output dari langkah sebelumnya.
+ Ganti *version-number* dengan versi yang dikembalikan dalam output dari langkah sebelumnya yang ingin Anda perbarui. Beberapa add-on memiliki versi yang direkomendasikan. Untuk informasi selengkapnya, lihat dokumentasi untuk add-on yang Anda perbarui. Untuk daftar add-on, lihat[AWS add-on](workloads-add-ons-available-eks.md). **\$1** Jika add-on menggunakan akun layanan Kubernetes dan peran IAM, ganti *111122223333* dengan ID akun Anda dan *role-name* dengan nama peran IAM yang sudah ada yang telah Anda buat. Untuk petunjuk tentang cara membuat peran, lihat dokumentasi untuk add-on yang Anda buat. Untuk daftar add-on, lihat[AWS add-on](workloads-add-ons-available-eks.md). 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, lihat[Buat penyedia IAM OIDC untuk klaster Anda](enable-iam-roles-for-service-accounts.md).
Jika add-on tidak menggunakan akun layanan Kubernetes dan peran IAM, hapus baris tersebut. `serviceAccountRoleARN: arn:aws: iam::111122223333:role/role-name `
+ `--resolve-conflicts PRESERVE`Opsi mempertahankan nilai 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, sebaiknya Anda menguji setiap bidang dan perubahan nilai pada klaster non-produksi sebelum memperbarui add-on pada cluster produksi Anda. Jika Anda mengubah nilai ini menjadi`OVERWRITE`, 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 ini`NONE`, 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 ingin menghapus semua konfigurasi kustom maka lakukan pembaruan menggunakan *--configuration-values '\$1\$1'* opsi. Ini menetapkan semua konfigurasi kustom kembali ke nilai default. Jika Anda tidak ingin mengubah konfigurasi kustom Anda, jangan berikan *--configuration-values* tanda. Jika Anda ingin menyesuaikan konfigurasi kustom maka ganti *\$1\$1* dengan parameter baru.
```
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
```
1. 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 statusnya`ACTIVE`.