[Infra Ops] WAR/JAR/정적파일 배포와 배포 스크립트 작성

[CI·빌드 서버]  build → myapp-1.4.2.war · app.jar · dist/
   │
   ① 산출물 확정      버전 태그가 붙은 불변 아티팩트로 고정
   │
   ② 대상 서버 전송    scp·rsync 로 releases/20260707_2100/ 에 통째로 풀기
   │
   ③ current 링크 전환  ln -sfn 새릴리스 current_tmp → mv -T current_tmp current (원자적)
   │
   ④ 재시작·리로드     프로세스형(WAR·JAR)=재기동 / 정적·Nginx=reload 로 새 경로 반영
   │
   ⑤ 헬스 확인        curl 200 · systemctl active · 로그 정상 startup
   │
   ⑥ 이전 릴리스 보관   직전 releases 유지 → 문제 시 current 되돌리기
   ▼
[운영]  current 가 새 릴리스를 가리키고, 이전 릴리스는 롤백 카드로 대기

# -- 배포 전 준비 --
# 현재 버전 백업 (날짜와 시간 포함)
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/opt/backup/tomcat"
mkdir -p ${BACKUP_DIR}

cp /opt/tomcat/webapps/myapp.war ${BACKUP_DIR}/myapp_${TIMESTAMP}.war
echo "백업 완료: ${BACKUP_DIR}/myapp_${TIMESTAMP}.war"

# -- Tomcat 중지 --
systemctl stop tomcat
# 완전히 종료됐는지 확인
sleep 3
ps aux | grep catalina | grep -v grep
# 아무것도 안 나와야 함

# -- 배포 --
# 이전 배포 디렉터리 제거 (exploded WAR 캐시 정리)
TARGET_DIR="/opt/tomcat/webapps/myapp"
test "$(readlink -f "$TARGET_DIR")" = "/opt/tomcat/webapps/myapp" || { echo "예상 경로가 아니므로 중단" >&2; exit 1; }
test -d "$TARGET_DIR" && rm -rf -- "$TARGET_DIR"

# 새 WAR 복사
cp /tmp/myapp.war /opt/tomcat/webapps/myapp.war
ls -lh /opt/tomcat/webapps/myapp.war

# -- Tomcat 기동 --
systemctl start tomcat

# -- 기동 확인 --
# 로그 실시간 확인 (기동 완료까지 대기)
timeout 120 tail -f /opt/tomcat/logs/catalina.out | grep -m1 -E "Server startup|SEVERE|Exception"

# /etc/systemd/system/myapp.service (서비스 파일 예시)
# [Unit]
# Description=My Spring Boot Application
# After=network.target
#
# [Service]
# User=appuser
# WorkingDirectory=/opt/app
# ExecStart=/usr/bin/java -jar /opt/app/myapp.jar
# EnvironmentFile=/etc/myapp/env
# Restart=on-failure
# RestartSec=5
#
# [Install]
# WantedBy=multi-user.target

# -- JAR 배포 절차 --
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR="/opt/backup/app"
mkdir -p ${BACKUP_DIR}

# 현재 JAR 백업
cp /opt/app/myapp.jar ${BACKUP_DIR}/myapp_${TIMESTAMP}.jar

# 서비스 중지
systemctl stop myapp
sleep 2
systemctl is-active myapp  # inactive 여야 함

# 새 JAR 배포
cp /tmp/myapp-1.2.0.jar /opt/app/myapp.jar
ls -lh /opt/app/myapp.jar

# 서비스 시작
systemctl start myapp

# 기동 상태 확인
sleep 5
systemctl status myapp | head -20
journalctl -u myapp -n 30 --no-pager | grep -E "Started|ERROR|Exception"

# -- 정적파일 배포 절차 --
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
WEBROOT="/var/www/myapp"
BACKUP_DIR="/opt/backup/frontend"
mkdir -p ${BACKUP_DIR}

# 현재 버전 백업
tar -czf ${BACKUP_DIR}/frontend_${TIMESTAMP}.tar.gz -C /var/www myapp
echo "백업: ${BACKUP_DIR}/frontend_${TIMESTAMP}.tar.gz"

# 배포 (rsync로 변경분만 전송)
rsync -avz --delete /tmp/dist/ ${WEBROOT}/
# --delete : 이전에 있던 파일 중 새 dist에 없는 파일 제거

# 또는 단순 복사
cp -r /tmp/dist/* ${WEBROOT}/

# 파일 권한 설정
chown -R nginx:nginx ${WEBROOT}
find ${WEBROOT} -type f -exec chmod 644 {} \;
find ${WEBROOT} -type d -exec chmod 755 {} \;

# Nginx 설정 검증 후 reload (연결 유지)
nginx -t && systemctl reload nginx

# 배포 확인
curl -s -o /dev/null -w "%{http_code}" http://localhost/

배포 전 체크리스트
  □ 빌드 산출물 확인 (파일명, 크기, 버전)
  □ DB 마이그레이션 스크립트 준비 여부 확인
  □ setenv.sh 프로파일 설정 확인 (prod 여야 함)
  □ 이전 버전 백업 경로 확인
  □ 헬스체크 URL 확인
  □ 롤백 절차 숙지 (이전 WAR/JAR 경로)

배포 후 체크리스트
  □ 헬스체크 HTTP 200 확인
  □ systemctl status 프로세스 active 확인
  □ catalina.out 또는 app.log 에 ERROR 없음 확인
  □ 주요 기능 smoke test (로그인, 핵심 API 1~2개)
  □ 모니터링 대시보드 정상 확인 (CPU/메모리/응답시간)
  □ 배포 완료 팀 공유 (Slack/Teams 알림)