zioinfo-mail/setup/CLAUDE.md
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

2.0 KiB

GUARDiA ITSM — 설치 디렉토리

이 폴더는 GUARDiA ITSM 자동 설치 패키지입니다. Claude Code Desktop에서 이 폴더를 열고 설치 명령을 내리면 자동으로 설치됩니다.


설치 명령 트리거

다음 중 하나를 입력하면 guardia-install 스킬이 자동 실행됩니다:

  • "GUARDiA 시스템 설치해 줘"
  • "GUARDiA 1달 사용자로 설치해 줘"
  • "GUARDiA 설치"
  • "install GUARDiA"
  • "GUARDiA 체험판 설치"

설치 패키지 구성

setup/
├── CLAUDE.md                   ← 지금 이 파일 (진입점)
├── install_auto.sh             ← Linux/Mac 통합 설치 스크립트
├── install_auto.ps1            ← Windows 통합 설치 스크립트
├── setup_ubuntu.sh             ← Ubuntu 전용
├── setup_centos.sh             ← CentOS/Stream 전용
├── setup_rhel.sh               ← RHEL 8/9 전용
├── setup_windows.ps1           ← Windows Server 전용
├── setup_target_server.sh      ← 관리 대상 WAS 서버 전용
├── gitea_init.sh               ← Gitea Git 서버 초기화
├── download_packages.sh        ← 폐쇄망 패키지 다운로드
├── lib/
│   ├── db_select.sh            ← DB 선택 공통 함수
│   └── gitea_setup.sh          ← Gitea 설치 공통 함수
└── .claude/
    └── skills/guardia-install/ ← 설치 오케스트레이터 스킬

설치 종류

명령어 설치 내용 라이선스
"1달 사용자로 설치" 전체 스택 30일 체험판 자동 발급
"개발 환경 설치" SQLite + 기본 7일 체험판
"운영 설치" PostgreSQL + 전체 별도 라이선스 키 필요
"대상 서버 설치" Tomcat + opsagent만 불필요

보안 제약 (절대 불변)

  • 외부 LLM API 완전 금지 — Ollama localhost:11434만 허용
  • 서버 자격증명 노출 금지
  • root SSH 직접 접속 금지
  • 스택트레이스 미노출