This commit is contained in:
parent
6e3123091a
commit
aeddaa6972
69 changed files with 3178 additions and 424 deletions
|
|
@ -144,6 +144,23 @@ docker compose -f docker-compose.nas.yml --env-file private/env.nas up -d --no-d
|
|||
- 공개 Pages의 현재 JS/CSS asset 의존 그래프는 로컬 `dist`와 비교해 52/52 HTTP 200이며 SHA-256이 일치한다. NAS web은 `/api` 빌드의 `index-Ccefqm_F.js`·`index-B1latakI.css`를 쓰며, 이는 `nginx -t`와 로컬 HTTP exit 0으로 별도 검증했다.
|
||||
- 따라서 Pages와 NAS web 전용 배포 반영은 완료했다. 다만 운영 인증 세션 만료로 내부 UI는 401이라 검증하지 못했으므로, 이 절은 전체 운영 내부 화면 GREEN이나 전체 기능 출시 완료를 의미하지 않는다. 구조화 증거: [`ux-web-deploy-2026-09-12.json`](./evidence/ux-web-deploy-2026-09-12.json).
|
||||
|
||||
## 5.5 재기동 복구 — 호스트 상주 cloudflared 터널 (2026-09-18 실측·복구 완료)
|
||||
|
||||
- **증상과 범위**: 2026-09-18 공개 `https://api-vignette.chanpaca.net/*` 전 경로가 HTTP 530(`error code 1033`)을 반환했다. 같은 시각 공개 웹 `https://vignette.chanpaca.net`은 200으로 정상이었고, NAS 내부 `http://127.0.0.1:18080/health`도 200(`status: ok, db: true, engine: true`)이었다. 즉 api·db·engine·web 컨테이너는 모두 정상이었고 장애 범위는 **터널 구간 단일**이었다. 외부에서 18080이 닫혀 있는 것은 `infra/docker-compose.nas.yml`의 api 서비스가 `127.0.0.1:18080:8000`으로 loopback 바인딩된 설계이며 이번 장애와 무관하다.
|
||||
- **원인**: NAS가 2026-09-18 03:44경(KST) 재부팅됐다(`uptime` 12시간 1분, `/proc/uptime` 43301초로 확인). 재부팅 직전까지 cloudflared는 **NAS 호스트 상주 프로세스**로 정상 동작 중이었다 — `private/cloudflared-host.log` 마지막 줄이 `2026-09-17T18:09:06Z INF Initiating graceful shutdown due to signal terminated`(UTC, KST 03:09:06)로, 크래시가 아니라 재부팅에 의한 SIGTERM 정상 종료였다. 문제는 재부팅 후 이 호스트 프로세스가 자동으로 재기동되지 않았다는 데 있다: `ps -ef`에 cloudflared 없음, `netstat -an | grep :7844` 0건, `private/cloudflared-host.pid`는 stale이었다. `/usr/local/etc/rc.d/`는 빈 디렉터리고 `/etc/rc.local`도 없어 부팅 시 자동 시작 등록 자체가 없다. Docker의 컨테이너 restart 정책은 컨테이너만 보호하며, 터널은 컨테이너가 아닌 **호스트 프로세스**라 그 보호 범위 밖이다.
|
||||
- **복구 절차 및 실행 결과**: NAS에서 [`scripts/nas-recover-prod.sh`](../../scripts/nas-recover-prod.sh)를 실행하거나 아래 명령을 직접 수행한다. sudo·docker 권한은 필요 없다. 2026-09-18 16:13 KST(NAS 로컬시각)에 이 명령으로 호스트 터널을 재기동해 PID 25806으로 가동했다.
|
||||
```sh
|
||||
cd /volume1/docker/vignette-prod
|
||||
nohup ./bin/cloudflared tunnel --no-autoupdate --config private/cloudflared-host.yml run >> private/cloudflared-host.log 2>&1 </dev/null &
|
||||
echo $! > private/cloudflared-host.pid
|
||||
```
|
||||
복구 후 공개 `https://api-vignette.chanpaca.net/health` → 200(`status: ok, db: true, engine: true`), 공개 `https://api-vignette.chanpaca.net/auth/me` → 401 `{"detail":"not authenticated"}`, 응답 헤더 `access-control-allow-origin: https://vignette.chanpaca.net`·`access-control-allow-credentials: true`를 확인했다.
|
||||
- **완료 판정 기준**: 공개 `/health`가 200이며 `db: true`·`engine: true`이고, **동시에** 공개 `/auth/me`가 401 + CORS 헤더(`access-control-allow-origin`·`access-control-allow-credentials`) 정상이어야 한다. 둘 중 하나만 확인하고 복구로 판정하지 않는다.
|
||||
- **함정**: `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 계열 열린 게이트). 등록 방식은 미정이다.
|
||||
|
||||
## 6. 남은 구성 작업 (TODO)
|
||||
|
||||
- [ ] Forgejo master 기준 NAS 자동배포 후크(수동 절차는 §5, §5.1로 실증 완료)
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue