View a markdown version of this page

Cara menggunakan AWS AppConfig Agen untuk mengambil data konfigurasi - AWS AppConfig
Menggunakan AWS AppConfig Agen untuk penerapan bertahap berbasis pengguna atau entitas

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

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 menelepon AWS AppConfig APIs 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

AWS AppConfig Agen mendukung penerapan flag fitur atau data konfigurasi bentuk bebas ke segmen tertentu atau pengguna individu selama peluncuran bertahap. Penerapan bertahap berbasis entitas 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:

  • Penerapan bertahap berbasis entitas memerlukan AWS AppConfig Agen versi 2.0.136060 atau yang lebih baru.

  • Entity-Idmenerima 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 pengidentifikasi 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 StartConfigurationSessionAPI. 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 StartConfigurationSessiondi AWS CLI Referensi.

Mengaktifkan penerapan bertahap berbasis entitas

Untuk mengaktifkan penerapan bertahap berbasis entitas:

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

  2. 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 denganEntity-Id, lihatMenggunakan AWS AppConfig Agen untuk membaca profil konfigurasi bentuk bebas.

Entity-IdNilai dapat berupa string apa pun yang secara unik mengidentifikasi entitas dalam sistem Anda, seperti:

  • ID Pelanggan

  • Alamat Email

  • account-id

  • ID pekerjaan backend

  • Pengidentifikasi cakupan sesi (jika sesuai)