TypeScript 미드레벨 배포·운영 기술면접

빌드와 배포를 분리하면 동일한 아티팩트를 여러 환경에 배포하여 일관성을 보장할 수 있습니다. TypeScript 컴파일은 빌드 단계에서 한 번만 수행하고, 환경변수는 런타임에 주입하거나 배포 단계에서 환경별 설정 파일을 교체합니다. 이를 위해 process.env 대신 설정 서비스를 사용하거나, Docker 이미지에 빌드 결과만 포함하고 환경변수를 컨테이너 실행 시 주입합니다. GitHub Actions에서는 build job에서 dist 폴더를 아티팩트로 업로드하고, deploy job에서 다운로드하여 환경별로 배포합니다. 이 방식은 빌드 시간을 절약하고, 프로덕션에 배포되는 코드가 스테이징에서 검증된 것과 동일함을 보장합니다.

무중단 배포 시 Pod 종료 과정에서 로드밸런서가 아직 트래픽을 보내거나 진행 중인 요청이 중단될 수 있습니다. readinessProbe는 서버가 트래픽을 받을 준비가 되었는지 확인하고, livenessProbe는 서버가 정상 동작하는지 확인합니다. graceful shutdown은 SIGTERM 시그널을 받으면 새로운 연결을 거부하고 기존 요청이 완료될 때까지 대기한 후 종료합니다. Express에서는 server.close()로 새 연결을 차단하고 setTimeout으로 강제 종료 타임아웃을 설정합니다. preStop hook에서 sleep을 추가하여 로드밸런서가 엔드포인트를 제거할 시간을 확보합니다. readinessProbe 엔드포인트에서는 종료 신호를 받으면 unhealthy를 반환하여 트래픽을 먼저 차단합니다.

구조화된 로깅은 로그를 JSON 형태로 출력하여 검색, 필터링, 집계가 용이하도록 합니다. Winston이나 Pino 같은 라이브러리를 사용하여 timestamp, level, message, context를 포함한 구조화된 로그를 생성합니다. Correlation ID는 요청 진입점에서 생성하거나 헤더에서 추출하여 AsyncLocalStorage나 cls-hooked를 사용해 요청 생명주기 동안 전파합니다. Express 미들웨어에서 요청마다 고유 ID를 생성하고, 모든 로그와 외부 API 호출 헤더에 포함시킵니다. ELK 스택에서는 Correlation ID를 키로 사용하여 분산 시스템의 여러 서비스 로그를 하나의 요청 플로우로 연결하여 추적할 수 있습니다. 이를 통해 에러 발생 시 전체 요청 경로를 빠르게 파악할 수 있습니다.