8adec35979
- 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>
40 lines
1.9 KiB
Markdown
40 lines
1.9 KiB
Markdown
# 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
|
|
```
|
|
|
|
## 빠른 설치
|
|
```bash
|
|
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. 시크릿은 형상관리에 커밋 금지.
|