ByungCheol
f45be09ff1
CI / build (push) Failing after 14m26s
- 모바일 웹에서 옛 index.html 캐시가 삭제된 옛 청크를 불러 메뉴(가계부 내역 등)가 안 열리는 문제 → router.onError 로 청크 실패 감지 시 목적지로 전체 새로고침 - nginx 설정에 index.html no-cache 추가(재발 방지) — 서버 적용 필요 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
프론트엔드 배포 (Nginx 정적 호스팅)
main 푸시 시 .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회 준비
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환경변수를 지정하세요.