Feature #1536
open
중안
[T30] 1차 Staging 통합 배포·운영 검증
Feature #1536:
[T30] 1차 Staging 통합 배포·운영 검증
Start date:
11/23/2026
Due date:
12/04/2026 (Due in 17 days)
% Done:
0%
Estimated time:
Description
검토 및 착수 조건¶
- 담당 역할: QA/운영. 신청자: 안중섭 (GitHub skshdwkdvkfl55-art). PM 담당 확정 전.
- 원문 우선순위: P1. 선행 일감: T12, T13, T14, T19, T28, T29. 기준 브랜치: main.
- 선행 일감이 미완료면 설계 또는 mock까지만 진행하고 실연동은 HOLD로 보고한다.
작업 범위와 산출물¶
- 승인된 Frontend·Backend·DB 버전의 Staging 통합 동작과 장애 시 복구 절차를 검증한다.
- CI→GHCR→Ubuntu Pull 자동배포, /api/version 기대 SHA, DB volume·Seed·권한, 프런트 페이지·API·헬스를 확인하고 성공·실패를 구분한다.
- 산출물: docs/deployment/RELEASE_EVIDENCE.md, SHA·digest·health 기록, rollback runbook.
- task/t30-short-name 개인 브랜치에서 작업하고 PR을 연다.
완료 기준 및 주의¶
- 승인 릴리스의 화면·API·DB·버전과 상태 Healthy PASS, DB·복구 검증.
- 대상 외 운영 Docker 프로젝트 금지, DB volume 보존, 자동 migration 금지.
- PR에 재현 명령, 테스트 결과, CI URL과 SHA를 기록하고 민감정보를 포함하지 않는다.
상태 보고: T30_STATUS=NOT_STARTED|IN_PROGRESS|PASS|PARTIAL|HOLD / PR_URL= / EVIDENCE= / BLOCKER=
Subtasks
Related issues
상이 Updated by 상재 이 11 days ago
[T06 API 계약 검토 중 발견 — T30 담당 안중섭님 확인 부탁드립니다] (작성: 이상재, T06 #1529)
h3. 경로 접두사 불일치
- T13 Backend 골격(main, PR #14)은 앱 안에서 @API_V1_PREFIX = "/api/v1"@ 을 씁니다 (backend/app/core/config.py).
- Staging Nginx는 @/api/@ 를 떼고 FastAPI로 넘깁니다 (poc/staging/README.md, PR #18).
- 그대로 배포하면 외부 @/api/v1/auth/login@ 요청이 앱에 @/v1/auth/login@ 으로 도착해 404 가 납니다. @/api/health@, @/api/version@ 은 앱 경로가 @/health@, @/version@ 이라 문제없습니다.
h3. 해결안 (둘 중 하나)
앱 접두사를 @/v1@ 로 변경 (Nginx 그대로)¶
Nginx가 @/api/v1/@ 은 떼지 않고 그대로 넘기도록 변경 (앱 그대로)¶
API 계약(T06)의 외부 주소 @/api/v1/...@ 는 어느 쪽이든 바뀌지 않습니다.