View a markdown version of this page

Mengonfigurasi AWS AppConfig Ekstensi Agen Lambda - AWS AppConfig

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

Mengonfigurasi AWS AppConfig Ekstensi Agen Lambda

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

Mengambil data konfigurasi terlebih dahulu

Variabel lingkungan AWS_APPCONFIG_EXTENSION_PREFETCH_LIST dapat meningkatkan waktu start-up fungsi Anda. Ketika ekstensi AWS AppConfig Agen Lambda diinisialisasi, ekstensi ini mengambil konfigurasi yang ditentukan AWS AppConfig sebelum 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

Ek AWS AppConfig stensi 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 memberikan akun yang menjalankan fungsi Lambda akses ke appconfig:GetLatestConfiguration tindakan appconfig:StartConfigurationSession dan, bersama dengan ARN sebagian atau lengkap yang sesuai dengan sumber daya AWS AppConfig konfigurasi.

  2. Di akun yang menjalankan fungsi Lambda, tambahkan variabel AWS_APPCONFIG_EXTENSION_ROLE_ARN lingkungan ke fungsi Lambda dengan ARN dari 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 CloudWatch Logs.

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

Variabel lingkungan Rincian Nilai default Nilai sampel

AWS_APPCONFIG_EXTENSION_EXPERIMENT_ASSIGNMENT_LOG_DESTINATION

Variabel lingkungan ini memungkinkan AWS AppConfig Agen untuk mencatat catatan penugasan eksperimen, yang menangkap setiap kejadian perlakuan percobaan yang ditugaskan ke entitas tertentu pada waktu tertentu. Nilai yang mungkin: file:<path>/ menunjukkan direktori dasar di mana catatan penugasan ditulis ke disk; stderr menunjukkan bahwa catatan penugasan dipancarkan ke stderr. Fitur ini memerlukan ekstensi AWS AppConfig Agen Lambda versi 2.0.20159 atau yang lebih baru.

 Tidak ada

file:/tmp/aws-appconfig/assignments/

stderr

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 oleh agen. Setiap level mencakup level saat ini dan semua level yang lebih tinggi. Nilainya tidak peka huruf besar/kecil. Dari yang paling detail hingga yang paling tidak rinci, 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. 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 jumlah detik untuk interval. Anda juga dapat menentukan angka dengan satuan waktu: s untuk detik, m untuk menit, dan h untuk jam. Jika unit tidak ditentukan, agen default ke detik. Misalnya, 60, 60s, dan 1m menghasilkan interval polling yang sama.

45

45

45 detik

5m

1 jam

AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS

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

 3000 ms

3000

300 ms

5 detik

AWS_APPCONFIG_EXTENSION_PREFETCH_LIST

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

 Tidak ada

MyApp:MyEnv:MyConfig

abcd123:efgh456:ijkl789

MyApp:MyEnv:Config1,MyApp:MyEnv:Config2
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS Variabel lingkungan ini menentukan header yang diperlukan oleh proxy yang direferensikan dalam variabel AWS_APPCONFIG_EXTENSION_PROXY_URL lingkungan. 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 URL didukung. Tidak ada

http://localhost:7474

https://my-proxy.example.com
AWS_APPCONFIG_EXTENSION_ROLE_ARN Variabel lingkungan ini menentukan peran IAM ARN yang sesuai dengan peran yang harus diasumsikan oleh AWS AppConfig ekstensi untuk mengambil konfigurasi. Tidak ada Arn:aws:iam: :123456789012: role/MyRole
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID Variabel lingkungan ini menentukan id eksternal untuk digunakan bersama dengan peran yang diasumsikan ARN. Tidak ada MyExternalId
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME Variabel lingkungan ini menentukan nama sesi yang akan dikaitkan dengan kredenSIAL 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. Ketika 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 mengonfigur AWS AppConfig asi 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 mengonfigur AWS AppConfig asi Agen untuk menunggu hingga manifes diproses sebelum menyelesaikan startup.

 true

true

SALAH