From Chaos to Control: Multiple Node.js Environments with Multi-Env CLI

Context

Node.js 프로젝트에서 dev, staging, prod 환경을 테스트할 때마다 개발자는 .env 파일을 수동으로 복사하고 서버를 재시작해야 했다. 이 과정에서 여러 개의 터미널을 열어두고 어떤 인스턴스가 어느 환경으로 실행 중인지 추적하기 어려웠다.

Technical Solution

• 환경 변수 핫 리로드 구현: .multi-env/ 디렉토리의 임시 env 파일을 수정하면 자동으로 해당 인스턴스가 재시작된다
• 원본 .env 파일 보호: CLI가 관리하는 임시 파일만 변경되며 원본 .env는 수정되지 않는다
• 다중 인스턴스 동시 실행: npx multi-env run 명령으로 여러 Node.js 인스턴스를 동시에 실행 가능하다
• 인스턴스 라이프사이클 관리: list 명령으로 실행 중인 인스턴스 조회, kill 명령으로 특정 인스턴스 종료, auto-cleanup 옵션으로 자동 정리 기능 제공
• 플러그 앤 플레이 방식: npm install -g multi-env-cli 또는 npx로 설치 없이 즉시 사용 가능하다

Key Takeaway

Node.js 다중 환경 개발 워크플로우에서 환경 변수의 핫 리로드와 인스턴스 중앙 관리를 도입하면 서버 재시작 횟수 제거와 운영 오류 감소를 동시에 달성할 수 있다.