Kirim Konfigurasi melalui Variabel Lingkungan

Mengodekan jalur model atau kunci API secara langsung akan menanamkannya ke dalam citra selamanya. Sebagai gantinya, teruskan keduanya sebagai variabel lingkungan saat runtime.

Gunakan os.getenv untuk membaca variabel dengan nilai bawaan yang sesuai. Dengan begitu, kode Anda dapat menyesuaikan diri dengan setiap lingkungan tanpa perlu diubah.

Instruksi ENV dalam Dockerfile menetapkan nilai bawaan yang tertanam. Ini berguna untuk konfigurasi non-rahasia yang jarang berubah.

Ganti nilai apa pun dengan -e pada docker run. Citra yang sama kemudian dapat digunakan untuk staging atau produksi dengan pengaturan yang berbeda.

Simpan banyak variabel dengan rapi dalam sebuah file, lalu muat file tersebut dengan --env-file. Perintah eksekusi Anda tetap singkat dan mudah dibaca.

Jauhkan file rahasia dari Git dan dari citra. Tambahkan .env ke .gitignore dan .dockerignore agar rahasia tersebut tidak pernah bocor.

Rahasia sebenarnya, seperti kata sandi basis data, sebaiknya berasal dari brankas atau pengelola rahasia platform Anda dan hanya disuntikkan saat waktu proses.

Periksa variabel yang wajib ada saat aplikasi dimulai dan hentikan aplikasi dengan jelas jika salah satunya tidak ada. Aplikasi yang gagal dengan jelas lebih baik daripada prediksi yang salah secara diam-diam.

Aturan dua belas faktor menyatakan bahwa konfigurasi harus disimpan di lingkungan. Dengan begitu, satu citra tetap portabel di setiap target penerapan.

Alat seperti pydantic-settings membaca variabel lingkungan ke dalam objek konfigurasi bertipe, sekaligus memvalidasi tipe dan nilai bawaannya di satu tempat yang rapi.

Manfaatnya: bangun sekali, lalu jalankan citra yang sama persis di pengembangan, staging, dan produksi; Anda hanya perlu mengubah variabel yang disuntikkan.

Anda membaca konfigurasi dengan os.getenv, menetapkan nilai bawaan melalui ENV, menggantinya dengan -e dan --env-file, serta menjauhkan rahasia. Satu citra yang portabel. ✅