Kako upravljaš konfiguracijom i tajnama u Node-u?

Question

Accepted Answer

Konfiguracija (URL baze podataka, API ključevi, portovi, feature flagovi) trebala bi živjeti **izvan vašeg koda** u varijablama okruženja — nikad hardkodirano. To čuva tajne izvan kontrole izvornog koda i omogućava istom kodu da se pokreće u dev, staging i produkciji s različitim postavkama.

## Princip: konfiguracija iz okruženja

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

Ovo slijedi **twelve-factor app** princip: stroga separacija konfiguracije od koda, tako da implementacija u novo okruženje znači promjenu env var, ne koda.

## Lokalni razvoj: `.env` datoteke

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

Datoteka `.env` sadrži lokalnu konfiguraciju; mora biti **gitignored**. Commit `.env.example` (s ključevima ali bez stvarnih vrijednosti) da dokumentiraš što je potrebno.

## Validacija konfiguracije pri pokretanju

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

Validacija env var pri pokretanju (sa zod/envalid) znači da nedostaje ili loše oblikovana tajna srušava aplikaciju odmah s jasnom porukom — puno bolje nego zbunjujući runtime greška duboko u zahtjevu.

## Tajne u produkciji

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

## Centraliziraj pristup

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

## Zašto je važno

ProperA konfiguracija i upravljanje tajnama su i **sigurnost** i **operativna** nužnost.

Hardkodiranje tajni ih procuriti u kontrolu verzija (ozbiljna, česta krađa); miješanje konfiguracije u kod čini implementaciju preko okruženja bolnom.

Standardni pristup — env var, gitignored `.env` za lokalni razvoj, `.env.example` za dokumentaciju, validacija pri pokretanju, i platform secret manager u produkciji — čuva tajne sigurnima, čini aplikaciju prijenosnom preko okruženja, i pokazuje pogrešnu konfiguraciju rano.

To je temeljno za odgovorno pokretanje Node aplikacija.

Princip: konfiguracija iz okruženja

Lokalni razvoj: .env datoteke

Validacija konfiguracije pri pokretanju

Tajne u produkciji

Centraliziraj pristup

Zašto je važno

Lokalni razvoj: `.env` datoteke