Mengkonfigurasi ekstensi AWS AppConfig Agen Lambda - AWS AppConfig

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

Mengkonfigurasi ekstensi AWS AppConfig Agen Lambda

Anda dapat mengonfigurasi ekstensi dengan mengubah variabel AWS Lambda lingkungan berikut. Untuk informasi selengkapnya, lihat Menggunakan variabel AWS Lambda lingkungan di Panduan AWS Lambda Pengembang.

Prefetching data konfigurasi

Variabel lingkungan AWS_APPCONFIG_EXTENSION_PREFETCH_LIST dapat meningkatkan waktu start-up fungsi Anda. Ketika ekstensi AWS AppConfig Agen Lambda diinisialisasi, ekstensi ini akan mengambil konfigurasi yang ditentukan sebelum AWS AppConfig Lambda mulai menginisialisasi fungsi Anda dan memanggil handler Anda. Dalam beberapa kasus, data konfigurasi sudah tersedia di cache lokal sebelum fungsi Anda memintanya.

Untuk menggunakan kemampuan prefetch, atur nilai variabel lingkungan ke jalur yang sesuai dengan data konfigurasi Anda. Misalnya, jika konfigurasi Anda sesuai dengan aplikasi, lingkungan, dan profil konfigurasi masing-masing bernama “my_application”, “my_environment”, dan “my_configuration_data”, jalurnya adalah. /applications/my_application/environments/my_environment/configurations/my_configuration_data Anda dapat menentukan beberapa item konfigurasi dengan mencantumkannya sebagai daftar yang dipisahkan koma (Jika Anda memiliki nama sumber daya yang menyertakan koma, gunakan nilai ID sumber daya alih-alih namanya).

Mengakses data konfigurasi dari akun lain

Ekstensi AWS AppConfig Agen Lambda dapat mengambil data konfigurasi dari akun lain dengan menentukan peran IAM yang memberikan izin ke data. Untuk mengaturnya, ikuti langkah-langkah berikut:

  1. Di akun tempat AWS AppConfig digunakan untuk mengelola data konfigurasi, buat peran dengan kebijakan kepercayaan yang memberi akun yang menjalankan fungsi Lambda akses ke appconfig:StartConfigurationSession appconfig:GetLatestConfiguration dan tindakan, bersama dengan sebagian atau ARNs lengkap yang sesuai dengan sumber daya konfigurasi. AWS AppConfig

  2. Di akun yang menjalankan fungsi Lambda, tambahkan variabel AWS_APPCONFIG_EXTENSION_ROLE_ARN lingkungan ke fungsi Lambda dengan ARN peran yang dibuat pada langkah 1.

  3. (Opsional) Jika diperlukan, ID eksternal dapat ditentukan menggunakan variabel AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID lingkungan. Demikian pula, nama sesi dapat dikonfigurasi menggunakan variabel AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME lingkungan.

catatan

Perhatikan informasi berikut.

  • Ekstensi AWS AppConfig Agen Lambda hanya dapat mengambil data dari satu akun. Jika Anda menentukan peran IAM, ekstensi tidak akan dapat mengambil data konfigurasi dari akun tempat fungsi Lambda berjalan.

  • AWS Lambda mencatat informasi tentang ekstensi AWS AppConfig Agen Lambda dan fungsi Lambda dengan menggunakan Amazon Logs. CloudWatch

  • Tabel berikut mencakup kolom Nilai sampel. Tergantung pada resolusi monitor Anda, Anda mungkin perlu menggulir ke bagian bawah tabel dan kemudian gulir ke kanan untuk melihat kolom.

Variabel lingkungan Detail Nilai default Nilai sampel

AWS_APPCONFIG_EXTENSION_HTTP_PORT

Variabel lingkungan ini menentukan port di mana server HTTP lokal yang menghosting ekstensi berjalan.

 2772 2772

AWS_APPCONFIG_EXTENSION_LOG_LEVEL

Variabel lingkungan ini menentukan tingkat detail yang dicatat agen. Setiap level mencakup level saat ini dan semua level yang lebih tinggi. Nilainya tidak peka huruf besar/kecil. Dari sebagian besar hingga yang paling tidak detail, level log adalah: tracedebug,info,,warn,error,fatal, dannone. traceLog mencakup informasi terperinci, termasuk informasi waktu, tentang agen.

info

jejak

debug

info

menegur

kesalahan

mematikan

none

AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS

Variabel lingkungan ini mengonfigurasi jumlah maksimum koneksi yang digunakan ekstensi untuk mengambil konfigurasi dari. AWS AppConfig

 3 3

AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS

Variabel lingkungan ini mengontrol seberapa sering agen melakukan polling AWS AppConfig untuk data konfigurasi yang diperbarui. Anda dapat menentukan sejumlah detik untuk interval tersebut. Anda juga dapat menentukan angka dengan satuan waktu: s untuk detik, m untuk menit, dan h selama berjam-jam. Jika unit tidak ditentukan, agen default ke detik. Misalnya, 60, 60-an, dan 1m menghasilkan interval jajak pendapat yang sama.

45

45

45-an

5m

1 jam

AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS

Variabel lingkungan ini mengontrol jumlah waktu maksimum, dalam milidetik, ekstensi menunggu respons dari AWS AppConfig saat menyegarkan data dalam cache. Jika AWS AppConfig tidak merespons dalam jumlah waktu yang ditentukan, ekstensi melewatkan interval polling ini dan mengembalikan data cache yang diperbarui sebelumnya.

 3000ms

3000

300ms

5s

AWS_APPCONFIG_EXTENSION_PREFETCH_LIST

Variabel lingkungan ini menentukan data konfigurasi permintaan agen AWS AppConfig segera setelah dimulai. Beberapa pengidentifikasi konfigurasi dapat disediakan dalam daftar yang dipisahkan koma. Mengambil data konfigurasi dari AWS AppConfig dapat mengurangi waktu mulai dingin fungsi Anda secara signifikan.

 Tidak ada

MyApp:MyEnv:MyConfig

abcd123:efgh456:ijkl789

MyApp::Config1, MyEnv ::Config2 MyApp MyEnv
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS Variabel lingkungan ini menentukan header yang diperlukan oleh proxy yang direferensikan dalam variabel lingkungan. AWS_APPCONFIG_EXTENSION_PROXY_URL Nilainya adalah daftar header yang dipisahkan koma. Tidak ada

header: nilai

h1: v1, h2: v2
AWS_APPCONFIG_EXTENSION_PROXY_URL Variabel lingkungan ini menentukan URL proxy yang akan digunakan untuk koneksi dari AWS AppConfig ekstensi ke Layanan AWS. HTTPSdan HTTP URLs didukung. Tidak ada

http://localhost:7474

https://my-proxy.example.com
AWS_APPCONFIG_EXTENSION_ROLE_ARN Variabel lingkungan ini menentukan peran IAM ARN sesuai dengan peran yang harus diasumsikan oleh AWS AppConfig ekstensi untuk mengambil konfigurasi. Tidak ada arn:aws:iam: :123456789012: peran/MyRole
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID Variabel lingkungan ini menentukan id eksternal untuk digunakan bersama dengan peran ARN yang diasumsikan. Tidak ada MyExternalId
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME Variabel lingkungan ini menentukan nama sesi yang akan dikaitkan dengan kredensyal untuk peran IAM yang diasumsikan. Tidak ada AWSAppConfigAgentSession
AWS_APPCONFIG_EXTENSION_SERVICE_REGION Variabel lingkungan ini menentukan Wilayah alternatif yang harus digunakan ekstensi untuk memanggil AWS AppConfig layanan. Saat tidak ditentukan, ekstensi menggunakan titik akhir di Wilayah saat ini. Tidak ada

us-east-1

eu-west-1

AWS_APPCONFIG_EXTENSION_MANIFEST

Variabel lingkungan ini mengonfigurasi AWS AppConfig Agen untuk memanfaatkan fitur per-konfigurasi tambahan seperti pengambilan multi-akun dan menyimpan konfigurasi ke disk. Untuk informasi lebih lanjut tentang fitur ini, lihat Menggunakan manifes untuk mengaktifkan fitur pengambilan tambahan.

Tidak ada

Saat menggunakan AWS AppConfig konfigurasi sebagai manifes:MyApp:MyEnv:MyManifestConfig.

Saat memuat manifes dari disk: file:/path/to/manifest.json

AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST

Variabel lingkungan ini mengonfigurasi AWS AppConfig Agen untuk menunggu hingga manifes diproses sebelum menyelesaikan startup.

 true

true

SALAH