Skip to main content

Spring Boot Ubuntu 서비스 등록

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

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

​

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

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

​

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

​

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

​

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

​

▼ raid-manager.service 예시 내용​

​

[Unit]
Description=Raid Manager Spring Boot Application
After=network.target
​
[Service]
User=sleepzz
WorkingDirectory=/sorc001/raid-manager
ExecStart=/usr/bin/java -jar /sorc001/raid-manager/raid-manager-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod
SuccessExitStatus=143
Restart=on-failure
RestartSec=5
StandardOutput=file:/logs001/raid-manager/output.log
StandardError=file:/logs001/raid-manager/error.log
​
[Install]
WantedBy=multi-user.target

​

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

​

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

​

✅ 5. 로그 확인 방법​

​

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

​

🔄 기타 참고​

​

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

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