배포 및 운영 전략
배포 대상과 롤링·카나리·블루그린 배포를 용량과 되돌리기의 목표로 비교하고, 신호에서 완화와 복구로 이어지는 운영의 흐름을 정리한 뒤, 이 장의 API를 한 번에 확인하는 점검 스크립트와 종료 처리를 마지막 과제로 만듭니다.
앞 글의 배포 작업은 기존 컨테이너를 지우고 새 컨테이너를 띄웁니다. 그 사이에 들어온 요청은 실패하고, 새 서버가 정말 요청을 처리할 수 있는지는 아무도 확인하지 않습니다. 이 글은 멈추지 않고 새 버전을 올리는 방법과 문제가 생겼을 때의 순서를 정리하고, 배포한 서버를 스스로 점검하는 스크립트를 만듭니다.
이 글을 읽고 나면 다음을 할 수 있습니다.
- 서비스의 조건에 맞는 배포 대상과 배포 전략을 고르고, 되돌릴 때 함께 돌아가야 하는 것을 구별합니다.
- 장애 알림을 받았을 때 무엇부터 보고 무엇부터 할지 순서를 세웁니다.
- 이 장의 API가 약속대로 동작하는지 한 번에 확인하는 점검 스크립트를 만들고, 서버가 종료 신호에 정리 작업을 하게 고칩니다.
본문은 읽으며 판단하는 내용이고, 직접 만드는 것은 다음 장 실습입니다. 과제에는 이 장의 서버와 데이터베이스, 그리고 앞 글의 연습 4에서 만든 /health 경로가 필요합니다. 예로 드는 서비스 이름은 AWS의 것이지만, 다른 클라우드나 직접 운영하는 서버에도 같은 원리가 적용됩니다.
배포 대상 고르기
애플리케이션을 어디에서 실행할지는 서비스의 규모와 예산, 팀이 감당할 수 있는 운영의 양에 따라 고릅니다.
| 대상 | 예 | 잘 맞는 경우 | 감당할 것 |
|---|---|---|---|
| 가상 머신 | EC2, Compute Engine | 작은 서비스, 학습, 설정을 직접 정해야 하는 경우 | 운영체제와 런타임의 관리, 확장과 장애 대비를 직접 구성 |
| 컨테이너 서비스 | ECS와 Fargate, Kubernetes | 컨테이너로 만든 여러 서비스를 함께 운영하는 경우 | 설정의 복잡도와 학습, 늘어나는 비용 |
| 서버리스 함수 | Lambda, Cloud Functions | 짧게 실행되는 이벤트 처리와 API | 실행 시간의 제한, 콜드 스타트의 지연, 상태를 갖기 어려움 |
| 정적 호스팅과 CDN | Amplify, Vercel, Cloudflare Pages | 빌드한 SPA 같은 정적 파일 | 서버 로직은 따로 배포 |
이 장의 애플리케이션이라면 클라이언트는 정적 호스팅이나 CDN에 올리고, 서버는 앞 글의 Docker 이미지를 컨테이너 서비스로 실행할 수 있습니다. 앞 글처럼 가상 머신 한 대에 올리면 시작하기는 쉽지만 그 서버가 멈추면 서비스 전체가 멈춥니다.
멈추지 않고 새 버전 올리기
새 버전을 올리는 방식은 한 번에 영향을 받는 사용자의 범위와, 문제가 생겼을 때 되돌려야 하는 속도로 고릅니다.
- 롤링 배포(rolling update)는 인스턴스를 몇 개씩 차례로 새 버전으로 바꿉니다. 남은 인스턴스가 요청을 받을 여유 용량, 새 인스턴스가 준비되었는지 보는 준비 상태(readiness) 검사, 내려가는 인스턴스가 처리 중인 요청을 마치게 하는 연결 정리가 필요합니다. 두 버전이 잠시 함께 요청을 받으므로 같은 데이터베이스에서 함께 동작해야 합니다.
- 카나리 배포(canary)는 새 버전에 사용자의 일부만 먼저 보내 오류와 지연을 지켜본 뒤 비율을 늘립니다. 비교할 수 있는 신호가 있어야 판단할 수 있으며, 비율이 낮다는 것만으로 안전한 것은 아닙니다.
- 블루그린 배포(blue-green)는 같은 환경을 두 벌 두고 쉬고 있는 쪽에 새 버전을 올려 확인한 뒤 트래픽을 한 번에 옮깁니다. 옛 환경으로 빠르게 돌아갈 수 있지만 두 환경의 용량이 필요합니다.
DEPLOYMENT STRATEGY
폭발 반경과 rollback 목표로 배포 전략을 고른다
배포 전략 비교를 위한 질문입니다. 용량·트래픽 제어·상태 지표·이전 버전 호환성을 함께 검토합니다. 세 경로는 단순 자동 결정 규칙이 아니며, 어떤 방식도 image 교체만으로 데이터 변경을 되돌리지 않습니다.
- 제약 수집 → 전략 비교
가용 용량·트래픽 분할·준비 완료·상태 지표와 DB 호환성을 확인합니다. 아래는 선택지 비교이며 실행 순서가 아닙니다.
- Rolling · 제한된 교체 묶음
readiness·여유 용량·연결 drain과 구·신 버전 공존 호환성을 확인합니다. rollback은 역방향 교체 과정이 필요합니다.
- Canary · 일부 트래픽 검증
비교 가능한 사용자·부하와 오류·지연 신호를 확인한 뒤 노출을 늘립니다. 낮은 비율 자체가 안전을 보장하지 않습니다.
- Blue-green · 트래픽 경로 전환
두 환경의 용량과 readiness를 준비합니다. 이전 환경을 유지하고 schema·데이터가 호환돼야 돌아갈 수 있습니다.
- 핵심 지점
- 진행·선택 경로
롤백 목표는 image뿐 아니라 실행 설정·라우팅·데이터 상태까지 포함합니다. 측정 결과와 운영 제약에 맞춰 전략을 정합니다.
그림은 이 세 방식을 고르는 질문입니다. 여유 용량과 트래픽을 나눌 수 있는지 같은 제약을 먼저 모으고, 영향을 받는 범위와 되돌리는 목표를 함께 놓고 비교합니다. 세 갈래는 조건을 넣으면 답이 나오는 규칙이 아니라 비교할 선택지입니다.
앞 글의 배포 작업은 이 셋 가운데 어느 방식일까요? 먼저 생각해 보세요.
결과 확인하기
어느 것도 아닙니다. 인스턴스가 하나뿐이고 기존 컨테이너를 지운 뒤에 새 컨테이너를 띄우므로, 그 사이에는 요청을 받을 서버가 없습니다. 세 방식은 모두 새 버전이 준비되는 동안 요청을 받을 다른 인스턴스나 환경이 있다는 것을 전제로 합니다.
새 서버가 준비되었는지는 서버에 직접 물어봅니다. 앞 글의 연습 4에서 만든 GET /health가 그 경로이고, 롤링 배포의 준비 상태 검사는 이런 경로가 200을 돌려줄 때까지 새 인스턴스에 요청을 보내지 않습니다. 그 뒤에는 로그인과 프로필 조회 같은 핵심 기능이 동작하는지도 확인하며, 다음 장 실습에서 그 확인을 스크립트로 만듭니다.
되돌릴 때 함께 돌아가야 하는 것
되돌리기의 대상은 이미지만이 아니라 실행 설정과 트래픽의 경로, 데이터의 상태까지입니다. 이미지를 이전 버전으로 바꾼다고 이미 바뀐 스키마나 데이터가 돌아오지는 않으므로, ORM 사용에서 본 것처럼 스키마는 두 버전이 함께 쓸 수 있도록 확장, 공존, 백필, 전환, 관찰, 축소의 순서로 바꿉니다. 이전 이미지도 레지스트리에 남겨 두며, 앞 글의 연습 3에서 커밋 해시 태그로 배포하게 고친 것이 그 준비입니다.
JWT_SECRET 같은 비밀 값은 이미지에 넣지 않고 실행할 때 환경 변수나 비밀 관리 서비스로 넣습니다. 유출이 의심되면 값을 바꾸는데, JWT_SECRET을 바꾸면 이미 발급한 토큰이 모두 무효가 됩니다.
운영 중의 신호와 대응
운영 중에는 서비스의 상태를 세 가지 신호로 봅니다. 로그(log)는 사건의 기록, 지표(metric)는 오류율이나 응답 시간처럼 시간에 따라 모은 숫자, 추적(trace)은 요청 하나가 거친 경로와 시간입니다. 로그는 타입스크립트 디버깅 기법에서 본 것처럼 구조화된 한 줄로 남기되 토큰과 비밀번호의 원문은 남기지 않습니다. 알림은 CPU 사용률 같은 내부 숫자보다 사용자가 겪는 오류율과 응답 시간을 기준으로, 미리 정한 서비스 수준 목표(SLO)를 벗어나는 정도에 따라 겁니다.
알림을 받으면 사용자에게 보이는 신호에서 시작해 세 신호를 함께 보고, 최근의 배포나 설정 변경과 시점을 맞추어 봅니다. 시점이 겹친다고 원인이 확정되는 것은 아니므로, 원인을 단정하기 전에 최근 배포를 되돌리거나 문제가 된 기능을 끄는 식으로 피해부터 줄입니다. 그다음 필요하면 복구하고, 사용자의 지표와 핵심 기능으로 회복을 확인합니다. 회복되었다면 대응 절차서인 런북(runbook)과 같은 문제를 다시 잡아내는 검사로 배운 것을 남깁니다.
SLO RESPONSE LOOP
사용자 신호에서 완화와 학습까지 한 운영 루프로 닫는다
사용자 영향 신호로 대응을 시작하고 로그·metric·trace와 최근 변경을 대조합니다. 원인을 단정하기 전에 피해를 줄이고, 필요한 rollback·복구 후 사용자 지표로 회복을 검증해 runbook에 남기는 운영 목표입니다.
- SLO signal → 신호 상관
오류·지연 등 사용자 영향과 logs·metrics·traces를 확인합니다. 상관관계만으로 원인을 확정하지 않습니다.
- 최근 변경 확인 → 먼저 완화
deploy·config·부하를 대조하고 피해를 줄일 조치를 선택합니다. 확인되지 않은 자동 임계치·rollback을 가정하지 않습니다.
- 필요한 Rollback·Recover
정상 상태로 복구합니다. 데이터·schema 호환성과 실제 가역성을 확인합니다.
- 복구 후 Verify
사용자 지표와 핵심 동작으로 회복을 확인합니다. 회복되지 않으면 원인 분석·완화를 반복합니다.
- 학습 보존
원인·조치·한계를 runbook과 회귀 방지에 반영합니다.
- 핵심 지점
- 진행·선택 경로
복구 검증에 실패하면 원인 분석·완화를 반복합니다. 로그에 password·JWT·개인정보를 기록하지 않고 필요한 상관 식별자를 남깁니다.
그림은 방금 설명한 순서를 한 줄로 이은 것입니다. 사용자에게 보이는 신호, 세 신호의 대조, 최근 변경의 확인, 완화, 복구, 회복의 확인, 배운 것의 기록이 차례로 이어지고, 회복의 확인에서 실패하면 앞의 대조와 완화로 돌아갑니다.
보안과 확장의 기본
운영 환경에서는 모든 통신을 HTTPS로 암호화하고(인증서), 데이터베이스는 서버에서만 접근하게 하며, npm audit이나 Dependabot으로 취약한 패키지를 찾습니다. 이 장의 서버가 하지 않은 로그인 시도 횟수의 제한과 토큰의 폐기도 운영 전에 갖춥니다. 사용자가 늘면 같은 서버를 여러 대로 늘리는 수평 확장을 쓰고, 캐시 같은 장치는 성능 최적화와 프로파일링의 순서대로 측정해서 찾은 병목에 맞추어 더합니다.
더 깊이: 컨테이너가 멈출 때 서버가 받는 신호
롤링 배포의 연결 정리는 컨테이너를 멈추는 순서와 맞물립니다. Docker의 docker stop 문서에 따르면 별도로 종료 신호를 지정하지 않은 컨테이너의 주 프로세스는 먼저 SIGTERM을 받고, 유예 시간(Linux 컨테이너의 기본값 10초)이 지나도 끝나지 않으면 SIGKILL로 강제로 끝납니다.
NestJS의 수명 주기 문서에 따르면 종료 신호를 듣는 리스너는 기본으로 꺼져 있고 enableShutdownHooks()를 불러야 켜지며, 켜 두면 onModuleDestroy(), beforeApplicationShutdown(), onApplicationShutdown()이 차례로 불립니다. 연결을 닫는 정리는 이 훅에 두고 유예 시간 안에 끝나게 합니다. Windows에서는 Ctrl+C로 SIGINT를 보내 종료 훅을 확인합니다. SIGTERM은 지원되지 않습니다.
정리
- 배포 대상은 서비스의 규모와 운영할 수 있는 양에 따라 고르며, 클라이언트와 서버를 다른 곳에 둘 수 있습니다.
- 롤링은 여유 용량과 준비 상태 검사, 카나리는 비교할 수 있는 신호, 블루그린은 두 환경의 용량이 필요하며, 셋 모두 요청을 받을 다른 인스턴스가 있다는 것을 전제로 합니다.
- 되돌리기는 설정과 트래픽의 경로, 데이터까지 포함하므로 스키마는 두 버전이 함께 쓸 수 있게 단계적으로 바꿉니다.
- 운영 중에는 사용자가 겪는 문제로 알림을 걸고, 원인을 단정하기 전에 피해를 줄이고 회복을 확인한 뒤 배운 것을 남깁니다.
연습 문제
1. 이미지를 되돌렸는데도
새 버전을 배포하면서 사용자 테이블의 name 컬럼을 지우고 displayName만 남기는 마이그레이션을 함께 적용했습니다. 오류가 늘어 이전 이미지로 되돌렸는데도 오류가 계속됩니다. 왜 그런가요?
해설 보기
이전 이미지의 코드는 여전히 name 컬럼을 읽는데, 그 컬럼은 이미 지워졌기 때문입니다. 컬럼을 바꾸는 일은 새 컬럼을 더하고 두 버전이 함께 동작하는 기간을 둔 뒤, 옛 코드가 더는 없다고 확인된 다음 배포에서 옛 컬럼을 지우는 순서로 나누어야 합니다.
2. 여러 대로 늘린 서버
서버를 세 대로 늘렸더니, 로그인한 사용자의 요청이 어느 서버로 가든 /auth/profile이 정상으로 동작했습니다. 로그인 상태를 서버의 메모리에 세션으로 저장했다면 어떤 문제가 생겼을까요?
해설 보기
로그인을 처리한 서버의 메모리에만 세션이 있으므로, 다음 요청이 다른 서버로 가면 그 서버는 세션을 모르고 401을 돌려줍니다. 이 장의 서버는 서명한 JWT와 데이터베이스의 사용자로 요청을 확인하므로, 세 서버가 같은 JWT_SECRET과 같은 데이터베이스를 쓰는 한 어느 서버든 같은 결과를 냅니다.
3. 종합 과제: 배포한 서버를 스스로 점검하게 만들기
장 실습: 서버의 배포 점검 자동화하기에서 회원가입·로그인·권한을 아홉 요청으로 검사하고 서버의 종료 처리를 연결합니다. 이 실습으로 16장의 프로젝트를 마무리합니다.