deploy: compose.yaml, container_name, .env 적용 안내

Made-with: Cursor
This commit is contained in:
2026-04-13 14:18:37 +09:00
parent 3058f6a976
commit 58a64a14c2
8 changed files with 23 additions and 12 deletions

View File

@@ -8,7 +8,7 @@ NAS에 SSH로 올리는 **전체 순서**는 `docs/nas-deploy-guide.md`에 따
## 로컬 개발
1. `cp .env.example .env`아래를 실제 주소로 맞춘다.
1. `cp .env.example .env`**`.env`만** 실제 주소로 맞춘다. (Compose·Vite는 `.env.example`을 자동으로 읽지 않는다.)
- `VITE_PUBLIC_APP_URL`: 브라우저에서 웹앱을 여는 URL(로컬이면 `http://127.0.0.1:5173` 등).
- `VITE_POCKETBASE_URL`: PocketBase URL(로컬이면 `http://127.0.0.1:8090` 등).
2. `npm install`
@@ -23,7 +23,7 @@ NAS에 SSH로 올리는 **전체 순서**는 `docs/nas-deploy-guide.md`에 따
- 빌드 시 `VITE_POCKETBASE_URL=https://api.todo.sori.studio`, `VITE_PUBLIC_APP_URL=https://todo.sori.studio` 를 넣는다. (`docker compose`는 프로젝트 루트의 `.env`를 읽어 `todo-web` 빌드 인자로 전달할 수 있다.)
- PocketBase **CORS** 허용 출처에 `https://todo.sori.studio` 를 추가한다.
PocketBase는 Docker로 띄우려면 `docker compose up pocketbase`만 실행해도 된다. 컨테이너 **내부**에서는 PocketBase가 `8090`을 쓰고, **호스트에 노출되는 포트**는 `docker-compose.yml``ports`를 따른다(기본값: 웹 `42881`→컨테이너 `80`, API `42917`→컨테이너 `8090`).
PocketBase는 Docker로 띄우려면 `docker compose up pocketbase`만 실행해도 된다. 컨테이너 **내부**에서는 PocketBase가 `8090`을 쓰고, **호스트에 노출되는 포트**는 `docker-compose.yaml``ports`를 따른다(기본값: 웹 `42881`→컨테이너 `80`, API `42917`→컨테이너 `8090`).
## Docker Compose(웹 + PocketBase)
@@ -48,7 +48,7 @@ docker compose up -d --build
### 선택: 관리자 자동 생성
`docker-compose.yml``pocketbase` 서비스에 `PB_ADMIN_EMAIL`, `PB_ADMIN_PASSWORD` 환경 변수를 추가할 수 있다. 값은 저장소에 넣지 말고 NAS 비밀 관리 방식으로 주입한다.
`docker-compose.yaml``pocketbase` 서비스에 `PB_ADMIN_EMAIL`, `PB_ADMIN_PASSWORD` 환경 변수를 추가할 수 있다. 값은 저장소에 넣지 말고 NAS 비밀 관리 방식으로 주입한다.
## 단일 이미지(웹만)