본문으로 건너뛰기

Ubuntu Spring Boot 서비스 등록

등록일: 2025. 6. 8. 18:41
내용: Spring Boot JAR systemd 서비스 등록 가이드 (nexus-raid 예제) ​

✅ 1. 디렉토리 구조 및 전제 조건​

​

  • JAR 파일 위치: /sorc001/nexus/raid/raid.jar
  • 로그 디렉토리: /logs001/nexus/raid
  • 실행 사용자: sleepzz ​

✅ 2. 로그 디렉토리 생성 및 권한 설정​

​

sudo mkdir -p /logs001/nexus/raid
sudo chown -R sleepzz:sleepzz /logs001/nexus/raid

​

✅ 3. systemd 서비스 유닛 파일 생성​

​

sudo nano /etc/systemd/system/nexus-raid.service

​

▼ nexus-raid.service 예시 내용​

​

[Unit]
Description=Nexus Raid Module Service (Backend)
After=network.target

[Service]
User=sleepzz
# 작업 디렉토리 변경
WorkingDirectory=/sorc001/nexus/raid

# 실행 명령어 (포트 8002, 프로필 prod)
ExecStart=/usr/bin/java -jar -Dserver.port=8002 -Dspring.profiles.active=prod />

SuccessExitStatus=143
Restart=on-failure
RestartSec=5

# 로그 경로 변경
StandardOutput=append:/logs001/nexus/raid/output.log
StandardError=append:/logs001/nexus/raid/error.log

​

✅ 4. 서비스 등록 및 실행​

​

# 데몬 리로드
sudo systemctl daemon-reload
​
# 부팅 시 자동 실행 등록
sudo systemctl enable nexus-raid
​
# 서비스 시작
sudo systemctl start nexus-raid
​
# 상태 확인
sudo systemctl status nexus-raid
​
# 수정
sudo nano /etc/systemd/system/nexus-raid.service

​

✅ 5. 로그 확인 방법​

​

# 파일로 확인
cat /logs001/nexus/raid/output.log
cat /logs001/nexus/raid/error.log
​
# 또는 journalctl 사용
journalctl -u nexus-raid -f

​

🔄 기타 참고​

​

  • 서비스 재시작: sudo systemctl restart nexus-raid
  • 서비스 중지: sudo systemctl stop nexus-raid
  • 설정 변경 후 재적용: sudo systemctl daemon-reload ​

​ 이 가이드는 /sorc001/nexus-raid 경로와 sleepzz 사용자 기준입니다.
다른 서비스에 재사용 시 파일명, 경로, 사용자명만 바꿔 사용하세요.