ttipo
bf102d758f
운영에서 조용히 문제를 일으킬 수 있는 지점들을 정리한다. - env 검증(fail-fast): 설정이 잘못되면 서버가 뜨지 않는다. 운영에서 DB_* 누락과 'change-me' 같은 예시 값 배포를 차단하고, 문제를 하나씩이 아니라 한 번에 모아 보여준다. DB_PASSWORD 가 없을 때 'password' 로 조용히 동작하던 폴백도 제거. - graceful shutdown: SIGTERM 시 요청·커넥션을 정리한 뒤 종료한다. 종료 로그는 OnApplicationShutdown 훅으로 남긴다 — process.on(signal) 로 직접 잡으면 Nest 의 종료 흐름에 간섭해 종료 코드가 달라진다. - 헬스체크 두 가지 결함 수정: pingCheck 기본 타임아웃 1초가 짧아 유휴 커넥션 재연결 시 정상 DB 를 down 으로 오판했고, 실패 응답이 SYS_001 로 덮여 어느 구성요소가 죽었는지 알 수 없었다. 모니터링이 읽는 엔드포인트이므로 표준 래퍼·에러 코드에서 제외한다. - Rate limiting 을 @nestjs/throttler 로 일원화 (express-rate-limit 제거). 두 리미터가 겹쳐 헤더의 한도와 실제 동작이 어긋나 있었다. - e2e 를 응답 계약 검증으로 교체. 기존 테스트는 없는 경로를 검사해 이미 실패 상태였다. - 로깅 규칙(logging.md) 신설 — 레벨 기준·민감정보 마스킹·traceId Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
A progressive Node.js framework for building efficient and scalable server-side applications.
Description
Nest framework TypeScript starter repository.
Project setup
$ npm install
Compile and run the project
# development
$ npm run start
# watch mode
$ npm run start:dev
# production mode
$ npm run start:prod
Run tests
# unit tests
$ npm run test
# e2e tests
$ npm run test:e2e
# test coverage
$ npm run test:cov
Deployment
When you're ready to deploy your NestJS application to production, there are some key steps you can take to ensure it runs as efficiently as possible. Check out the deployment documentation for more information.
If you are looking for a cloud-based platform to deploy your NestJS application, check out Mau, our official platform for deploying NestJS applications on AWS. Mau makes deployment straightforward and fast, requiring just a few simple steps:
$ npm install -g @nestjs/mau
$ mau deploy
With Mau, you can deploy your application in just a few clicks, allowing you to focus on building features rather than managing infrastructure.
Resources
Check out a few resources that may come in handy when working with NestJS:
- Visit the NestJS Documentation to learn more about the framework.
- For questions and support, please visit our Discord channel.
- To dive deeper and get more hands-on experience, check out our official video courses.
- Deploy your application to AWS with the help of NestJS Mau in just a few clicks.
- Visualize your application graph and interact with the NestJS application in real-time using NestJS Devtools.
- Need help with your project (part-time to full-time)? Check out our official enterprise support.
- To stay in the loop and get updates, follow us on X and LinkedIn.
- Looking for a job, or have a job to offer? Check out our official Jobs board.
Support
Nest is an MIT-licensed open source project. It can grow thanks to the sponsors and support by the amazing backers. If you'd like to join them, please read more here.
Stay in touch
- Author - Kamil Myśliwiec
- Website - https://nestjs.com
- Twitter - @nestframework
License
Nest is MIT licensed.