Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Cara menggunakan AWS AppConfig Agen untuk mengambil data konfigurasi
<a name="appconfig-agent-how-to-use"></a>

 AWS AppConfig Agen adalah metode yang direkomendasikan untuk mengambil flag AWS AppConfig fitur atau data konfigurasi formulir bebas. Agen didukung pada semua bentuk AWS Compute termasuk Amazon EC2, Amazon ECS, Amazon EKS, dan Lambda. Setelah Anda menyelesaikan penyiapan agen awal, menggunakan agen untuk mengambil data konfigurasi lebih sederhana daripada memanggil AWS AppConfig API secara langsung. Agen secara otomatis menerapkan praktik terbaik dan dapat menurunkan biaya penggunaan Anda AWS AppConfig sebagai akibat dari lebih sedikit panggilan API untuk mengambil konfigurasi.

**catatan**  
Mengambil data konfigurasi dari terpisah Akun AWS tidak didukung.

## Menggunakan AWS AppConfig Agen untuk penerapan bertahap berbasis pengguna atau entitas
<a name="appconfig-entity-based-gradual-deployments"></a>

AWS AppConfig Agen mendukung penerapan flag fitur atau data konfigurasi bentuk bebas ke segmen tertentu atau pengguna individu selama peluncuran bertahap. Entity-based penerapan bertahap memastikan bahwa setelah pengguna atau segmen menerima versi konfigurasi, mereka terus menerima versi yang sama selama periode penerapan, terlepas dari sumber daya komputasi mana yang melayani permintaan mereka.

Dengan penerapan bertahap berbasis entitas, AWS AppConfig Agen mengevaluasi pengenal unik () `Entity-Id` yang disertakan dengan setiap permintaan HTTP. Berdasarkan pengenal ini, agen secara konsisten melayani versi konfigurasi baru atau sebelumnya selama periode penerapan. Proses ini memastikan bahwa setelah pengguna menerima konfigurasi yang diperbarui, mereka terus menerimanya. Ini juga memastikan bahwa alarm rollback memiliki waktu dan data yang cukup untuk mendeteksi masalah.

Pertimbangkan penerapan bertahap berbasis entitas jika konfigurasi secara langsung mengubah perilaku yang dihadapi pengguna dan jika perubahan radius ledakan (memengaruhi pengguna tertentu sepenuhnya daripada sebagian pengguna) dapat diterima untuk aplikasi Anda.

**penting**  
Perhatikan informasi penting berikut tentang penerapan bertahap berbasis entitas:  
Entity-based penerapan bertahap memerlukan AWS AppConfig Agen versi 2.0.136060 atau yang lebih baru.
`Entity-Id`menerima ukuran string maksimum 2 KB.
Pengidentifikasi unik tidak boleh dikodekan keras atau kardinalitas rendah.
Pengidentifikasi tidak dikirim ke AWS AppConfig layanan. AWS AppConfig Agen mengevaluasi pengenal unik sisi klien.
Selama penerapan, AWS AppConfig Agen melacak entitas dan konfigurasi yang diterapkan. Pelacakan ini dipertahankan hanya selama periode penerapan. Pelacakan berakhir saat penerapan selesai.
Setiap instance AWS AppConfig jajak pendapat untuk status penerapan secara independen, sehingga agen dapat secara singkat melayani versi berbeda dari entitas yang sama saat persentase penerapan berubah. Jendela ini ditentukan oleh interval polling dan periode sinkronisasi singkat. Anda dapat menguranginya dengan menyetel `RequiredMinimumPollIntervalInSeconds` dalam tindakan [StartConfigurationSession](https://docs.aws.amazon.com/appconfig/2019-10-09/APIReference/API_appconfigdata_StartConfigurationSession.html)API. Namun, interval yang lebih pendek meningkatkan tingkat panggilan API, yang dapat meningkatkan biaya dan risiko pelambatan. Pilih interval polling yang memenuhi kebutuhan Anda. Untuk informasi lebih lanjut, lihat [StartConfigurationSession](https://docs.aws.amazon.com/cli/latest/reference/appconfigdata/start-configuration-session.html)di AWS CLI Referensi.

### Mengaktifkan penerapan bertahap berbasis entitas
<a name="appconfig-entity-based-gradual-deployments-enabling"></a>

Untuk mengaktifkan penerapan bertahap berbasis entitas:

1. Perbarui ke AWS AppConfig Agen versi 2.0.136060 atau yang lebih baru.

1. Berikan pengenal unik di header `Entity-Id` HTTP saat mengambil data konfigurasi.

Contoh permintaan berikut menggunakan alamat email untuk `Entity-Id`

```
GET /applications/myapp/environments/prod/configurations/featureflags HTTP/1.1
Host: localhost:2772
Entity-Id: example@AWS-example-email.com
```

Anda dapat menyertakan `Entity-Id` header dalam permintaan untuk:

/applications/ {Application} /environments/ {Environment} /configurations/ {Configuration}

Untuk melihat contoh kode dengan`Entity-Id`, lihat[Menggunakan AWS AppConfig Agen untuk membaca profil konfigurasi bentuk bebas](appconfig-code-samples-agent-read-configuration.md).

`Entity-Id`Nilai dapat berupa string apa pun yang secara unik mengidentifikasi entitas dalam sistem Anda, seperti:
+ ID Pelanggan
+ Alamat Email
+ account-id
+ ID pekerjaan backend
+ Session-scoped pengenal (jika sesuai)