Piye cara sampeyan ngatur konfigurasi lan rahasia ing Node?

Question

Accepted Answer

Konfigurasi (URL basis data, kunci API, port, bendera fitur) kudu manggon **ing njaba kode sampeyan** ing variabel lingkungan — ora kaiket. Iki njaga rahasia saka kontrol sumber lan nggawa kode sing padha bisa mlaku ing dev, staging, lan produksi karo pengaturan sing béda.

## Prinsip: konfigurasi saka lingkungan

```js
// ❌ NEVER hardcode secrets — they end up in git history forever
const dbUrl = "postgres://admin:password123@db.example.com";

// ✅ read from the environment
const dbUrl = process.env.DATABASE_URL;
const port = process.env.PORT || 3000;
```

Iki ngetut prinsip **aplikasi rolas-two-factor**: pamisahan ketat konfigurasi saka kode, saengga ngluncurake menyang lingkungan anyar tegese ngganti variabel env, ora kode.

## Pangembangan lokal: file .env

```bash
# .env — local values, GITIGNORED (never committed)
DATABASE_URL=postgres://localhost/myapp_dev
JWT_SECRET=dev-secret
PORT=3000
```

```js
// load .env into process.env (older: dotenv; newer Node: --env-file flag)
import "dotenv/config";        // or: node --env-file=.env app.js
const secret = process.env.JWT_SECRET;
```

File `.env` nyekel konfigurasi lokal; iku **kudu gitignored**. Commit `.env.example` (karo kunci nanging tanpa nilai nyata) kanggo nggambarake apa sing diperlokake.

## Validasi konfigurasi nalika startup

```js
import { z } from "zod";

const env = z.object({
  DATABASE_URL: z.string().url(),
  JWT_SECRET: z.string().min(16),
  PORT: z.coerce.number().default(3000),
}).parse(process.env); // ❗ fail FAST at startup if config is missing/invalid
```

Validasi variabel env nalika boot (karo zod/envalid) tegese variabel sing ilang utawa wujud salah nyebabake ambruk langsung karo pesen sing jelas — luwih apik tinimbang kegagalan runtime sing bingung nang-ing jero pitakon.

## Rahasia ing produksi

```text
Dev:        .env file (gitignored)
Production: injected by the platform/orchestrator —
            cloud secret managers (AWS Secrets Manager, GCP Secret Manager, Vault),
            container/orchestrator env vars, CI/CD secrets.
Never put production secrets in .env files committed or shipped with the app.
```

## Aksès terpusat

```js
// config.js — one validated config module the app imports (don't sprinkle process.env everywhere)
export const config = { dbUrl: env.DATABASE_URL, port: env.PORT };
```

## Apa materi iki penting

Manajemen konfigurasi lan rahasia sing pas iku kabutuhan **keamanan** lan **operasional** uga.

Rahasia sing dikait bocor menyang kontrol versi (palanggaran serius, umum); nyampur konfigurasi menyang kode nggawa panyebaran ing lingkungan nyakrawala dorowa.

Pendekatan standar — variabel env, `.env` yang gitignored kanggo dev lokal, `.env.example` kanggo dokumentasi, validasi nalika startup, lan manajer rahasia platform ing produksi — njaga rahasia aman, nggawa aplikasi portabel ing lingkungan, lan nampilake salah konfigurasi awal.

Iku fondasi kanggo mbukak aplikasi Node kanthi tanggung jawab.