Kako upravljate konfigurracijom u NestJS-u?

Question

Accepted Answer

NestJS pruža paket **`@nestjs/config`** za upravljanje konfiguracijom i varijablama okruženja na strukturirani, type-safe način koji je injektabilan. Učitava `.env` datoteke, validira konfiguraciju, i čini vrijednosti dostupnima cijeloj aplikaciji preko injektabilnog `ConfigService`. ## Postavljanje ConfigModule-a ```ts import { ConfigModule } from "@nestjs/config"; @Module({ imports: [ ConfigModule.forRoot({ isGlobal: true, // available app-wide without re-importing envFilePath: ".env", validationSchema: Joi.object({ // validate env vars at startup (fail fast) DATABASE_URL: Joi.string().required(), PORT: Joi.number().default(3000), JWT_SECRET: Joi.string().required(), }), }), ], }) export class AppModule {} ``` `ConfigModule.forRoot()` učitava varijable okruženja (iz `.env` + procesnog okruženja) i — važno je — može **validirati** ih sa shemom (Joi), tako da nedostajuća ili neispravna konfiguracija srušava aplikaciju pri pokretanju sa jasnom greškom umjesto da ne uspije misterozno tijekom izvršavanja. ## Čitanje konfiguracije preko ConfigService (injektabilnog) ```ts @Injectable() export class DatabaseService { constructor(private configService: ConfigService) {} // inject ConfigService connect() { const url = this.configService.get("DATABASE_URL"); const port = this.configService.get("PORT", 3000); // with a default } } ``` Umjesto direktnog čitanja `process.env` svugdje, injektirate `ConfigService` i pozivate `get()` — type-safe, testabilno, i centralizirano. ## Naspramljena/tipizirana konfiguracija ```ts // config/database.config.ts — group related config with registerAs export default registerAs("database", () => ({ host: process.env.DB_HOST, port: parseInt(process.env.DB_PORT, 10), })); // load it: ConfigModule.forRoot({ load: [databaseConfig] }) // access it: configService.get("database.host") ``` Naspramljavanje grupiše povezane postavke i održava konfiguraciju organiziranom kako raste. ## Zašto ne koristiti direktno process.env? ```text ✗ process.env scattered everywhere → hard to test, no validation, stringly-typed ✓ ConfigService → injectable (mockable in tests), validated at startup, typed, centralized — the structured NestJS way ``` ## Tajne i okruženja ```text ✓ Keep secrets in .env (GITIGNORED) — commit a .env.example documenting required vars ✓ In production, inject config via the platform's env vars / secret manager ✓ Validate at startup so misconfiguration fails immediately with a clear message ``` ## Zašto je važno Ispravno upravljanje konfiguracijom je bitno za bilo koju realnu aplikaciju — rukovanje URL-ovima baza podataka, API ključevima, portovima, tajnama, i zastavicama značajki sigurno i fleksibilno na različitim okruženjima (razvoj, staging, produkcija). NestJS-ov `@nestjs/config` pruža strukturirani, idiomatski način da se ovo učini, i razumijevanje toga je važno svakodnevno znanje. Klučne prednosti u odnosu na direktno čitanje `process.env` su značajne: injektabilni **`ConfigService`** čini konfiguraciju testabilnom (mockabilnom u testovima) i centraliziranom; **validacija pri pokretanju** (sa Joi shemom) odmah hvata nedostajuću ili loše formatirajuću konfiguraciju sa jasnom greškom umjesto zbunjujućeg kvara tijekom izvršavanja dubok u zahtjevu; i naspramljavanje održava rastući konfiguraciju organiziranom. Kombinatno sa sigurnosnom praksom čuvanja tajni u gitignored `.env` datotekama (i posvećena `.env.example`), to vam daje sigurnu, prenosivuu, validiranu konfiguraciju. Znanje kako postaviti `ConfigModule`, injektovati i koristiti `ConfigService`, i validirati konfiguraciju je bitno za izgradnju production-ready NestJS aplikacija i odražava stručnjačku back-end praksu.