Files
music_quiz/docs/09-deploy-ops.md

45 lines
2.7 KiB
Markdown

# 09. 배포 · 운영
## 구성
```
인터넷 → NPMplus (192.168.10.3:443, mquiz.tkrmagid.kr, Let's Encrypt)
→ 192.168.10.9:2974 → 컨테이너 music_quiz-app:3000 (Bun)
└─ /data/app.db (SQLite, WAL)
↘ 음악은 각자 브라우저의 유튜브 플레이어가 재생(서버 음원 캐시 없음)
↘ Lavalink 192.168.10.6:2333 (유튜브 검색·재생 가능 확인, 읽기 전용 사용)
```
- 위치: .9 `/home/claude/projects/music_quiz` (joke-app과 같은 방식)
- compose 프로젝트 `music_quiz`, 볼륨 `music_quiz_app-data`, 포트 `2974:3000`
- 갱신: `git pull && cd deploy && docker --context default compose -f docker-compose.proxy.yml up -d --build`
(`--context default` 필수 — 기본 컨텍스트가 docker5라서)
- 컨테이너 메모리 상한 1GB, 수집기는 별도 프로세스(상한 2GB)
## 환경변수 (`deploy/.env`, 권한 600, 커밋 금지)
| 이름 | 값 |
|---|---|
| `PUBLIC_ORIGIN` | `https://mquiz.tkrmagid.kr` |
| `APP_PORT` | `2974` |
| `SESSION_SECRET` | 새로 생성(32자 이상) |
| `DISCORD_CLIENT_ID` | `1561284577564037140` |
| `DISCORD_CLIENT_SECRET` | 비밀 저장소에서 주입 |
| `SUPERADMIN_DISCORD_IDS` | `293719842274541579,1352267557213573160` |
| `LAVALINK_URL` / `LAVALINK_PW` | music_bot_v2 설정 재사용 |
| `YT_COOKIE_PATH` | `/run/secrets/ytm_cookie.txt` (호스트 `/home/claude/.config/music_quiz/ytm_cookie.txt`를 읽기 전용 연결) |
## 프록시 · 인증서
- DNS: `mquiz.tkrmagid.kr` → CNAME `tkrmagid.kr` (이미 등록돼 있음 확인)
- NPMplus에 프록시 호스트 추가: 대상 `192.168.10.9:2974`, WebSocket 켜기, joke-app과 같은 보안 헤더(`npmplus-advanced.conf` 기반, CSP에 음원 주소 허용)
- 인증서: Let's Encrypt, joke-app 때 쓴 인증서 스크립트 방식 그대로
## 백업
- 매일 새벽 SQLite `VACUUM INTO` 스냅샷 → 7일 보관(.9) + 주 1회 Nextcloud `/claude/music_quiz/`로 복사
## 모니터링
- `/healthz`(DB·디스크·Lavalink 연결 상태), 컨테이너 healthcheck
- 관리자 대시보드에 수집 작업 실패, 유튜브 차단 신호, 쿠키 만료 표시
- 주 1회 유튜브 주소 재확인(삭제·지역제한 감지 → "재생 불가"로 표시 후 재매칭)
## 디스크
- .9 남은 공간 약 140GB(72% 사용). 음원 캐시가 없어서 이 프로젝트는 DB 정도만 쓴다
- 용량이 부족해지면(남은 공간 50GB 미만) `~/disk-low-cleanup.sh`가 다시 받으면 되는 설치 캐시(pip·uv·npm·bun)만 지운다(도커 빌드 캐시는 `docker-disk-guard.sh`). `~/.tmp`·모델·프로젝트·DB·실행 중인 작업은 건드리지 않는다 (12 문서)