터널 컨테이너 전환·글꼴 분할 반영·NAS 정리 결과를 기록
This commit is contained in:
parent
8fc829feef
commit
371c297953
5 changed files with 66 additions and 7 deletions
|
|
@ -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로 실증 완료)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue