Conas a bhainistríonn tú cumrasc agus rúndiamhair i Node?

Question

Accepted Answer

Ba chóir cumrasc (URLs bunachar sonraí, eochracha API, portanna, bratacha gné) a bheith **lasmuigh de do chód** in athróga timpeallachta — go deo hardcoded. Coinníonn sé seo rúndiamhair as fhíor-rialú agus ligean don chód céanna a rith i dev, staidéireacht, agus táirgeadh le socruithe difriúla.

## An prionsabal: cumrasc ón timpeallacht

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

Leanann sé seo an prionsabal **app dhá-dhéag-fhachtóir**: scaradh docht cumrasc ó chód, agus mar sin is éard atá i ndlúthpháirt do thimpeallacht nua athrú ar athróga env, gan chód.

## Forbairt áitiúil: `.env` comhaid

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

Coimeádann `.env` comhad cumrasc áitiúil; ní mór a bheith **gitignored**. Tiomáint `.env.example` (le heochracha ach gan fíorluachanna) a dhocúmentiú ar a bhfuil riachtanach.

## Cumrasc a bhailíochtú ar thús

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

Bailíochtú athróga env ar bhóthar tosaigh (le zod/envalid) ciallaíonn go gcriticeann dúch nó dhrochmhúnlaithe go tobann le teachtaireacht shoiléir — i bhfad níos fearr ná cliseadh runtime dríochtúil i ndoimhneacht iarratas.

## Rúndiamhair i táirgeadh

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

## Roinn rochtain

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

## Cén fáth a bhíonn tábhacht air

Bainistríochtaí cumrasc agus rúndiamhair ceart an dá rud go léir **slándáil** agus **oibríochtúil** riachtanas.

Hardcoding rúndiamhair leagtar iad i fhíor-rialú leagan (bréachúchán tromchúiseach, coitianta); cumrasc a dhrithlíniú ar chód déanann trasiompar trasna timpeallachtaí pian.

An cur chuige caighdeánach — athróga env, `.env` gitignored ar son forbairt áitiúil, `.env.example` ar son doiciméadúcháin, bailíochtú ar thús, agus bainisteoirí rúndiamhair ardán i táirgeadh — coimeádann rúndiamhair sábháilte, déanann an app inaistrithe trasna timpeallachtaí, agus dromchla miscumrasc go luath.

Tá sé bunúsach do app Node a rith go freagarthach.

An prionsabal: cumrasc ón timpeallacht

Forbairt áitiúil: .env comhaid

Cumrasc a bhailíochtú ar thús

Rúndiamhair i táirgeadh

Roinn rochtain

Cén fáth a bhíonn tábhacht air

Forbairt áitiúil: `.env` comhaid