

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

# Siapkan Agen Identitas Amazon EKS Pod
<a name="pod-id-agent-setup"></a>

Pengaitan Identitas Pod Amazon EKS menyediakan kemampuan untuk mengelola kredensial untuk aplikasi Anda, mirip dengan cara profil instans Amazon EC2 memberikan kredensial ke instans Amazon EC2.

Amazon EKS Pod Identity memberikan kredensi ke beban kerja Anda dengan API *Auth EKS* tambahan dan pod agen yang berjalan di setiap node.

**Tip**  
Anda tidak perlu menginstal Agen Identitas Pod EKS pada Kluster Mode Otomatis EKS. Kemampuan ini dibangun ke dalam Mode Otomatis EKS.

## Pertimbangan-pertimbangan
<a name="pod-id-agent-considerations"></a>
+ Secara default, Agen Identitas Pod EKS sudah diinstal sebelumnya pada kluster Mode Otomatis EKS. Untuk mempelajari selengkapnya, lihat [Mengotomatiskan infrastruktur klaster dengan Mode Otomatis EKS](automode.md).
+ Secara default, Agen Identitas Pod EKS mendengarkan pada `IPv6` alamat `IPv4` dan untuk pod untuk meminta kredensialnya. Agen menggunakan alamat IP loopback (localhost) `169.254.170.23` untuk `IPv4` dan alamat IP localhost untuk. `[fd00:ec2::23]` `IPv6`
+ Jika Anda menonaktifkan `IPv6` alamat, atau mencegah alamat `IPv6` IP localhost, agen tidak dapat memulai. Untuk memulai agen pada node yang tidak dapat digunakan`IPv6`, ikuti langkah-langkah [Nonaktifkan `IPv6` di Agen Identitas Pod EKS](pod-id-agent-config-ipv6.md) untuk menonaktifkan `IPv6` konfigurasi.

## Membuat Agen Identitas Amazon EKS Pod
<a name="pod-id-agent-add-on-create"></a>

### Prasyarat agen
<a name="pod-id-agent-prereqs"></a>

**penting**  
Node tempat EKS Pod Identity Agent berjalan harus dapat mengakses EKS Auth API. Jika Anda menggunakan subnet pribadi untuk node Anda, Anda harus menyiapkan titik akhir AWS PrivateLink antarmuka untuk EKS Auth API. Untuk informasi selengkapnya, lihat [Akses Amazon EKS menggunakan AWS PrivateLink](vpc-interface-endpoints.md).
+ Sebuah klaster Amazon EKS yang sudah ada. Untuk menyebarkan satu, lihat[Memulai dengan Amazon EKS](getting-started.md). Versi cluster dan versi platform harus sama atau lebih lambat dari versi yang tercantum dalam [versi cluster EKS Pod Identity](pod-identities.md#pod-id-cluster-versions).
+ Peran node memiliki izin bagi agen untuk melakukan `AssumeRoleForPodIdentity` tindakan di EKS Auth API. Anda dapat menggunakan [kebijakan AWS terkelola: Amazon EKSWorker NodePolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-amazoneksworkernodepolicy) atau menambahkan kebijakan khusus yang serupa dengan berikut ini:

  ```
  {
      "Version":"2012-10-17",		 	 	 
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "eks-auth:AssumeRoleForPodIdentity"
              ],
              "Resource": "*"
          }
      ]
  }
  ```

  Tindakan ini dapat dibatasi oleh tag untuk membatasi peran mana yang dapat diasumsikan oleh pod yang menggunakan agen.
+ Node dapat menjangkau dan mengunduh gambar dari Amazon ECR. Gambar kontainer untuk add-on ada di pendaftar yang tercantum di Lihat [pendaftar gambar kontainer Amazon untuk add-on Amazon EKS.](add-ons-images.md)

  Perhatikan bahwa Anda dapat mengubah lokasi gambar dan `imagePullSecrets` menyediakan add-on EKS di **pengaturan konfigurasi Opsional** di Konsol Manajemen AWS, dan `--configuration-values` di AWS CLI.

### Agen penyiapan dengan AWS konsol
<a name="setup_agent_with_shared_aws_console"></a>

1. Buka [konsol Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).

1. Di panel navigasi sebelah kiri, pilih **Clusters**, lalu pilih nama cluster yang ingin Anda konfigurasikan untuk add-on EKS Pod Identity Agent.

1. Pilih tab **Add-ons**.

1. Pilih **Get more add-ons**

1. Pilih kotak di kanan atas kotak add-on untuk EKS Pod Identity Agent dan kemudian pilih **Berikutnya**.

1. Pada halaman **Konfigurasi pengaturan add-on yang dipilih**, pilih versi apa pun di daftar **dropdown Versi**.

1. (Opsional) Perluas **pengaturan konfigurasi opsional** untuk memasukkan konfigurasi tambahan. Misalnya, Anda dapat memberikan lokasi gambar kontainer alternatif dan`ImagePullSecrets`. Skema JSON dengan kunci yang diterima ditampilkan dalam skema konfigurasi **Add-on**.

   Masukkan tombol konfigurasi dan nilai dalam **nilai Konfigurasi**.

1. Pilih **Berikutnya**.

1. Konfirmasikan bahwa pod EKS Pod Identity Agent berjalan di klaster Anda.

   ```
   kubectl get pods -n kube-system | grep 'eks-pod-identity-agent'
   ```

   Contoh output adalah sebagai berikut.

   ```
   eks-pod-identity-agent-gmqp7                                          1/1     Running   1 (24h ago)   24h
   eks-pod-identity-agent-prnsh                                          1/1     Running   1 (24h ago)   24h
   ```

   Anda sekarang dapat menggunakan asosiasi EKS Pod Identity di klaster Anda. Untuk informasi selengkapnya, lihat [Menetapkan peran IAM ke akun layanan Kubernetes](pod-id-association.md).

### Agen penyiapan dengan AWS CLI
<a name="setup_agent_with_shared_aws_cli"></a>

1. Jalankan perintah AWS CLI berikut. Ganti `my-cluster` dengan nama klaster Anda.

   ```
   aws eks create-addon --cluster-name my-cluster --addon-name eks-pod-identity-agent --addon-version v1.0.0-eksbuild.1
   ```
**catatan**  
Agen Identitas Pod EKS tidak menggunakan *peran `service-account-role-arn` untuk IAM untuk akun layanan*. Anda harus memberikan izin kepada Agen Identitas Pod EKS dalam peran node.

1. Konfirmasikan bahwa pod EKS Pod Identity Agent berjalan di klaster Anda.

   ```
   kubectl get pods -n kube-system | grep 'eks-pod-identity-agent'
   ```

   Contoh output adalah sebagai berikut.

   ```
   eks-pod-identity-agent-gmqp7                                          1/1     Running   1 (24h ago)   24h
   eks-pod-identity-agent-prnsh                                          1/1     Running   1 (24h ago)   24h
   ```

   Anda sekarang dapat menggunakan asosiasi EKS Pod Identity di klaster Anda. Lihat informasi yang lebih lengkap di [Menetapkan peran IAM ke akun layanan Kubernetes](pod-id-association.md).