운영 런북¶
이 섹션은 SeMu-GPT 2026 스택을 개발·운영하는 데 필요한 절차 모음이다. 기능 카탈로그가 "코드가 어떻게 동작하는가"를 설명한다면, 런북은 "장애·배포·시크릿 회전 시 무엇을 어떤 순서로 하는가"에 대한 답을 제공한다.
각 페이지는 8섹션 기능 템플릿 대신 "진단 → 복구 절차 → 모니터링" 패턴을 따른다.
런북 페이지 안내¶
| 페이지 | 다루는 범위 | 일차 청중 |
|---|---|---|
| 개발 환경 | 로컬 셋업(pnpm + uv + Docker), ./scripts/dev-local.sh, dev URL semu-gpt-dev.bootalk.co.kr 운영 (Lightsail box 관리·디스크 풀 대응·SSH 접근) |
신규 개발자, 일상적 dev 운영자 |
| 운영 배포 | Production 인프라(레거시 tax-gpt + soft-launch new.semugpt.co.kr), Issue #151 cutover plan, pre-cutover 코드 변경(4.5a~4.5g), 데이터 복사 절차 |
배포 담당자, 인수인계 후 클라이언트 팀 |
| 시크릿 관리 | JWT / Toss / OpenAI / Langfuse / Naver SENS / AWS / RDS / Lightsail SSH / Slack webhook 위치 및 회전 절차 | 보안 담당자, 시크릿 회전 작업자 |
| 모니터링 | Sentry, Langfuse trace, Lightsail health-monitor cron, Slack 알림 운영 | 운영 담당자 |
| 복구 절차 | 백엔드 503/502, 디스크 풀, 인증서 만료, RDS 문제 등 시나리오별 복구 | 온콜(on-call) |
| 알려진 이슈 | 코드/인프라 상 남아 있는 한계, 워크어라운드, 개선 예정 | 모든 기여자 |
1차 출처 (Source of Truth)¶
이 런북 페이지들은 레포 루트의 CLAUDE.md(특히 "Dev Environment 운영" / "Production Infrastructure" 섹션)와 docs/superpowers/specs/2026-05-03-production-deployment.md 두 파일을 1차 출처로 한다. 인프라 사실(IP, account ID, ARN, 비용 등)이 변경되면 저쪽을 먼저 갱신하고, 이 런북은 요약을 따라간다.