آپ Node میں configuration اور secrets کا انتظام کیسے کرتے ہیں؟

Question

Accepted Answer

Configuration (database URLs، API keys، ports، feature flags) کو آپ کے code سے **باہر** environment variables میں رہنا چاہیے — کبھی hardcode نہ کیا جائے۔ یہ secrets کو source control سے باہر رکھتا ہے اور ایک ہی code کو dev، staging، اور production میں مختلف settings کے ساتھ چلنے دیتا ہے۔

## اصول: config environment سے

```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;
```

یہ **twelve-factor app** اصول کی پیروی کرتا ہے: config کو code سے سختی سے الگ کرنا، تاکہ کسی نئے environment میں deploy کرنے کا مطلب env vars بدلنا ہو، code نہیں۔

## مقامی development: .env files

```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;
```

ایک `.env` file مقامی config رکھتی ہے؛ اسے **gitignored ہونا چاہیے**۔ ایک `.env.example` (keys کے ساتھ مگر حقیقی values کے بغیر) commit کریں تاکہ دستاویز ہو کہ کیا درکار ہے۔

## startup پر config کی validation کریں

```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
```

boot پر env vars کی validation (zod/envalid کے ساتھ) کا مطلب ہے کہ ایک missing یا خراب secret فوراً ایک واضح پیغام کے ساتھ crash کرے گا — request کے اندر گہرائی میں ایک الجھن بھرے runtime failure سے کہیں بہتر۔

## production میں secrets

```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.
```

## رسائی کو مرکزی بنائیں

```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 };
```

## یہ کیوں اہم ہے

مناسب config اور secret management ایک **security** اور **operational** دونوں ضرورت ہے۔

Secrets کو hardcode کرنا انہیں version control میں لیک کر دیتا ہے (ایک سنگین، عام breach)؛ config کو code میں ملا دینا environments کے درمیان deployment کو تکلیف دہ بنا دیتا ہے۔

معیاری طریقہ — env vars، مقامی dev کے لیے gitignored `.env`، documentation کے لیے `.env.example`، startup پر validation، اور production میں platform secret managers — secrets کو محفوظ رکھتا ہے، app کو environments کے درمیان portable بناتا ہے، اور misconfiguration کو جلد سامنے لاتا ہے۔

یہ Node apps کو ذمہ داری سے چلانے کے لیے بنیادی ہے۔