diff --git a/MANUAL.md b/MANUAL.md index 84bd695..e6c7259 100644 --- a/MANUAL.md +++ b/MANUAL.md @@ -141,6 +141,23 @@ psql "$DATABASE_URL" # 본인 전용 스키마로 바로 접속됨 --- +## 7-1. 개발 중인 앱 미리보기 (브라우저에서 열기) + +`npm run dev` 로 띄운 앱(예: `:3000`)을 브라우저로 보려면 — 워크스페이스는 사내 클러스터 안에 있어 +`localhost:3000` 으로는 바로 안 열립니다. 아래 방법으로 **임시 미리보기 URL** 을 받으세요. + +**VS Code 의 PORTS 패널 (가장 쉬움)** +1. 터미널에서 앱 실행: `cd ~/projects/myapp && npm run dev` +2. VS Code 하단 **`PORTS`** 탭 → **`Forward a Port`** → 포트 번호(`3000`) 입력 + (앱이 뜨면 자동으로 감지해 알림이 뜨기도 합니다) +3. 포워딩된 포트 옆 **🌐 (Open in Browser)** 클릭 → 새 탭에 앱이 열립니다. + +> 열리는 주소는 `https://<...>.coder.bokdev.in` 형태의 **본인 전용 임시 URL** 입니다(사내 정식 TLS 적용). +> 본인만 접근 가능하며, 워크스페이스를 끄면 사라집니다. **운영 배포가 아니라 미리보기용**입니다. +> (정식 서비스 배포는 9번 Coolify 참고.) + +--- + ## 8. 컨테이너로 실행 (podman) 로컬에서 컨테이너로 돌려보기 (실제 런타임은 rootless podman, `docker` 명령도 동일하게 동작):