Node मा कन्फिगरेसन र सिक्रेट्स कसरी व्यवस्थापन गर्नुहुन्छ?

Question

Accepted Answer

कन्फिगरेसन (डेटाबेस URLs, API keys, ports, feature flags) आपनको कोडको **बाहिर** environment variables मा रहनु पर्छ — कहिलै hardcoded हुनु हुँदैन। यसले सिक्रेट्सलाई source control बाहिर राख्छ र उही कोडलाई dev, staging, र production मा फरक सेटिङ्सको साथ चलाउन दिन्छ।

## सिद्धान्त: environment बाट config

```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 र कोडको कठोर अलगीकरण, ताकि नयाँ environment मा तैनात गर्नुको अर्थ कोड होइन, env vars परिवर्तन गरिरहेको हो।

## स्थानीय विकास: .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;
```

`.env` फाइलले स्थानीय config राख्छ; यो **gitignored हुनु पर्छ**। एक `.env.example` (कुञ्जीहरूको साथ तर कुनै वास्तविक मानहरू बिना) प्रतिबद्ध गर्नुहोस् जुन आवश्यक छ भनेर दस्तावेज गर्न।

## स्टार्টअप मा कन्फिगरेसन सत्यापन गर्नुहोस्

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

env vars लाई बुटमा सत्यापन गर्नु (zod/envalid को साथ) अर्थ गायब वा malformed सिक्रेट तुरन्त स्पष्ट सन्देशको साथ क्र्यास हुन्छ — एक अनुरोधको गहिराइमा भ्रामक runtime विफलता भन्दा बढी राम्रो।

## उत्पादनमा सिक्रेट्स

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

## किन यो महत्वपूर्ण छ

योग्य कन्फिगरेसन र सिक्रेट व्यवस्थापन **सुरक्षा** र **अपरेशनल** आवश्यकता दुवै हो।

कोडमा सिक्रेट्स hardcoding गर्नले तिनलाई version control मा लिक गर्छ (एक गम्भीर, सामान्य उल्लङ्घन); config लाई कोडमा मिश्रण गर्नुले वातावरणहरू मध्ये तैनात गर्न पीडादायक बनाउँछ।

मानक दृष्टिकोण — env vars, स्थानीय dev को लागि gitignored `.env`, दस्तावेजीकरणको लागि `.env.example`, स्टार्टअप मा सत्यापन, र उत्पादनमा platform सिक्रेट प्रबन्धकहरू — सिक्रेट्सलाई सुरक्षित राख्छ, यस अनुप्रयोगलाई वातावरणहरूमा पोर्टेबल बनाउँछ, र misconfiguration लाई शीघ्रै सतहमा ल्याउँछ।

यो Node अनुप्रयोगहरू जिम्मेवारीपूर्वक चलाउनको लागि आधारभूत हो।