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 사용을 권장합니다.