ByungCheol
614e74be8a
CI / build (push) Has been cancelled
- deploy.yaml: jar 빌드 → scp 전송 → systemctl 재시작 - deploy/sb-backend.service: systemd 유닛 샘플 - deploy/README.md: 시크릿·서버 준비 안내 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
백엔드 배포 (SSH + systemd)
main 푸시 시 .gitea/workflows/deploy.yaml 가
jar 를 빌드해 서버로 전송하고 systemd 서비스를 재시작합니다.
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 |
jar 배치 경로 | /opt/sb-backend |
DEPLOY_PORT |
SSH 포트(선택) | 22 |
SERVICE_NAME |
systemd 유닛명(선택) | sb-backend |
2. 서버 1회 준비
# 자바 17, 배포 계정/디렉터리
sudo apt-get install -y openjdk-17-jre-headless
sudo useradd -m -s /bin/bash deploy # 이미 있으면 생략
sudo mkdir -p /opt/sb-backend && sudo chown deploy:deploy /opt/sb-backend
# 러너가 보낸 공개키를 deploy 계정에 등록
sudo -u deploy mkdir -p /home/deploy/.ssh
echo "<배포용 공개키>" | sudo -u deploy tee -a /home/deploy/.ssh/authorized_keys
# 운영 환경변수 (.env, git 미추적) — DB/Redis 접속정보
sudo -u deploy tee /opt/sb-backend/.env >/dev/null <<'EOF'
DB_URL=jdbc:mariadb://localhost:3306/sb_db?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Seoul
DB_USERNAME=sb
DB_PASSWORD=changeme
REDIS_HOST=localhost
REDIS_PORT=6379
EOF
# systemd 유닛 설치
sudo cp deploy/sb-backend.service /etc/systemd/system/sb-backend.service
sudo systemctl daemon-reload
sudo systemctl enable --now sb-backend
# deploy 계정에 해당 서비스 재시작 무비밀번호 sudo 허용
echo 'deploy ALL=(root) NOPASSWD: /bin/systemctl restart sb-backend, /bin/systemctl is-active sb-backend' \
| sudo tee /etc/sudoers.d/sb-backend
3. 동작
- main 푸시 → CI(빌드·테스트) + Deploy(빌드·전송·재시작) 가 각각 실행
- 수동 배포: 저장소 Actions → Deploy → Run workflow