운영 배포와 보존 검증 결과를 기록

This commit is contained in:
Yun Chan 2026-10-20 17:06:49 +09:00
parent aeddaa6972
commit d2ba836565
5 changed files with 161 additions and 16 deletions

View file

@ -1,7 +1,7 @@
# 배포 파이프라인 (Deployment Pipeline)
> 작성: 2026-08-31 · 2026-09-12 현행화 · 문서 소유: docs/ops
> 상태: **2026-09-12 UX SHA `e8b770e4d9023238bf210b412de75dcb98bfc08e`의 Cloudflare Pages와 NAS web 전용 배포는 완료**했다. 운영 인증 세션이 401로 만료돼 내부 UI 검증은 마지막 열린 게이트이며, 이를 전체 운영 검증 완료로 선언하지 않는다.
> 작성: 2026-08-31 · 2026-10-20 현행화 · 문서 소유: docs/ops
> 상태: Forgejo `master` SHA `aeddaa6972cafabec8113745037533893db0ac34` push, Cloudflare Pages production(`f2039a2e`), NAS API/web 배포와 migration 25 적용을 완료했다. 인증된 운영 내부 UI는 이번 세션에서 검증하지 않았으므로 전체 운영 검증 완료를 선언하지 않는다.
## 목표 아키텍처 (소유자 지시)
@ -161,6 +161,15 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d
- **앱 증상 연결**: `apps/web/src/lib/auth.tsx`의 `restoreCurrentUser`는 `GET /auth/me`를 3회 재시도(지연 0/400/1000ms, 각 5초 abort) 후 실패하면 `restoreState="failed"`가 되고, `apps/web/src/App.tsx:113-135`의 "서버 연결 진단" 화면이 뜬다. 401만 정상 로그아웃으로 처리되며 530을 포함한 나머지 실패는 모두 이 화면으로 떨어진다.
- **미해결**: 부팅 시 cloudflared 자동 시작 등록은 아직 없다(REQ-008 계열 열린 게이트). 등록 방식은 미정이다.
## 5.6 승인 릴리스 배포 완료 (2026-10-20, SHA `aeddaa6972cafabec8113745037533893db0ac34`)
- Forgejo `master` push는 완료했고 Cloudflare Pages production `f2039a2e`를 `main` 브랜치에 배포했다. 공개 `https://vignette.chanpaca.net`에서 desktop/mobile 로그인 화면은 정상 렌더, page error·import 오류는 각각 0건, 무인증 `/auth/me`는 401이었다. 이 검증은 인증된 내부 화면 검증이 아니다.
- Pages entry `/assets/index-BAtV-qxp.js`와 stylesheet `/assets/index-CNzKarrr.css`의 공개 SHA-256은 로컬 산출물과 일치했고 이전 세대 자산 179개를 보존했다. `pages.dev` 주소는 API CORS 비허용으로 재연결 화면을 보여 로그인 정상 판정 근거에서 제외했다.
- 사전 검증은 API legacy 1263 passed·1 skipped·1 warning, engine gateway 82 passed·1 warning, harness 68 passed, API types/typecheck/build/SSOT checker 통과다. 처음 desktop/mobile focused 실행의 10개 실패는 API 미기동 환경 원인이었고, 스택 기동 뒤 desktop 9 passed·mobile 9 passed와 별도 `single-run` 15 passed를 재확인했다.
- NAS API(`sha256:309ccd2d…`)와 web(`sha256:6ca536db…`)을 교체하고 migration 25를 트랜잭션으로 적용했다. admin-only DELETE policy `app.current_role_name() = 'admin'`를 실증했다. engine·DB 컨테이너 ID/이미지/volume source와 runtime compose는 그대로 보존했다.
- DB dump 11,892,253 bytes와 TOC, uploads 93개·52,973 bytes·manifest SHA-256 `2e7f31a28d3d7f527f62092b3adfc96bf92f5cd35769a498d242b99cbeae43d2`를 보존했다. 118개 테이블의 전후 행 수가 모두 같고, 행 수가 달라지거나 줄어든 테이블은 각각 0개다. retention dry-run은 raw 90일·rollup 365일에서 `applied=false`, 삭제 0으로 끝났으며 실제 apply는 별도 소유자 승인 대상이다.
- `nginx -t`, 공개 health 3회(200, `status=ok`, `db=true`, `engine=true`), 무인증 `/auth/me` 401의 정확한 CORS origin/credentials, auth config/OpenAPI 200, Google 로그인 시작 302을 확인했다. API 단일 교체 중 curl reset/empty reply가 있었고 이후 회복했으므로 무중단 배포를 주장하지 않는다. 인증된 운영 내부 UI, Jev 품질/실제 대사, 외부·임상 gate는 열린 상태다. 구조화 증거: [`release-2026-10-20.json`](./evidence/release-2026-10-20.json).
## 6. 남은 구성 작업 (TODO)
- [ ] Forgejo master 기준 NAS 자동배포 후크(수동 절차는 §5, §5.1로 실증 완료)