**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.

# Memigrasikan entri `aws-auth ConfigMap` yang ada untuk mengakses entri
<a name="migrating-access-entries"></a>

Jika Anda telah menambahkan entri ke `aws-auth` `ConfigMap` pada cluster Anda, kami sarankan Anda membuat entri akses untuk entri yang ada di klaster Anda `aws-auth``ConfigMap`. Setelah membuat entri akses, Anda dapat menghapus entri dari Anda`ConfigMap`. Anda tidak dapat mengaitkan kebijakan [ akses ](access-policies.md) ke entri di `aws-auth``ConfigMap`. Jika Anda ingin mengaitkan kebijakan akses ke prinsipal IAM Anda, buat entri akses.

**penting**  
Ketika cluster berada dalam mode `API_AND_CONFIGMAP` otentikasi dan ada pemetaan untuk peran IAM yang sama di entri `aws-auth` `ConfigMap` dan dalam akses, peran tersebut akan menggunakan pemetaan entri akses untuk otentikasi. Entri akses diutamakan daripada `ConfigMap` entri untuk prinsipal IAM yang sama.
Sebelum menghapus `aws-auth` `ConfigMap` entri yang ada yang dibuat oleh Amazon EKS untuk grup [ node terkelola ](managed-node-groups.md) atau profil [ Fargate ](fargate-profile.md) ke cluster Anda, periksa kembali apakah entri akses yang benar untuk sumber daya spesifik tersebut ada di cluster Amazon EKS Anda. Jika Anda menghapus entri yang dibuat Amazon EKS `ConfigMap` tanpa memiliki entri akses yang setara, cluster Anda tidak akan berfungsi dengan baik.

## Prasyarat
<a name="migrating_access_entries_prereq"></a>
+ Keakraban dengan entri akses dan kebijakan akses. Untuk informasi selengkapnya, lihat [Berikan akses kepada pengguna IAM ke Kubernetes dengan entri akses EKS](access-entries.md) dan [Mengaitkan kebijakan akses dengan entri akses](access-policies.md).
+ Cluster yang ada dengan versi platform yang sama atau lebih baru dari versi yang tercantum dalam Prasyarat [Berikan akses kepada pengguna IAM ke Kubernetes dengan entri akses EKS](access-entries.md) topik.
+ Versi `0.215.0` atau yang lebih baru dari alat baris `eksctl` perintah yang diinstal pada perangkat Anda atau AWS CloudShell. Untuk menginstal atau memperbarui`eksctl`, lihat [ Instal `eksctl` asi ](https://eksctl.io/installation) di dokumentasi.
+ Iz `aws-auth` `ConfigMap` in Kubernetes untuk memodifikasi namespace. `kube-system`
+ Peran AWS Identitas dan Manajemen Akses atau pengguna dengan izin berikut: `CreateAccessEntry` dan`ListAccessEntries`. Untuk informasi selengkapnya, lihat Tind [ akan yang ditentukan oleh Layanan Kubernetes Amazon Elastic ](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelastickubernetesservice.html#amazonelastickubernetesservice-actions-as-permissions) di Referensi Otorisasi Layanan.

## `eksctl`
<a name="migrating_access_entries_eksctl"></a>

1. Lihat entri yang ada di Anda`aws-auth ConfigMap`. Ganti {{my-cluster}} dengan nama klaster Anda.

   ```
   eksctl get iamidentitymapping --cluster my-cluster
   ```

   Contoh output adalah sebagai berikut.

   ```
   ARN                                                                                             USERNAME                                GROUPS                                                  ACCOUNT
   arn:aws: iam::111122223333:role/EKS-my-cluster-Admins                                            Admins                                  system:masters
   arn:aws: iam::111122223333:role/EKS-my-cluster-my-namespace-Viewers                              my-namespace-Viewers                    Viewers
   arn:aws: iam::111122223333:role/EKS-my-cluster-self-managed-ng-1                                 system:node:{{EC2PrivateDNSName}}       system:bootstrappers,system:nodes
   arn:aws: iam::111122223333:user/my-user                                                          my-user
   arn:aws: iam::111122223333:role/EKS-my-cluster-fargateprofile1                                   system:node:{{SessionName}}             system:bootstrappers,system:nodes,system:node-proxier
   arn:aws: iam::111122223333:role/EKS-my-cluster-managed-ng                                        system:node:{{EC2PrivateDNSName}}       system:bootstrappers,system:nodes
   ```

1.  [Buat entri akses](creating-access-entries.md)untuk salah satu `ConfigMap` entri yang Anda buat dikembalikan dalam output sebelumnya. Saat membuat entri akses, pastikan untuk menentukan nilai yang sama untuk`ARN`,, `USERNAME``GROUPS`, dan `ACCOUNT` dikembalikan dalam output Anda. Dalam contoh output, Anda akan membuat entri akses untuk semua entri kecuali dua entri terakhir, karena entri tersebut dibuat oleh Amazon EKS untuk profil Fargate dan grup node terkelola.

1. Hapus entri dari entr `ConfigMap` i akses apa pun yang Anda buat. Jika Anda tidak menghapus entri dari`ConfigMap`, pengaturan untuk entri akses untuk ARN utama IAM menggantikan entri `ConfigMap` tersebut. Ganti {{111122223333}} dengan ID AWS akun Anda dan {{EKS-my-cluster-my-namespace-Viewers}} dengan nama peran dalam entri di akun Anda`ConfigMap`. Jika entri yang Anda hapus adalah untuk pengguna IAM, bukan peran IAM, ganti `role` dengan `user` dan {{EKS-my-cluster-my-namespace-Viewers}} dengan nama pengguna.

   ```
   eksctl delete iamidentitymapping --arn arn:aws: iam::111122223333:role/EKS-my-cluster-my-namespace-Viewers --cluster my-cluster
   ```