NestJS menyediakan paket @nestjs/config untuk mengelola konfigurasi dan variabel lingkungan dengan cara yang terstruktur, type-safe, dan dapat diinjeksi. Ini memuat file .env, memvalidasi konfigurasi, dan membuat nilai-nilai tersedia di seluruh aplikasi melalui ConfigService yang dapat diinjeksi.
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() memuat variabel lingkungan (dari .env + lingkungan proses) dan — yang penting — dapat memvalidasi mereka dengan schema (Joi), sehingga konfigurasi yang hilang atau tidak valid akan menyebabkan aplikasi crash saat startup dengan pesan error yang jelas, bukan gagal secara misterius saat runtime.
@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
}
}
Alih-alih membaca process.env langsung di mana-mana, Anda menyuntikkan ConfigService dan memanggil get() — type-safe, testable, dan terpusat.
// 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")
Namespacing mengelompokkan pengaturan terkait dan menjaga konfigurasi tetap terorganisir seiring pertumbuhannya.
✗ 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
Manajemen konfigurasi yang tepat adalah hal penting untuk aplikasi nyata apa pun — menangani URL database, kunci API, port, secrets, dan feature flags dengan aman dan fleksibel di berbagai lingkungan (dev, staging, production).
@nestjs/config NestJS menyediakan cara yang terstruktur dan idiomatis untuk melakukan ini, dan memahaminya adalah pengetahuan penting sehari-hari.
Keuntungan utama dibandingkan membaca process.env secara langsung sangat signifikan: ConfigService yang dapat diinjeksi membuat konfigurasi dapat diuji (dapat di-mock dalam test) dan terpusat; validasi saat startup (dengan schema Joi) menangkap konfigurasi yang hilang atau tidak terbentuk dengan baik segera dengan pesan error yang jelas daripada sebagai kegagalan runtime yang membingungkan di dalam request; dan namespacing menjaga konfigurasi yang berkembang tetap terorganisir.
Dikombinasikan dengan best practice keamanan menjaga secrets dalam file .env yang diabaikan git (dan .env.example yang di-commit), ini memberi Anda konfigurasi yang aman, portabel, dan tervalidasi.
Mengetahui cara menyiapkan ConfigModule, menyuntikkan dan menggunakan ConfigService, dan memvalidasi konfigurasi adalah hal fundamental untuk membangun aplikasi NestJS yang production-ready dan mencerminkan praktik back-end yang profesional.