NestJS @nestjs/config ప్యాకేజీని అందించిస్తుంది, ఇది కాన్ఫిగరేషన్ను మరియు పরిసర చరరాశులను నిర్మాణాత్మక, టైప్-సేఫ్, ఇంజెక్టబుల్ విధంగా నిర్వహిస్తుంది. ఇది .env ఫైళ్లను లోడ్ చేస్తుంది, కాన్ఫిగ్ను ధృవీకరిస్తుంది, మరియు ఇంజెక్టబుల్ ConfigService ద్వారా అప్లికేషన్ అంతటా విలువలను అందుబాటులో ఉంచుతుంది.
import { ConfigModule } from "@nestjs/config";
({
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() పరిసర చరరాశులను (.env + process పరిసరం నుండి) లోడ్ చేస్తుంది మరియు — కీలకంగా — స్కీమా (Joi) ఉపయోగించి ధృవీకరించగలదు, కాబట్టి తప్పిపోయిన లేదా చెల్లని కాన్ఫిగ్ ప్రారంభంలో స్పష్టమైన లోపంతో అప్లికేషన్ను క్రాష్ చేస్తుంది, రన్టైమ్లో రహస్యపూర్వకంగా విఫలం కానికి బదులుగా.
@Injectable()
export class DatabaseService {
constructor(private configService: ConfigService) {} // inject ConfigService
connect() {
const url = this.configService.get<string>("DATABASE_URL");
const port = this.configService.get<number>("PORT", 3000); // with a default
}
}
process.env ను నేరుగా everywhere చదివే బదులుగా, మీరు ConfigService ను ఇంజెక్ట్ చేసి get() ని కాల్ చేస్తారు — టైప్-సేఫ్, టెస్టేబుల్, మరియు కేంద్రీకృతం.
// 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")
నామ్స్పేసింగ్ సంబంధిత సెట్టింగ్లను సమూహం చేస్తుంది మరియు కాన్ఫిగ్ను పెరిగినప్పుడు సంগ్రహించిన స్థితిలో ఉంచుతుంది.
✗ 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
✓ 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
ఉపযుక్త కాన్ఫిగరేషన్ నిర్వహణ ఏదైనా నిజమైన అప్లికేషన్కు అవసరం — డేటాబేస్ URLs, API కీలు, పోర్టులు, రహస్యాలు, మరియు ఫీచర్ ఫ్లాగ్లను పరిసరాలలో (dev, staging, production) సురక్షితంగా మరియు సరళంగా నిర్వహించడం.
NestJS యొక్క @nestjs/config ఇది చేయడానికి నిర్మాణాత్మక, ఇడియోమాటిక్ మార్గం అందించుకుంటుంది, మరియు దానిని అర్థం చేసుకోవడం ప్రతిరోజు ఎన్నో సార్లు చేసే జ్ఞానం.
process.env ను నేరుగా చదివే కంటే కీ ప్రయోజనాలు గణనీయమైనవి: ఇంజెక్టబుల్ ConfigService కాన్ఫిగ్ను టెస్టేబుల్ (టెస్ట్లలో మాక్చేయగలిగిన) మరియు కేంద్రీకృతం చేస్తుంది; ప్రారంభంలో ధృవీకరణ (Joi స్కీమాతో) కాలిపోయిన లేదా విఫలమైన కాన్ఫిగరేషన్ను తక్షణమే స్పష్టమైన లోపంతో పట్టుకుంటుంది, రిక్వెస్ట్ లోతుకు గందరగోళ రన్టైమ్ విఫలం నుండి; మరియు నామ్స్పేసింగ్ కాన్ఫిగరేషన్ పెరిగినప్పుడు దానిని సంగ్రహించిన స్థితిలో ఉంచుతుంది.
gitignored .env ఫైళ్లలో (మరియు committed .env.example) రహస్యాలను ఉంచుకోవడం యొక్క సురక్షा సరైన ఆచరణతో కలిపితే, ఇది సురక్షితమైన, పోర్టేబుల్, ధృవీకరించిన కాన్ఫిగరేషన్ ఇస్తుంది.
ConfigModule సెటప్ చేయడం, ConfigService ను ఇంజెక్ట్ చేయడం మరియు ఉపయోగించడం, మరియు కాన్ఫిగ్ను ధృవీకరించడం ఎలాగో తెలుసుకోవడం ఉత్పత్తి-సిద్ధ NestJS అప్లికేషన్లను నిర్మిస్తూ ప్రతిబింబితం చేయటానికి ప్రాథమిక విషయం మరియు ప్రతిపత్తిశాలుండిన back-end ఆచరణను ప్రతిబింబిస్తుంది.