Choorai
KO EN
Ops Deep Dive

릴리즈/롤백 런북

배포 전 게이트, 배포 직후 검증, 롤백 트리거를 표준화해 운영 리스크를 줄입니다.

롤백 트리거 예시

  • 5xx 에러율 1% 이상 급증
  • 핵심 API p95 지연 2배 이상
  • 핵심 기능 장애 5분 이상 지속

배포 전 체크

  • 빌드/테스트/링크 점검 완료
  • 담당자(배포/검증/모니터링) 지정
  • 핫픽스 경로와 연락 채널 확정

배포 후 15분 검증

runbook
1) 핵심 URL 3개 샘플링
2) 5xx/4xx 비율 확인
3) 주요 사용자 플로우 1회 수행
4) 이상 시 즉시 롤백 여부 판단

롤백 실행 로그 템플릿

markdown
- Trigger: [what happened]
- Decision Time (KST): [YYYY-MM-DD HH:mm]
- Rollback Target: [deploy or revision]
- Owner: [name]
- Follow-up: [next action]

TL;DR

  • 릴리즈/롤백 운영 작업 시 필요한 최소 기준과 검증 포인트를 빠르게 확인합니다.
  • 실제 프로젝트 환경값(브랜치, 시크릿, URL, 임계치)은 팀 기준에 맞게 치환하세요.

사전 준비 (Prerequisites)

  • 대상 리포지토리와 실행 환경 접근 권한 확인
  • 로컬/CI에서 사용할 기본 명령어(`install`, `build`, `test`) 점검
  • 환경변수/시크릿/배포 대상 정보를 최신 상태로 정리

실행 순서 (Steps)

  1. 변경 목표와 범위를 한 줄로 고정한다.
  2. 핵심 변경(릴리즈/롤백 운영)을 최소 단위 커밋으로 적용한다.
  3. 검증 로그를 남기고 체크리스트/문서를 즉시 업데이트한다.

검증 (Validation)

  • 빌드/테스트가 현재 브랜치에서 재현 가능하게 통과하는지 확인
  • 핵심 경로(사용자 플로우 또는 운영 플로우)를 수동 샘플 점검
  • ko/en 문서와 링크가 동일 의도를 유지하는지 대조

문제 해결 (Troubleshooting)

  • 오류 발생 시 로그/요청 본문/환경값을 먼저 캡처한다.
  • 권한/환경변수/라우팅/빌드 산출물 순서로 원인을 좁힌다.
  • 임시 조치와 근본 원인 수정을 분리해 기록한다.

관련 문서 (References)

마지막 업데이트: 2026년 2월 22일 · 버전: v0.0.1

피드백 보내기

입력한 내용으로 새 이슈 페이지를 엽니다.

GitHub 이슈로 보내기