Environment Setup

Kosmos DSL 개발을 위한 기본 환경을 준비합니다. JDK / Gradle(or Maven) / Spring Boot를 기준으로 빠르게 검증 가능한 로컬 실행 경로를 제공합니다.

필수 소프트웨어

항목 권장 버전 확인 명령 비고
Java (JDK) 17 이상 (LTS) java -version OpenJDK 권장
Gradle 8.5+ ./gradlew -v Wrapper 사용 권장
Maven 3.9+ mvn -v Gradle/Maven 중 택 1
Spring Boot 3.2+ 의존성으로 관리
IDE IntelliJ / VS Code Annotation Processor ON

빠른 검증

$ java -version
$ ./gradlew -v    # 또는 mvn -v
$ echo "OK - toolchain is ready"

로컬 실행 스택

JDK 17+ Gradle/Maven Spring Boot Kosmos DSLEl.*, Comp*, Frag* HTML

JDK → 빌드 도구 → Spring Boot → Kosmos DSL → SSR HTML

IDE 팁

  • IntelliJ: Settings → Build Tools에서 Gradle Wrapper 사용, Annotation Processing 활성화
  • VS Code: Extension(Java Pack) 설치, Lombok/Annotation Processing 설정 확인
  • 코드 스타일: Google Java Style 또는 팀 프리셋 적용 권장

옵션: Docker 로컬 의존 서비스

# docker-compose.yml (예시)
services:
  db:
    image: postgres:15
    ports: ["5432:5432"]
    environment:
      POSTGRES_PASSWORD: secret
  redis:
    image: redis:7
    ports: ["6379:6379"]

주의사항

JDK 경로: 여러 JDK가 깔려 있으면 Gradle가 다른 버전을 참조할 수 있습니다. org.gradle.java.home 확인.
네트워크 제한: 사내 저장소만 허용되는 환경은 repositories 미러 설정이 필요합니다.
Wrapper 우선: CI/CD 및 팀 일관성을 위해 Gradle Wrapper/Maven Wrapper 사용을 권장합니다.