View a markdown version of this page

Cara menggunakan AWS AppConfig Agen untuk mengambil data konfigurasi - AWS AppConfig
Penggunaan 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 disarankan untuk mengambil tanda AWS AppConfig fitur atau data konfigurasi formulir bebas. Agen ini didukung pada semua bentuk AWS Compute termasuk Amazon EC2, Amazon ECS, Amazon EKS, dan Lambda. Setelah Anda menyelesaikan pengaturan agen awal, menggunakan agen untuk mengambil data konfigurasi lebih mudah 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 yang terpisah Akun AWS tidak didukung.

Penggunaan AWS AppConfig Agen untuk penerapan bertahap berbasis pengguna atau entitas

AWS AppConfig Agen mendukung penerapan tanda 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 sepanjang 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 disediakan dengan setiap permintaan HTTP. Berdasarkan pengidentifikasi 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 menghadap pengguna dan jika perubahan radius ledakan (berdampak sepenuhnya pada pengguna tertentu daripada sebagian semua 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-Idmenerima ukuran string maksimum 2 KB.

  • Pengidentifikasi unik tidak boleh di-kode 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 digunakan. Pelacakan ini dipertahankan hanya selama periode penerapan. Pelacakan berakhir saat penerapan selesai.

  • Setiap contoh AWS AppConfig jajak pendapat untuk penerapan status secara independen, sehingga agen dapat secara singkat melayani versi yang berbeda dari entitas yang sama saat persentase penerapan berubah. Jendela ini ditentukan oleh interval polling dan periode sinkronisasi singkat. Anda dapat menguranginya dengan meny RequiredMinimumPollIntervalInSeconds etel tindakan StartConfigurationSession API. Namun, interval yang lebih pendek meningkatkan tarif panggilan API, yang dapat meningkatkan biaya dan pelambatan risiko. Pilih interval polling yang memenuhi kebutuhan Anda. Untuk informasi lebih lanjut, lihat StartConfigurationSession di 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 pengidentifikasi 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:

/aplikasi/ {Aplikasi} /lingkungan/ {Lingkungan} /konfigurasi/ {Konfigurasi}

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

  • Session-scoped pengidentifikasi (jika sesuai)