운영 환경 배포 가이드

운영 환경에 SP 서버를 배포하려면, 설정 파일 변경과 파일 배치 등 몇 가지 준비가 필요해요.

1. 운영 설정 준비

사전 준비 사항

• 운영 DID 파일 등록 완료
• PUSH 기능을 사용할 경우, 사전 신청 필요

application.properties 설정 변경

운영 환경에 맞게 포트, 파일 경로, 키 ID 등을 수정해요.

설정 항목	설명
server.port	서비스 포트 지정
wallet.path, did.path	wallet, did 파일 절대경로 지정
sign.key.id, encrypt.key.id	발급한 키 ID로 설정

운영용 verifyConfig.json 생성

1. 웹에서 항목 입력 후 생성 버튼 클릭
   

2. 다운로드한 verifyConfig.json 파일을 프로젝트에 복사

   • 경로 예시: src/main/resources/verifyConfig.json 또는 지정된 외부 경로

   

2. Spring Boot 직접 실행 방식 배포

1. Maven 빌드 후 생성된 sp-with-sdk.war 파일 복사

   • 위치: target/sp-with-sdk.war

2. .did, .wallet 파일을 지정된 경로에 복사

   • 예시 경로: /opt/sp/config/komsco.did, /opt/sp/config/komsco.wallet

3. 쉘 스크립트 설정 및 실행

   • 파일: start.sh, stop.sh, splog.sh
   • 권한 부여: chmod +x *.sh
   • 경로, 포트 등 환경 맞게 수정

4. 실행 확인

   • ./start.sh → 서버 기동
   • ./splog.sh → 로그 출력 확인

3. WAS(Tomcat 등) 기반 배포

1. sp-with-sdk.war 파일을 WAS에 배포

2. .did, .wallet 파일을 WAS 접근 가능한 경로에 배치

   • 예시: /usr/local/tomcat/config/komsco.did

3. application.properties에서 경로와 포트 설정 맞춤

4. WAS에서 sp-with-sdk 애플리케이션 시작

주의사항

• .did, .wallet 파일은 절대경로로 설정하는 걸 추천해요.
• 운영 서버는 보안상 외부 접근 제어와 백업 정책을 반드시 확인해야 해요.

start.sh

#!/bin/bash

APP_NAME=sp-with-sdk
JAR_NAME=$APP_NAME.war
LOG_DIR=./logs
LOG_FILE=$LOG_DIR/$APP_NAME.log
PID_FILE=$APP_NAME.pid

# 로그 디렉토리 생성
mkdir -p $LOG_DIR

# 기존 프로세스 종료
if [ -f $PID_FILE ]; then
    PID=$(cat $PID_FILE)
    echo "Stopping existing process $PID..."
    kill $PID
    sleep 3
fi

# 서버 실행
echo "Starting $JAR_NAME..."
nohup java -jar $JAR_NAME > $LOG_FILE 2>&1 &

# PID 저장
echo $! > $PID_FILE
echo "Started with PID $(cat $PID_FILE)"

stop.sh

#!/bin/bash

APP_NAME=sp-with-sdk
PID_FILE=$APP_NAME.pid

if [ -f $PID_FILE ]; then
    PID=$(cat $PID_FILE)
    echo "Stopping $APP_NAME (PID: $PID)..."
    kill $PID
    rm -f $PID_FILE
else
    echo "No running instance found."
fi

splog.sh

#!/bin/bash

APP_NAME=sp-with-sdk
LOG_FILE=./logs/$APP_NAME.log

echo "Tailing logs from $LOG_FILE..."
tail -f $LOG_FILE

이 스크립트들은 배포 루트 폴더에 함께 두고 사용하면 돼요. 포트 번호나 메모리 설정 등을 추가하고 싶다면 java -jar 실행 옵션을 수정해서 적용할 수 있어요.