View a markdown version of this page

(Opsional) Menggunakan variabel lingkungan untuk mengkonfigurasi AWS AppConfig Agen untuk Amazon ECS dan Amazon EKS - AWS AppConfig

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

(Opsional) Menggunakan variabel lingkungan untuk mengkonfigurasi AWS AppConfig Agen untuk Amazon ECS dan Amazon EKS

Anda dapat mengonfigurasi AWS AppConfig Agen dengan mengubah variabel lingkungan berikut untuk wadah agen Anda.

catatan

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

ACCESS_TOKEN

Variabel lingkungan ini mendefinisikan token yang harus disediakan saat meminta data konfigurasi dari server HTTP agen. Nilai token harus diatur dalam header otorisasi permintaan HTTP dengan jenis otorisasiBearer. Inilah contohnya.

GET /applications/my_app/...
                  Host: localhost:2772
                  Authorization: Bearer <token value>
 Tidak ada MyAccessToken

BACKUP_DIRECTORY

Variabel lingkungan ini memungkinkan AWS AppConfig Agen untuk menyimpan cadangan dari setiap konfigurasi yang diambil ke direktori yang ditentukan.

penting

Konfigurasi yang dicadangkan ke disk tidak dienkripsi. Jika konfigurasi Anda berisi data sensitif, sar AWS AppConfig ankan Anda mempraktikkan prinsip hak istimewa terkecil dengan izin sistem file Anda. Untuk informasi selengkapnya, lihat Keamanan di AWS AppConfig.

 Tidak ada /path/to/cadangan

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 membutuhkan AWS AppConfig Agen versi 2.0.175233 atau yang lebih baru.

 Tidak ada

file:/tmp/aws-appconfig/assignments/

stderr

HTTP_PORT

Variabel lingkungan ini menentukan port di mana server HTTP untuk agen berjalan.

 2772 2772

HTTP_HOST

Variabel HTTP_HOST mengontrol bagaimana AWS AppConfig Agen mengikat ke antarmuka jaringan. Perilaku pengikatan berbeda berdasarkan lingkungan runtime untuk memastikan keamanan dan aksesibilitas yang optimal.

ECS, EX

  • Pengikatan default: Semua antarmuka jaringan (0.0.0.0)

EC2 dan on-prem

  • Pengikatan default: hanya localhost

  • Alamat IPv4:127.0.0. 1:2772

  • Alamat IPv6: [::1] :2772

Opsi Konfigurasi Kustom. Anda dapat mengganti perilaku default menggunakan nilai-nilai ini:

  • all(mengikat ke semua antarmuka)

  • localhost(secara eksplisit mengikat antarmuka localhost)

  • Alamat IP spesifik (mis.192.168.1.1)

  • Nama host khusus

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

LOG_PATH

Lokasi disk tempat log ditulis. Jika tidak ditentukan, log ditulis ke stderr.

Tidak ada

 path/to//logs/agent.log

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

MAX_CONNECTIONS

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

3 3

POLL_INTERVAL

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 detik

45

45 detik

5m

1 jam

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.

 Tidak ada

MyApp:MyEnv:MyConfig

abcd123:efgh456:ijkl789

MyApp:MyEnv:Config1,MyApp:MyEnv:Config2

PRELOAD_BACKUPS

Jika diset true el ke, AWS AppConfig Agen memuat cadangan konfigurasi yang BACKUP_DIRECTORY ditemukan di memori dan segera memeriksa untuk melihat apakah ada versi yang lebih baru dari layanan. Jika diset false el ke, AWS AppConfig Agen hanya memuat konten dari cadangan konfigurasi jika tidak dapat mengambil data konfigurasi dari layanan, misalnya jika ada masalah dengan jaringan Anda.

 true

true

SALAH
PROXY_HEADERS Variabel lingkungan ini menentukan header yang diperlukan oleh proxy yang direferensikan dalam variabel PROXY_URL lingkungan. Nilainya adalah daftar header yang dipisahkan koma. Tidak ada

header: nilai

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

http://localhost:7474

https://my-proxy.example.com

REQUEST_TIMEOUT

Variabel lingkungan ini mengontrol jumlah waktu agen menunggu respons. AWS AppConfig Jika layanan tidak merespons, permintaan gagal.

Jika permintaan untuk pengambilan data awal, agen mengembalikan kesalahan ke aplikasi Anda.

Jika batas waktu terjadi selama pemeriksaan latar belakang untuk data yang diperbarui, agen mencatat kesalahan dan mencoba lagi setelah penundaan singkat.

Anda dapat menentukan jumlah milidetik untuk batas waktu. Anda juga dapat menentukan angka dengan satuan waktu: ms untuk milidetik dan s untuk detik. Jika unit tidak ditentukan, agen default ke milidetik. Sebagai contoh, 5000, 5000ms dan 5s menghasilkan nilai batas waktu permintaan yang sama.

 3000 ms

3000

3000 ms

5 detik
ROLE_ARN Variabel lingkungan ini menentukan Nama Sumber Daya Amazon (ARN) dari peran IAM. AWS AppConfig Agen mengambil peran ini untuk mengambil data konfigurasi. Tidak ada Arn:aws:iam: :123456789012: role/MyRole
ROLE_EXTERNAL_ID Variabel lingkungan ini menentukan ID eksternal untuk digunakan dengan peran yang diasumsikan ARN. Tidak ada MyExternalId
ROLE_SESSION_NAME Variabel lingkungan ini menentukan nama sesi yang akan dikaitkan dengan kredenSIAL untuk peran IAM yang diasumsikan. Tidak ada AWSAppConfigAgentSession
SERVICE_REGION Variabel lingkungan ini menentukan alternatif Wilayah AWS yang digunakan AWS AppConfig Agen untuk memanggil AWS AppConfig layanan. Jika dibiarkan tidak ditentukan, agen mencoba untuk menentukan Wilayah saat ini. Jika tidak bisa, agen gagal memulai. Tidak ada

us-east-1

eu-west-1

WAIT_ON_MANIFEST

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

 true

true

SALAH