터널 컨테이너 전환·글꼴 분할 반영·NAS 정리 결과를 기록
This commit is contained in:
parent
8fc829feef
commit
371c297953
5 changed files with 66 additions and 7 deletions
|
|
@ -3,6 +3,7 @@
|
|||
> 상태와 증거의 SSOT는 [`docs/dev_dashboard.html`](../dev_dashboard.html), 실행 인덱스는 [`docs/TODO.md`](../TODO.md)다.
|
||||
> 2026-09-07 이전 완료 기록과 장문 이력은 [정리 전 백로그 원문](../archive/project-cleanup-2026-09-07/backlog-2026-06-26-before-cleanup.md)에 보존했다.
|
||||
> 2026-09-01 NAS 배포는 당시 [배포 증거](./evidence/nas-prod-deploy-2026-09-01.json)로 완료 기록을 남겼으며, 현재 live 상태 주장이나 후속 게이트 완료 선언이 아니다.
|
||||
> 2026-10-25 후속: 공개 터널을 자동 재시작 compose 컨테이너로 전환했고(`8fc829fe` 복구 스크립트), 글꼴 92분할본 `5c5b66d0`을 Pages `d4a089db`에 반영했다. 남은 것은 사이드바 배경 PNG 경량화, NAS web 이미지 갱신, Cloudflare LAX 경로 관찰이다([반영 영수증](./evidence/release-2026-10-25.json)).
|
||||
> 2026-10-25 운영 점검 결함 수정은 Forgejo `master` SHA `7facf961c5c48355e1c4a2e05e2688811f49b8db`의 NAS API만 승격했다. 감독·연구 주기 제출 번호 충돌, 로그인 확인 지연(`last_seen_at` 60초 간격), `openai` 단가 누락, 음성 합성 502 기록을 고쳤고 migration은 없다. [반영 영수증](./evidence/release-2026-10-25.json)을 따른다.
|
||||
> 2026-10-24 승인 릴리스는 Forgejo `master` SHA `b0ff44a1d4d3aed19b1bb0e1bbd0aab327aef0ea`의 NAS API/web 승격과 Pages production `42eef402`를 완료했다. 라우터 7 동기 갱신 복구·딥링크 next 보존·감독 경로 강제가 포함되며 migration은 없다. [배포 영수증](./evidence/release-2026-10-24.json)을 따른다.
|
||||
> 2026-10-20 승인 릴리스는 Forgejo `master` SHA `aeddaa6972cafabec8113745037533893db0ac34` push, Pages production, NAS API/web 승격과 migration 25 적용을 완료했다. 인증 운영 UI와 retention 실제 apply는 완료로 선언하지 않는다. [배포 영수증](./evidence/release-2026-10-20.json)을 따른다.
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
# 배포 파이프라인 (Deployment Pipeline)
|
||||
|
||||
> 작성: 2026-08-31 · 2026-10-25 현행화 · 문서 소유: docs/ops
|
||||
> 상태: 2026-10-25 Forgejo `master` SHA `7facf961c5c48355e1c4a2e05e2688811f49b8db`의 NAS API를 승격했다. web·engine·DB·Pages(`42eef402`)는 2026-10-24 상태 그대로다. 소유자 관리자 계정으로 인증된 운영 내부 화면 46개와 실제 상담 연습 1회를 확인했다(§5.8).
|
||||
> 상태: 2026-10-25 Forgejo `master` SHA `7facf961c5c48355e1c4a2e05e2688811f49b8db`의 NAS API를 승격했고, 같은 날 글꼴 분할본 `5c5b66d0`을 Pages production `d4a089db`에 반영했다. NAS web 이미지는 2026-10-24 상태다. 공개 터널은 자동 재시작 compose 컨테이너다(§5.8·§5.9).
|
||||
|
||||
## 목표 아키텍처 (소유자 지시)
|
||||
|
||||
|
|
@ -159,7 +159,7 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d
|
|||
- **함정**: `yunchan` 계정은 `/var/run/docker.sock`(root:root 660)에 접근 권한이 없어 `docker`·`docker compose` 명령이 전부 `permission denied`다. `sudo`는 비밀번호를 요구한다. 따라서 compose 기반 복구 명령은 현재 SSH 계정으로 실행할 수 없다.
|
||||
- **오진 기록**: 이 절은 원래 "cloudflared가 compose의 `profiles: [public-cutover-gate]` 게이트라 `--profile` 없이 `up -d` 하면 터널이 빠져 530이 재발한다"고 진단했으나, 이는 **오진이었다.** 근거: (1) 호스트 로그가 재부팅 직전(KST 03:09:06)까지 정상 갱신되고 있어 애초에 compose 컨테이너가 아닌 호스트 프로세스가 떠 있었다. (2) 재부팅 후 관측은 호스트 프로세스 부재(`ps -ef`)와 터널 엣지(`:7844`)로 나가는 연결 0건이었지 compose 프로파일 문제의 증상이 아니었다. (3) 이 판단은 §6의 "현재 `api-vignette`는 NAS 호스트 상주 cloudflared 터널 경유다" 기술과도 모순됐다. 이력을 지우지 않고 오진이었음을 남긴다.
|
||||
- **앱 증상 연결**: `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 계열 열린 게이트). 등록 방식은 미정이다.
|
||||
- **해결(2026-10-25)**: 공개 터널을 restart `unless-stopped` compose 컨테이너로 전환해 재부팅 자동 기동을 도커에 맡겼다. 위 호스트 상주 복구 절차는 대체 경로로만 남는다(§5.9).
|
||||
|
||||
## 5.6 승인 릴리스 배포 완료 (2026-10-20, SHA `aeddaa6972cafabec8113745037533893db0ac34`)
|
||||
|
||||
|
|
@ -187,6 +187,14 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d
|
|||
- 서버 정리: 재시작만 반복하던 `vignette-prod-cloudflared-1`(설정 권한 거부, 45,869회)과 2026-08 미리보기 `vignette-db-1`(45,664회)을 재시작 정책 `no`로 바꾸고 정지했다. 삭제하지 않았다. 공개 터널은 호스트 상주 cloudflared가 계속 맡는다.
|
||||
- 남은 위험: NAS 공유 호스트 과부하(부하 평균 13~17, 교체 공간 소진, 다른 프로젝트 소유 프로세스)와 재부팅 시 호스트 터널 자동 시작 부재. 구조화 증거: [`release-2026-10-25.json`](./evidence/release-2026-10-25.json).
|
||||
|
||||
## 5.9 소유자 결정 후속 조치 (2026-10-25, 글꼴 `5c5b66d0`·복구 스크립트 `8fc829fe`)
|
||||
|
||||
- **터널 컨테이너 전환**: 2026-09 전환 실패 원인은 `cloudflared/config.yml` 640(컨테이너 계정 65532가 못 읽음)과 빈 비밀 볼륨 `vignette-prod-cloudflared-secrets-20260830`이었다. config를 644로(상위 폴더 750 유지), 인증 파일을 볼륨에 65532 소유 400으로 복사한 뒤 `--profile public-cutover-gate up -d --no-deps --force-recreate cloudflared`로 띄웠다. 연결 4개(icn06/icn07, quic)가 등록됐고, 호스트 상주 cloudflared를 끈 상태에서 공개 health 10/10 200을 확인했다. 지금 공개 터널은 컨테이너 단독이다.
|
||||
- **복구 스크립트**: NAS 계정의 `ps`에는 컨테이너 프로세스가 보이지 않아 기존 중복 판정이 컨테이너를 놓쳤다. [`scripts/nas-recover-prod.sh`](../../scripts/nas-recover-prod.sh)는 `docker inspect`로 컨테이너를 먼저 판정·기동하고 실패할 때만 호스트 상주 터널을 띄운다. 컨테이너를 멈추고 실행해 재기동과 `RECOVER_DONE`을 확인했다. NAS 재부팅 자체는 공유 호스트라 실증하지 않았다.
|
||||
- **글꼴**: 첫 접속 때 최우선으로 받던 `PretendardVariable.woff2`(2,057,688 bytes) preload를 없애고 공식 92분할본(unicode-range)을 자체 호스팅했다. 공개 `/login` 첫 접속 글꼴 전송은 8요청 209,456 bytes이고, 변경 전후 로컬 화면 그림은 SHA-256까지 같다. 옛 전체 글꼴 파일은 이전 세대 CSS가 참조해 남겼다. web만 바뀌어 Pages(`d4a089db`)만 반영했고 NAS web 이미지는 다음 릴리스 때 갱신한다.
|
||||
- **NAS 정리**: 다른 프로젝트의 9일째 비밀번호 입력 대기 `createdb`와 5일 20시간 대기 Forgejo CI 작업 컨테이너를 소유자 승인으로 정리했다.
|
||||
- **남은 것**: Cloudflare가 한국 요청을 LAX 거점으로 처리해 Pages 자산이 초당 60~250KB로 내려온다(소유자 결정: 지켜보기, 실제 사용자 진단 보고 0건). 글꼴 뒤 병목은 사이드바 배경 PNG(1,168,196 bytes, 어두운 판 1,761,725 bytes)다. 구조화 증거: [`release-2026-10-25.json`](./evidence/release-2026-10-25.json)의 `followup_owner_decisions`.
|
||||
|
||||
## 6. 남은 구성 작업 (TODO)
|
||||
|
||||
- [ ] Forgejo master 기준 NAS 자동배포 후크(수동 절차는 §5, §5.1로 실증 완료)
|
||||
|
|
|
|||
|
|
@ -50,7 +50,9 @@
|
|||
"preflight": {
|
||||
"api": "1279 passed, 1 skipped, 1 warning",
|
||||
"engine_gateway": "82 passed, 1 warning",
|
||||
"web": ["check:api-types passed"]
|
||||
"web": [
|
||||
"check:api-types passed"
|
||||
]
|
||||
},
|
||||
"nas_preflight": {
|
||||
"receipt_path": "/volume1/docker/vignette-prod/receipts/release-20261025-20261025T103250Z",
|
||||
|
|
@ -106,11 +108,57 @@
|
|||
"같은 소유자 계정에 열린 오래된 회기가 여러 건 남아 있다(예: P4)."
|
||||
],
|
||||
"open_gates": [
|
||||
"NAS 재부팅 시 호스트 cloudflared 자동 시작 등록",
|
||||
"NAS 공유 호스트 I/O 과부하 원인 프로세스 정리(다른 프로젝트 소유자 결정)",
|
||||
"교수자 대시보드·사용자 목록 응답 크기와 지연 개선",
|
||||
"dev 전용 의존성 취약점(DEV-DEPS-001)",
|
||||
"JEV-002 실제 대사 관측과 JEV 품질 승격",
|
||||
"RETENTION-001 실제 apply의 별도 소유자 승인"
|
||||
]
|
||||
"RETENTION-001 실제 apply의 별도 소유자 승인",
|
||||
"장식 배경 PNG 경량화(background-light-sidebar 1,168,196 bytes·dark 1,761,725 bytes)",
|
||||
"NAS web 이미지를 글꼴 분할본 커밋으로 갱신",
|
||||
"Cloudflare LAX 경로 지켜보기(실제 사용자 진단 보고 발생 시 재검토)"
|
||||
],
|
||||
"followup_owner_decisions": {
|
||||
"decided_at": "2026-10-25",
|
||||
"decisions": {
|
||||
"tunnel": "컨테이너로 전환",
|
||||
"font": "지금 진행",
|
||||
"nas_stuck_jobs": "둘 다 정리",
|
||||
"cloudflare_route": "지켜보기"
|
||||
},
|
||||
"recheck_before_decisions": {
|
||||
"captured_utc": "2026-10-25T13:33Z",
|
||||
"server": "반영 뒤 약 3시간 요청 569건 200·5xx 0·Traceback 0, 감독·연구 주기 실패 0(수정 전 매시 1건)",
|
||||
"auth_me": "NAS 내부 0.022~0.040초, 브라우저 0.40~0.71초, 공개 curl 0.83~1.71초",
|
||||
"route_sweep": "46화면 page error 0·오류 문구 0, API 오류는 종료 회기 409 2건. 화면당 중앙값 8,980ms·최대 20,272ms, 모바일 15화면은 글꼴 로딩 대기로 화면 그림 실패, 앱 진단 보고 시도 15건(차단).",
|
||||
"cause": "vignette.chanpaca.net·api-vignette.chanpaca.net은 cdn-cgi/trace colo=LAX, speed.cloudflare.com은 colo=ICN. Pages 자산 초당 60~250KB(같은 시각 ICN 속도 측정 초당 11~28MB). 실제 사용자 진단 보고는 2026-10-24T13:33Z 이후 0건.",
|
||||
"nas": "부하 평균 24.43, 동기 쓰기 20×4KB 17.55초"
|
||||
},
|
||||
"nas_stuck_jobs": {
|
||||
"createdb": "haramlog_lifecycle_audit_lab_20261011 컨테이너 안 createdb -U supabase_admin -T postgres meta_ads_gate_20261016(9일째 비밀번호 입력 대기)를 종료. 데이터베이스는 생성되지 않았다.",
|
||||
"forgejo_ci": "FORGEJO-ACTIONS-TASK-4475_WORKFLOW-CI_JOB-node-static(2026-10-19T17:05Z 시작, 5일 20시간 대기)을 정지. 자동 삭제 설정이라 정지와 함께 정리됐다."
|
||||
},
|
||||
"tunnel_container": {
|
||||
"root_causes_of_2026_09_failure": [
|
||||
"cloudflared/config.yml 권한 640이라 컨테이너 계정 65532가 읽지 못함",
|
||||
"비밀 볼륨 vignette-prod-cloudflared-secrets-20260830이 비어 있음"
|
||||
],
|
||||
"fix": "config.yml을 644로(상위 폴더 750 유지), 인증 파일을 비밀 볼륨에 65532 소유 400으로 복사(원본과 SHA-256 앞 16자리 일치), --profile public-cutover-gate up -d --no-deps --force-recreate cloudflared. 같은 터널 번호·같은 연결 대상(127.0.0.1:18080)·network_mode host.",
|
||||
"verified": "연결 4개 등록(icn06/icn07, quic), restart unless-stopped, 계정 65532:65532. 호스트 상주 cloudflared를 끈 뒤 공개 health 10/10 200과 /auth/me 401·CORS. 컨테이너를 멈추고 수정한 scripts/nas-recover-prod.sh 실행 → 컨테이너 재기동·RECOVER_DONE, 다시 단독 health 8/8.",
|
||||
"final_state": "공개 터널은 compose 컨테이너 단독. 호스트 상주 프로세스는 정지. 재부팅 실증은 하지 않았다(공유 NAS)."
|
||||
},
|
||||
"font_subset": {
|
||||
"commit": "5c5b66d0",
|
||||
"pages_deployment": "d4a089db",
|
||||
"change": "PretendardVariable.woff2(2,057,688 bytes) preload 제거, 공식 Pretendard Variable 92분할본(unicode-range) 자체 호스팅. 글꼴 이름·굵기·font-display 불변, 옛 전체 글꼴 파일은 이전 세대 CSS 참조 때문에 유지.",
|
||||
"verified": [
|
||||
"typecheck·build 통과, dist 분할 woff2 92개·@font-face 92개·글꼴 preload 0개",
|
||||
"로컬 미리보기 /login 변경 전후 화면 그림 SHA-256 동일",
|
||||
"공개 index-D8zLr3Rf.js·index-oGqCvuGR.css SHA-256이 dist와 일치, 옛 index-V3qu1E6S.js·옛 글꼴 200 보존",
|
||||
"공개 /login 첫 접속 desktop·mobile 글꼴 8요청 209,456 bytes, Pretendard 적용, page error 0"
|
||||
],
|
||||
"route_sweep_after": "46화면 page error 0·오류 문구 0·화면 그림 실패 0(이전 15), API 오류는 종료 회기 409 2건. 화면당 중앙값 9,492ms·최대 18,152ms로 전체 시간은 줄지 않았다: 측정 시각 LAX 경로가 더 느렸고 병목이 1,168,196 bytes 사이드바 배경 PNG로 옮겨 갔다(한 번 192초).",
|
||||
"not_run": "layout-visual-gate·session-layout E2E는 web+API+DB 스택이 필요해 실행하지 않았다.",
|
||||
"nas_web_image": "NAS web 컨테이너는 2026-10-24 이미지 그대로다. 다음 릴리스 때 함께 갱신한다."
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue