Portainer 배포 · 컷오버 (N2-B8~B12)

대상: https://msn.iykyka.com
스택 정의: 저장소 root docker-compose.yml
개요: deploy-docker.md

현재 프로브 (에이전트, 2026-07-31)

URL	결과
`https://msn.iykyka.com/`	Express `Cannot GET /` (404) — 구 Node MSN으로 추정
`https://msn.iykyka.com/health`	`{"ok":true}` — 구 스택
`https://portainer.iykyka.com/`	200, API `Version 2.39.2`
엣지	`Server: openresty`

에이전트 VM에는 SSH 키/iykyka@iykyka.com:7788 권한이 없음 → 실제 Up·컷오버는 Master가 Portainer 또는 SSH로 수행(또는 키/토큰을 에이전트에 제공).

새 스택 헬스 응답은 {"status":"ok"} (구스택 {"ok":true} 과 구분).

Portainer → Stacks → Add stack
Build method: Repository (권장)
- Repository URL: https://gitea.iykyka.com/oh/iykyka.git (또는 GitHub o0kuma/hikikomori)
- Compose path: docker-compose.yml
- Branch: main
Environment variables (시크릿 — git 금지):

Name	예
`ADMIN_API_TOKEN`	긴 랜덤
`POSTGRES_PASSWORD`	긴 랜덤
`POSTGRES_USER`	`ykavu`
`POSTGRES_DB`	`ykavu`
`GEMINI_API_KEY`	(있으면)
`ALLOW_DEMO_INVITE`	`1`
`PUBLIC_API_BASE`	`https://msn.iykyka.com`
`WEB_HOST_PORT`	`8088` (컷오버 전 임시) → 전환 후 openresty가 가리키는 포트에 맞춤
`FCM_SERVER_KEY`	(없으면 비움)

curl -sS http://127.0.0.1:8088/health   # → {"status":"ok"}
curl -sS http://127.0.0.1:8088/demo    # → DEMO-YKAVU

git clone https://gitea.iykyka.com/oh/iykyka.git ykavu && cd ykavu
cp .env.example .env   # 값 채움
./scripts/server-up.sh

병렬 기동: 새 스택을 WEB_HOST_PORT=8088(또는 빈 포트)로 Up, 구 MSN은 유지
로컬 스모크: /health → status, /demo → DEMO-YKAVU, 브라우저로 http://HOST:8088/ 가입
OpenResty upstream을 구 Express → 127.0.0.1:8088(web) 로 변경 후 reload
공개 URL 스모크:
- https://msn.iykyka.com/health → {"status":"ok"}
- https://msn.iykyka.com/demo → demo JSON
- 회원가입 DEMO-YKAVU
구 Node MSN 컨테이너/프로세스 중지
롤백: upstream을 구 MSN으로 되돌리고 openresty reload

WebSocket: openresty에서 /ws 에 Upgrade / Connection 헤더 전달 필요 (nginx proxy_set_header Upgrade $http_upgrade 와 동일).

아래 중 하나만 있으면 N2-B8~B12를 에이전트가 이어서 실행할 수 있다.