| name | bepo |
| description | 구현 완료 슬라이스를 프로덕션에 올리고 라이브로 실증한 뒤 문서·커밋까지 닫는 일괄 마감 절차 — db push(서울 pooler)·함수 deploy(재시도·실측)·CF Pages·프로드 통합/2탭 E2E·백로그 §0/GAP/drift 문서 마감. "배포하고 라이브테스트", "라이브로 올려", "페이즈 마감", "배포 몰아치기" 요청 시. |
| user_invocable | true |
| tags | ["deploy","verify","docs","release"] |
| trigger | 슬라이스/페이즈 완료분을 프로드 반영+라이브 검증+문서 마감까지 한 번에 닫을 때 |
| version | 1 |
bepo — 배포 → 라이브 실증 → 문서 마감 일괄
전제: 구현 + 로컬 실측(supabase-slice-verify)이 끝난 상태. 배포·커밋·push 는 주인님 승인 후에만 — 이 스킬은 승인 이후의 실행 순서와 함정을 고정한다. 검증은 성역: 각 단계의 "성공"은 실측(psql·functions list·PASS 카운트)으로만 주장한다.
순서
① 프리플라이트 — npm run check:all(tsc·lint·test·build·docs:check·docs:drift 일괄) + 변경 Edge fn deno check --node-modules-dir=auto <fn>/index.ts. _shared/ 공유 파일을 건드렸으면 전 함수 스윕: deno check --node-modules-dir=auto supabase/functions/*/index.ts.
② 백엔드 배포
- 마이그:
PW=$(awk -F= '/^SUPABASE_DB_PASSWORD=/{print $2}' .env); supabase db push --db-url "postgresql://postgres.owfcrolbvikkqrotmleq:${PW}@aws-1-ap-northeast-2.pooler.supabase.com:5432/postgres" → 직후 같은 URL psql 로 테이블/정책/cron 실존 실측.
- 함수:
export SUPABASE_ACCESS_TOKEN=$(awk -F= '/^SUPABASE_ACCESS_TOKEN=/{print $2}' .env); supabase functions deploy [이름…] — _shared/ 수정 시 이름 생략(전체 배포 = 드리프트 근절 관례).
③ 프론트 — cf-pages-deploy-verify 스킬 그대로(빌드 → 번들 비밀키 감사(awk 판) → wrangler → curl 3종 200).
④ 라이브 실증 — 로컬 통합테스트 .mjs 를 그대로 프로드로 재조준:
- env 스위칭만으로 재사용:
SUPABASE_URL=https://owfcrolbvikkqrotmleq.supabase.co + ANON_KEY/SERVICE_ROLE_KEY(awk 로 .env 추출) + LiveKit 3종. 테스트 방·행은 finally 정리(테스트 유저 잔존은 무해 관례).
- UI 와이어까지 검증 대상이면 배포판 2탭 E2E(
supabase-slice-verify의 deployed-room-e2e.mjs, BASE=<배포 URL>) — 신규 어서션은 그 템플릿 위에 얹는다.
⑤ 문서 마감 + 커밋 — 백로그 §0 [x]+실측 증거(probe 주석 유지·자동 [x] 금지) → GAP-MATRIX 진행 로그 1줄 → npm run docs:check && npm run docs:drift(STALE/REGRESSION 0) → 명시 파일 목록으로 커밋(병행 세션 스윕 방지) → push(승인분).
함정 (2026-07-11~12 페이즈루프 실측)
- rtk: .env 에 grep 전면 금지 — 값 추출은 전부 awk. 위반 시 시크릿이 세션 로그에 노출된다(3회 사고 이력).
- deploy 를 파이프에 물리면 awk/tail 이 exit code 를 삼킨다 —
supabase functions deploy > log 2>&1; echo $? 로 종료코드 보존. "성공처럼 보이는 실패"의 근원.
- functions deploy 는 JSR DNS 일시장애로 죽을 수 있다(
jsr.io … Temporary failure in name resolution) — 그냥 재시도. 부분 배포는 무해(성공분은 이미 등록됨).
- 배포 성공 판정은
supabase functions list 의 버전·갱신시각 실측 — 배포본이 소스보다 오래될 수 있다(deployed-fn drift). "명령이 돌았다" ≠ "배포됐다".
- LIVEKIT_SERVER_URL 은 .env 에 없다 —
VITE_LIVEKIT_URL 을 리네임해 주입: awk -F= '/^VITE_LIVEKIT_URL=/{sub(/^VITE_LIVEKIT_URL/,"LIVEKIT_SERVER_URL"); print}' .env.
- fn.env 실키는 검증 끝나면 즉시 더미 복구 + serve 종료(
pkill -f "supabase functions serve") — scratch 에 실키 잔존 금지(성역).
- DEV 훅은 프로드 번들에 없다(
__streamAvatar 등 import.meta.env.DEV 게이트) — 프로드 실증은 프로드에서 잡히는 ground truth 로 대체(예: 캔버스 픽셀 시간변화 = 렌더 루프 구동 증명, preserveDrawingBuffer 필요).
- 소셜우선 로그인: E2E 는
[이메일로 로그인] 클릭 선행(deployed-room-e2e.mjs 템플릿 반영됨, 2026-07-12).
Verify (완료 체크)
관련
cf-pages-deploy-verify(③ 상세) · supabase-slice-verify(로컬 하네스·E2E 템플릿) · /backlog(백로그 소스·배포 게이트)- 메모리:
rtk-grep-secret-leak · deployed-fn-drift · chatterbox-e2e-traps
