40 lines
1.8 KiB
Markdown
40 lines
1.8 KiB
Markdown
|
# 프론트엔드 배포 (Nginx 정적 호스팅)
|
||
|
|
|
||
|
|
`main` 푸시 시 [.gitea/workflows/deploy.yaml](../.gitea/workflows/deploy.yaml) 가
|
||
|
|
`dist` 를 빌드해 서버 Nginx 웹 루트로 업로드하고 nginx 를 reload 합니다.
|
||
|
|
|
||
|
|
## 1. Gitea 저장소 시크릿 (Settings → Actions → Secrets)
|
||
|
|
| 시크릿 | 설명 | 예시 |
|
||
|
|
|---|---|---|
|
||
|
|
| `DEPLOY_HOST` | 서버 호스트/IP | `10.0.0.5` |
|
||
|
|
| `DEPLOY_USER` | SSH 계정 | `deploy` |
|
||
|
|
| `DEPLOY_SSH_KEY` | SSH 개인키(PEM 전체) | `-----BEGIN OPENSSH PRIVATE KEY-----...` |
|
||
|
|
| `DEPLOY_PATH` | Nginx 웹 루트 | `/var/www/sb-front` |
|
||
|
|
| `DEPLOY_PORT` | SSH 포트(선택) | `22` |
|
||
|
|
|
||
|
|
## 2. 서버 1회 준비
|
||
|
|
```bash
|
||
|
|
sudo apt-get install -y nginx
|
||
|
|
sudo mkdir -p /var/www/sb-front && sudo chown deploy:deploy /var/www/sb-front
|
||
|
|
|
||
|
|
# Nginx 서버블록 설치 (deploy/nginx-sb-front.conf 참고)
|
||
|
|
sudo cp deploy/nginx-sb-front.conf /etc/nginx/sites-available/sb-front
|
||
|
|
sudo ln -sf /etc/nginx/sites-available/sb-front /etc/nginx/sites-enabled/sb-front
|
||
|
|
sudo nginx -t && sudo systemctl reload nginx
|
||
|
|
|
||
|
|
# deploy 계정에 nginx 검증/reload 무비밀번호 sudo 허용
|
||
|
|
echo 'deploy ALL=(root) NOPASSWD: /usr/sbin/nginx -t, /usr/sbin/nginx -s reload' \
|
||
|
|
| sudo tee /etc/sudoers.d/sb-front
|
||
|
|
|
||
|
|
# 러너 공개키를 deploy 계정 authorized_keys 에 등록 (백엔드와 동일 키 사용 가능)
|
||
|
|
```
|
||
|
|
|
||
|
|
## 3. 동작
|
||
|
|
- main 푸시 → CI(빌드) + Deploy(빌드·업로드·reload) 가 각각 실행
|
||
|
|
- 업로드는 웹 루트를 비우고 새 `dist` 로 교체 (해시 자산명이라 안전)
|
||
|
|
- 수동 배포: 저장소 Actions → Deploy → Run workflow
|
||
|
|
|
||
|
|
## 참고
|
||
|
|
- API 는 같은 도메인의 `/api/` 로 Nginx 가 백엔드(8080)에 프록시합니다.
|
||
|
|
별도 도메인/포트로 띄운다면 빌드시 `VITE_API_BASE_URL` 환경변수를 지정하세요.
|