Merilis, dan Bekerja Sebagai Developer · 2/8

Environment dan konfigurasi

Local, staging, production — kode sama, pengaturan berbeda, tanpa kejutan.

Baca 22 menit

Setelah pelajaran ini kamu bisa

Menjelaskan setiap environment itu untuk apa
Menyelesaikan konfigurasi dalam urutan yang bisa diprediksi
Gagal saat startup alih-alih di tengah request
Mengelola rahasia tanpa menaruhnya di git

Environment	Untuk	Data
local	Mesinmu, saat kamu bekerja	Palsu, bisa dibuang
preview	Satu per pull request, untuk review	Palsu atau salinan
staging	Gladi bersih yang menyerupai production	Realistis, dianonimkan
production	Pengguna sungguhan	Sungguhan, tidak tergantikan

Urutan penyelesaian

Konfigurasi datang dari beberapa tempat sekaligus, dan urutannya harus tetap dan terdokumentasi. Kalau tidak, tidak ada yang bisa menjawab "kenapa nilainya 3000 di sini dan 8080 di sana?".

Coba sendiri

Penyelesaian config dengan prioritas yang tetap, plus pemeriksaan saat startup. Ubah lapisannya dan lihat nilai mana yang menang.

// Later layers override earlier ones. This order is a decision to document.
const layers = [
  { name: "code defaults",   values: { PORT: "3000", LOG_LEVEL: "info", DEBUG: "false" } },
  { name: ".env",            values: { LOG_LEVEL: "warn" } },
  { name: ".env.production", values: { LOG_LEVEL: "error", PORT: "8080" } },
  { name: "process env",     values: { PORT: "9000" } },   // the platform wins
];

const { values, source } = resolve(layers);
console.log("key".padEnd(12) + "value".padEnd(10) + "came from");
for (const key of Object.keys(values)) {
  console.log(key.padEnd(12) + values[key].padEnd(10) + source[key]);
}

console.log("");

// --- the startup check ---
// Every variable is a STRING or missing. Parse once, here, and fail loudly.
function required(values, name) {
  const value = values[name];
  if (value === undefined || value === "") throw new Error("Missing required env var: " + name);
  return value;
}
function asNumber(values, name, fallback) {
  const n = Number(values[name]);
  if (!Number.isFinite(n)) throw new Error(name + " must be a number, got: " + values[name]);
  return n;
}
function asBoolean(values, name, fallback = false) {
  const v = values[name];
  if (v === undefined || v === "") return fallback;
  return v === "true" || v === "1";      // "false" is a non-empty string!
}

function loadConfig(values) {
  return {
    port: asNumber(values, "PORT"),
    logLevel: required(values, "LOG_LEVEL"),
    debug: asBoolean(values, "DEBUG"),
    sessionSecret: required(values, "SESSION_SECRET"),
  };
}

try {
  console.log("config:", JSON.stringify(loadConfig(values)));
} catch (error) {
  console.log("STARTUP FAILED: " + error.message);
  console.log("   The server refuses to boot. That is the correct behaviour -");
  console.log("   far better than crashing on a customer's checkout at 2am.");
}

console.log("");
console.log("with the secret supplied:");
console.log("   " + JSON.stringify(loadConfig({ ...values, SESSION_SECRET: "a-long-random-string" })));

Hasil

Tekan Jalankan untuk melihat hasilnya.

Ini jalan di browser kamu, di dalam sandbox. Apa pun yang kamu tulis di sini tidak bisa merusak situs.

Rahasia

Jangan pernah di git. Tidak di sebuah commit, tidak di komentar, tidak di fixture test. Riwayat git itu permanen — rahasia yang sudah di-commit sekali harus diganti, meski kamu menghapusnya di commit berikutnya.
Jangan di `NEXT_PUBLIC_`. Awalan itu berarti "tanam ini ke bundle browser", seperti dijelaskan modul Node.
Di penyimpanan rahasia platform-nya. Environment variable Vercel, Docker secret, KMS cloud — tempat yang punya kontrol akses dan log audit.
Bisa diganti. Anggap setiap rahasia suatu hari perlu diganti. Kalau menggantinya butuh perubahan kode, itu tidak akan terjadi tepat waktu.
Berbeda per environment. Staging dan production tidak boleh berbagi kunci, kalau tidak bug di staging jadi insiden production.

Tugas praktik

Buat .env.example untuk proyek ini yang mendaftar setiap variable yang dibacanya, dengan nilai placeholder dan komentar untuk masing-masingnya. Cari process.env di codebase-nya untuk menemukan semuanya. Lalu pastikan .env.local diabaikan git sementara .env.example tidak, dan jelaskan kenapa pemisahan itu benar.

Hasil yang diharapkan

Minimal DATABASE_PATH dan NODE_ENV, terdokumentasi tanpa nilai sungguhan.

Cek pemahaman

Sebuah rahasia yang wajib tidak ada di production. Kapan aplikasinya sebaiknya mengetahuinya?

Saat startup — menolak untuk hidup, dengan pesan yang menyebutkan variable-nyaPada request pertama yang membutuhkannyaIa sebaiknya memakai nilai default supaya tidak ada yang rusak

Pilih jawaban dulu