zio/zioinfo-mail

Fork 0

$DESKTOP-TKLFCPR\ython$ DESKTOP-TKLFCPR\ython bae659adba feat(setup): Claude Code Desktop 자동 설치 + 30일 라이선스 + 서비스 자동 실행

[Claude Code Desktop 자동 설치 환경]
- setup/CLAUDE.md: 트리거 키워드 + 설치 패키지 설명
- setup/.claude/skills/guardia-install/SKILL.md: 6단계 설치 오케스트레이터
  Phase 0: 의도 파악 → Phase 1: OS 감지 → Phase 2: 사전 확인
  Phase 3: 설치 실행 → Phase 4: 라이선스 발급 → Phase 5: 검증 → Phase 6: 완료보고

[통합 자동 설치 스크립트]
- setup/install_auto.sh: Linux 통합 (OS 자동 감지 ubuntu/centos/rhel)
  - --license trial30|trial7|<key> 파라미터
  - 설치 완료 후 GUARDiA 자동 실행 + 브라우저 자동 열기
  - --test 검증 모드
- setup/install_auto.ps1: Windows 통합 (ASCII 전용, PS 5.1 호환)
  - 설치 후 NSSM 서비스 자동 시작 + 브라우저 자동 열기
  - -Test 파라미터로 검증 전용 실행

[라이선스 엔진 개선]
- core/license.py: generate_trial_key(days=None) 파라미터 추가
- TRIAL_DURATION_DAYS = TRIAL_DURATION_DAYS 환경변수로 조정 가능
- routers/license.py: TrialRequest.days 필드 + 30일 체험판 지원
  POST /api/license/trial {"days": 30} 로 30일 발급

사용자 경험:
  1. setup/ 폴더를 새 PC에 복사
  2. Claude Code Desktop 열고 해당 폴더 open
  3. "GUARDiA 시스템 1달 사용자로 설치해 줘" 입력
  4. 자동으로 OS 감지 → 설치 → 30일 라이선스 → 브라우저 열림

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-05-30 09:06:14 +09:00

4.1 KiB

Raw Blame History

name	description
guardia-install	GUARDiA ITSM 자동 설치 오케스트레이터. 다음 상황에서 반드시 이 스킬을 사용: (1) "GUARDiA 설치", "GUARDiA 시스템 설치", "설치해 줘" 요청; (2) "1달 사용자", "체험판", "trial" 포함 설치 요청; (3) "GUARDiA 운영 설치", "개발 환경 설치" 요청; (4) setup 폴더에서 설치 관련 모든 요청. 이 스킬 없이 설치를 직접 진행하지 말 것.

name

description

guardia-install

GUARDiA ITSM 자동 설치 오케스트레이터. 다음 상황에서 반드시 이 스킬을 사용: (1) "GUARDiA 설치", "GUARDiA 시스템 설치", "설치해 줘" 요청; (2) "1달 사용자", "체험판", "trial" 포함 설치 요청; (3) "GUARDiA 운영 설치", "개발 환경 설치" 요청; (4) setup 폴더에서 설치 관련 모든 요청. 이 스킬 없이 설치를 직접 진행하지 말 것.

GUARDiA ITSM 자동 설치 오케스트레이터

실행 순서

Phase 0: 사용자 의도 파악

먼저 요청을 분석하여 설치 종류를 결정한다.

요청 키워드	설치 종류	라이선스
1달, 한달, 30일, 체험, trial	TRIAL_30	30일 체험판 자동 발급
7일, 1주일, 개발	TRIAL_7	7일 체험판
운영, production	PROD	라이선스 키 입력 필요
대상서버, WAS서버	TARGET	라이선스 불필요

Phase 1: OS 자동 감지

반드시 먼저 OS를 감지하고 설치 스크립트를 선택한다.

# OS 감지 명령
uname -s 2>/dev/null          # Linux/Mac
[System.Environment]::OSVersion  # Windows (PowerShell)

OS	사용할 스크립트
Windows (PowerShell)	`install_auto.ps1`
Ubuntu 20/22/24	`install_auto.sh ubuntu`
CentOS 7/Stream	`install_auto.sh centos`
RHEL 8/9	`install_auto.sh rhel`
macOS	`install_auto.sh mac`

Phase 2: 설치 전 확인

설치 시작 전에 반드시 다음을 확인하고 사용자에게 보고한다:

감지된 OS:     Windows 10 / Ubuntu 22.04 / ...
설치 종류:     1달 체험판
설치 항목:
  ✓ Python 3.11 + FastAPI (GUARDiA ITSM 백엔드)
  ✓ OpenJDK 17 + Tomcat 9 (WAS)
  ✓ PostgreSQL 또는 SQLite (DB)
  ✓ Ollama (온프레미스 AI, 약 4GB)
  ✓ Gitea (형상관리)
  ✓ Nginx (웹서버)
  ✓ 30일 체험 라이선스 자동 발급

예상 소요시간: 약 10~30분 (인터넷 속도에 따라)
디스크 필요:  약 10GB

설치를 시작할까요? (예/아니오)

사용자가 확인하면 Phase 3 진행.

Phase 3: 설치 실행

Windows:

# 관리자 권한 확인 후 실행
Set-ExecutionPolicy Bypass -Scope Process -Force
.\install_auto.ps1 -LicenseType trial30

Linux:

chmod +x install_auto.sh
sudo bash install_auto.sh --license trial30

설치 중 실시간 진행 상황을 사용자에게 보고한다:

[1/N] 패키지 설치... 단계별 진행
오류 발생 시 즉시 보고 + 해결 방법 제시

Phase 4: 라이선스 발급

설치 완료 후 체험 라이선스를 자동 발급한다.

# GUARDiA API로 30일 체험 라이선스 발급
curl -sf -X POST http://localhost:8001/api/license/trial \
  -H "Content-Type: application/json" \
  -d '{"customer": "체험판 사용자 (30일)"}'

라이선스 키를 발급받아 .env에 자동 저장.

Phase 5: 설치 검증

install_auto.sh --test (또는 install_auto.ps1 -Test) 실행하여 모든 서비스 상태 확인.

Phase 6: 완료 보고

설치 완료 후 반드시 다음 정보를 사용자에게 제공:

✅ GUARDiA ITSM 설치 완료!

접속 정보:
  GUARDiA 대시보드: http://[서버IP]
  초기 계정:        admin / 1111 (최초 로그인 시 변경)
  라이선스 만료:    30일 후 (YYYY-MM-DD)

서비스 현황:
  GUARDiA ITSM: ✅ 실행 중 (포트 8001)
  Tomcat:       ✅ 실행 중 (포트 8080)
  Ollama:       ✅ 실행 중 (포트 11434)
  Gitea:        ✅ 실행 중 (포트 3000)

다음 단계:
  1. http://[IP] 접속 → admin/1111 로그인
  2. 비밀번호 변경
  3. CMDB에 서버 등록
  4. 메신저 봇 연결 (선택)

오류 처리 원칙

설치 중 오류 → 즉시 사용자에게 보고, 단계 재시도 여부 확인
네트워크 오류 → 폐쇄망 패키지 사용 안내 (download_packages.sh)
권한 오류 → 관리자 권한으로 재실행 안내
포트 충돌 → 사용 중인 포트 프로세스 확인 후 조치

4.1 KiB Raw Blame History