- docs/ITMS_사용자지침서.docx: 접속·로그인(OTP)·주요 업무화면·FAQ - docs/ITMS_운영자지침서.docx: 4포트 스택 구성·기관 프로파일·CI/CD·systemd 기동·헬스체크·트러블슈팅 - docs/ITMS_개발자지침서.docx: 멀티모듈 아키텍처·common 추출(키스토어 파라미터화)·빌드·기여 워크플로우·백로그 - docs/ITMS_서버설치가이드.docx: 사전요구사항·설치절차·CI연동·검증 체크리스트·제거 - install/ 설치 패키지 소스: preflight.sh·install.sh(멱등, 서비스 start 안 함)·uninstall.sh·README·make_package.sh - make_package.sh → dist/itms-install-v1.0.tar.gz(152K): install+systemd+env+ci+docs 번들(재생성 가능, dist/ gitignore) 시크릿(접속정보·keystore 비번·연동 키) 문서·스크립트에 미포함(env/서버 로컬 관리 안내만). Tier2 기동은 DB/시크릿/JDK17 확보 환경 전제. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| install.sh | ||
| make_package.sh | ||
| preflight.sh | ||
| README.md | ||
| uninstall.sh | ||
ITMS 설치 패키지
배포 대상 서버에 ITMS(4포트 WAR 스택 + datatrans 데몬)를 설치하기 위한 패키지.
상세 절차는 동봉 docs/ITMS_서버설치가이드.docx 참조.
구성
itms-install/
├── README.md 이 파일
├── preflight.sh 사전 점검(JDK17·systemd·디스크·DB 도달성)
├── install.sh 멱등 설치(계정·디렉터리·systemd 유닛·env). 서비스 start 안 함
├── uninstall.sh 제거(데이터/DB 보존)
├── build.sh 소스에서 5모듈 WAR 빌드(JDK17)
├── systemd/itms-*.service 모듈별 systemd 유닛(5)
├── env/itms.env.example env 템플릿(SPRING_PROFILES_ACTIVE)
├── ci/ (선택) CI 자동배포 연동
│ ├── deploy_server_itms_block.py
│ └── gitea-webhook.md
└── docs/ 지침서(사용자·운영자·개발자·서버설치) docx
빠른 설치
tar xzf itms-install-*.tar.gz && cd itms-install
sudo bash preflight.sh <MariaDB_HOST:3306> <ORACLE_HOST:1521} # 선택 인자
# JDK17 미설치 시: sudo apt-get install -y openjdk-17-jdk (또는 dnf java-17-openjdk-devel)
sudo bash install.sh
# 아티팩트 준비: /opt/itms/repo 에 소스 → JAVA_HOME=<jdk17> bash build.sh → artifacts/current 연결
# /etc/itms/itms-<모듈>.env 의 SPRING_PROFILES_ACTIVE=<기관> 설정
for m in auth api front batch datatrans; do sudo systemctl enable --now itms-$m; done
선결 조건
- Linux(systemd) · JDK17(Boot 2.6.2 는 Java21 미지원) · 메모리 4GB 권장
- 런타임 DB: MariaDB(ur_itms_db, api/batch) · Oracle XE(batch) 네트워크 도달
- 기관 프로파일(application-<기관>.yml) · keystore 사전 확보(시크릿은 서버 로컬 관리)
보안
- env/keystore 권한 600, 소유자 itms. 시크릿은 형상관리에 커밋 금지.