149 lines
3.7 KiB
Markdown
149 lines
3.7 KiB
Markdown
# Synology NAS Docker Compose 배포
|
|
|
|
이 문서는 현재 프로젝트를 Synology NAS에서 `math-quiz` 컨테이너로 실행하고, Nginx Proxy Manager(NPM)에서 `math-quiz.jisangs.com`으로 연결하는 절차입니다.
|
|
|
|
## 전제
|
|
|
|
- NAS에 Docker 또는 Container Manager가 설치되어 있어야 합니다.
|
|
- NPM 컨테이너가 80/443 포트를 사용하고 있어야 합니다.
|
|
- `math-quiz.jisangs.com` DNS가 NAS로 연결되어 있어야 합니다.
|
|
- NPM 컨테이너와 `math-quiz` 컨테이너가 같은 Docker 네트워크에 있어야 합니다.
|
|
|
|
## 1. NPM 공용 네트워크 준비
|
|
|
|
NAS SSH에서 한 번만 실행합니다.
|
|
|
|
```bash
|
|
docker network create proxy-network
|
|
```
|
|
|
|
이미 같은 이름의 네트워크가 있으면 에러가 나도 괜찮습니다.
|
|
|
|
NPM 컨테이너가 이미 실행 중이라면 같은 네트워크에 붙입니다.
|
|
|
|
```bash
|
|
docker network connect proxy-network <npm-container-name>
|
|
```
|
|
|
|
예를 들어 NPM 컨테이너 이름이 `nginx-proxy-manager`라면:
|
|
|
|
```bash
|
|
docker network connect proxy-network nginx-proxy-manager
|
|
```
|
|
|
|
## 2. 프로젝트 파일 업로드
|
|
|
|
NAS에 배포 디렉터리를 만듭니다.
|
|
|
|
```bash
|
|
mkdir -p /volume1/docker/math-quiz
|
|
```
|
|
|
|
로컬 작업 폴더에서 NAS로 프로젝트를 복사합니다.
|
|
|
|
```bash
|
|
rsync -av --delete \
|
|
--exclude .git \
|
|
--exclude node_modules \
|
|
--exclude .next \
|
|
--exclude .pnpm-store \
|
|
./ <nas-user>@<nas-host>:/volume1/docker/math-quiz/
|
|
```
|
|
|
|
Git을 NAS에서 직접 사용할 수 있다면 아래 방식도 가능합니다.
|
|
|
|
```bash
|
|
cd /volume1/docker
|
|
git clone <repo-url> math-quiz
|
|
```
|
|
|
|
이미 clone 되어 있다면:
|
|
|
|
```bash
|
|
cd /volume1/docker/math-quiz
|
|
git pull
|
|
```
|
|
|
|
## 3. 운영 환경변수 작성
|
|
|
|
NAS의 `/volume1/docker/math-quiz/.env.production` 파일을 만듭니다.
|
|
|
|
```bash
|
|
cd /volume1/docker/math-quiz
|
|
cp .env.production.example .env.production
|
|
vi .env.production
|
|
```
|
|
|
|
현재 구현은 DB/Redis/NextAuth를 아직 사용하지 않지만, 이후 기능 추가를 위해 키는 준비해 둡니다.
|
|
|
|
```env
|
|
DATABASE_URL=
|
|
REDIS_URL=
|
|
NEXTAUTH_SECRET=
|
|
NEXTAUTH_URL=https://math-quiz.jisangs.com
|
|
```
|
|
|
|
`NEXTAUTH_SECRET`을 사용할 때는 아래처럼 생성할 수 있습니다.
|
|
|
|
```bash
|
|
openssl rand -base64 32
|
|
```
|
|
|
|
## 4. Docker 이미지 빌드 및 실행
|
|
|
|
```bash
|
|
cd /volume1/docker/math-quiz
|
|
docker compose up -d --build
|
|
```
|
|
|
|
상태 확인:
|
|
|
|
```bash
|
|
docker compose ps
|
|
docker logs -f math-quiz
|
|
```
|
|
|
|
정상 실행되면 컨테이너 내부에서 Next.js 서버가 `3000` 포트로 떠 있습니다. 외부 80/443은 NPM이 담당하므로 `docker-compose.yml`에는 호스트 포트 노출을 두지 않았습니다.
|
|
|
|
## 5. Nginx Proxy Manager 설정
|
|
|
|
NPM 관리자 화면에서 Proxy Host를 추가합니다.
|
|
|
|
- Domain Names: `math-quiz.jisangs.com`
|
|
- Scheme: `http`
|
|
- Forward Hostname / IP: `math-quiz`
|
|
- Forward Port: `3000`
|
|
- Websockets Support: 필요 시 활성화
|
|
- SSL: Let's Encrypt 인증서 발급
|
|
- Force SSL: 활성화
|
|
|
|
NPM 컨테이너와 `math-quiz` 컨테이너가 `proxy-network` 네트워크를 공유해야 `Forward Hostname`에 `math-quiz`를 사용할 수 있습니다.
|
|
|
|
## 6. 업데이트 반영
|
|
|
|
로컬에서 변경한 파일을 다시 rsync 하거나 NAS에서 `git pull` 후 재빌드합니다.
|
|
|
|
```bash
|
|
cd /volume1/docker/math-quiz
|
|
docker compose up -d --build
|
|
docker image prune -f
|
|
```
|
|
|
|
로그 확인:
|
|
|
|
```bash
|
|
docker logs -f math-quiz
|
|
```
|
|
|
|
## 참고: 네트워크 이름이 다를 때
|
|
|
|
NPM에서 이미 쓰는 Docker 네트워크 이름이 있다면 `docker-compose.yml`의 `proxy-network`를 해당 네트워크 이름으로 바꿉니다.
|
|
|
|
```yaml
|
|
networks:
|
|
proxy-network:
|
|
external: true
|
|
```
|
|
|
|
위 블록의 `proxy-network` 이름과 서비스의 `networks` 값을 같은 이름으로 맞추면 됩니다.
|