실무 가이드
환경별 기준표 만들기
프로젝트마다 다음 기준표를 유지합니다.
| 항목 | 개발 | 검증 | 운영 |
|---|---|---|---|
| OS | 개발자 PC 기준 | 운영 유사 | 운영 기준 |
| 실행 방식 | 직접 실행/IDE | IIS/pm2/Docker | IIS/pm2/Docker |
| 설정 파일 | 개발 설정 | 검증 설정 | 운영 설정 |
| DB | 개발 DB | 검증 DB | 운영 DB |
| 로그 레벨 | 상세 | 일반 | 운영 기준 |
표에는 실제 민감정보를 넣지 말고 설정 위치와 관리 책임만 적습니다.
스크립트 사용 기준
운영체제별로 다음 스크립트를 사용할 수 있습니다.
Windows CMD: *.bat
PowerShell: *.ps1
Linux/macOS Shell: *.sh
가능하면 PowerShell Core 기반 .ps1을 공통 자동화 기준으로 두고, 서버 환경에 맞춰 .bat 또는 .sh를 보조로 사용합니다.
환경 검증 항목
배포 전후로 다음을 확인합니다.
- .NET SDK/Runtime 버전
- Node.js 버전
HANDSTACK_HOME경로ack포트- 모듈 디렉터리와
module.json - 계약 파일 복사 여부
- 로그 파일 생성 여부
체크리스트
- 개발/검증/운영의 차이가 문서화되어 있는가?
- 운영 설정을 개발 PC에 복사하지 않아도 재현 가능한가?
- 스크립트 실행 결과가 OS마다 같은 목적을 달성하는가?
- 서버 수동 설정 후 확인 명령이 있는가?
- 신규 개발자가 하루 안에 로컬 실행을 재현할 수 있는가?