07. 배포하고 운영하기

목표

변경을 안전하게 배포하고, 실제 환경에서 의도한 상태를 확인하며, 문제가 생겼을 때 되돌릴 기준을 준비합니다.

핵심 설명

로컬 검증 통과, 코드 병합, 프로덕션 배포, 사용자 결과 확인은 서로 다른 상태입니다. 각 상태를 구분하면 “코드는 끝났지만 배포되지 않은 변경”이나 “배포됐지만 실제 동작을 확인하지 않은 변경”을 완료로 오해하지 않습니다.

배포 전에 테스트·빌드·diff·정책 변경을 다시 확인합니다. 가능하면 Preview에서 실제 경로와 반응형 화면을 검토하고, 팀의 승인 절차를 거쳐 Production으로 이동합니다. 배포 뒤에는 핵심 사용자 경로를 안전한 테스트 데이터로 확인합니다. 문의 폼이라면 실제 고객 데이터를 만들거나 외부 알림을 반복 전송하지 않도록 운영 검증 방법을 미리 정해야 합니다.

관측할 신호와 롤백 조건도 배포 전에 적습니다. 오류율, 요청 중복, 폼 완료율처럼 이번 변경과 직접 연결되는 작은 신호부터 봅니다. 문제가 발견됐을 때 이전 배포로 되돌릴지, 기능을 끌지, 수정 배포를 할지는 영향과 복구 시간에 따라 결정합니다.

체크리스트

• 로컬 완료, 병합, 배포, 운영 확인 상태를 구분했습니다.
• 릴리스 게이트의 테스트와 빌드가 통과했습니다.
• Preview 또는 이에 준하는 환경에서 핵심 경로를 확인했습니다.
• 배포 승인 권한과 시점을 확인했습니다.
• 운영 검증에 안전한 데이터와 절차를 사용합니다.
• 배포 뒤 확인할 신호와 관찰 시간을 정했습니다.
• 롤백 대상과 실행 조건을 알고 있습니다.
• 실제 배포 상태를 확인하기 전 “배포 완료”라고 보고하지 않습니다.

직접 해보기

릴리스 대상:
필수 게이트:
승인자 또는 승인 조건:
배포 뒤 확인할 사용자 경로:
관측할 신호:
롤백 조건:
롤백 방법:
남은 위험:

가상 배포를 기준으로 검증 통과 → Preview 확인 → 승인 → Production → smoke test → 관측 순서를 설명해 봅니다. 실제 배포 권한이 없다면 실행하지 않고 승인 지점에서 멈추는 것도 올바른 결과입니다.

완료 근거

• 어떤 버전이 어떤 환경에 배포됐는지 식별할 수 있습니다.
• 실제 환경에서 핵심 경로를 확인한 결과가 있습니다.
• 관측 신호가 정상 범위인지 확인했습니다.
• 문제 발생 시 사용할 롤백 절차가 실행 가능 상태입니다.
• 남은 위험과 후속 작업이 기록되어 있습니다.

한 번의 배포로 학습 경로가 끝나는 것은 아닙니다. 운영에서 얻은 증거를 새 컨텍스트로 삼아 다시 문제와 완료 조건을 정의합니다. 자주 만나는 상황은 Recipes에서, 용어와 양식은 Reference에서 찾습니다.