[BE] 개발 환경 - woowacourse-teams/2026-gachi-gacha GitHub Wiki
사전 요구사항
| 도구 | 버전·기준 |
|---|---|
| Git | 설치 필요 |
| JDK | 21 LTS |
Gradle은 프로젝트에 포함된 Gradle Wrapper를 사용하므로 별도 설치가 필요하지 않습니다.
설치된 버전은 다음 명령으로 확인합니다.
java --version
./gradlew --version
시작하기
1. 저장소 클론
git clone https://github.com/woowacourse-teams/2026-gachi-gacha.git
cd 2026-gachi-gacha/backend
이 저장소는 프론트엔드와 백엔드를 함께 관리하는 모노레포입니다. 백엔드 작업은
backend/디렉터리를 기준으로 진행합니다.
2. 빌드
./gradlew clean build
빌드가 완료되면 터미널에서 BUILD SUCCESSFUL을 확인할 수 있습니다.
3. 테스트
./gradlew test
테스트 결과는 다음 경로에서도 확인할 수 있습니다.
backend/build/reports/tests/test/index.html
4. 애플리케이션 실행
./gradlew bootRun
다음 로그가 출력되면 정상적으로 실행된 상태입니다.
Started ServerApplication
Tomcat started on port 8080
애플리케이션은 기본적으로 8080 포트를 사용합니다. 실행을 종료할 때는 실행 중인 터미널에서 Ctrl + C를 입력합니다.
현재 Thymeleaf 템플릿 파일이 없어 관련 경고가 표시될 수 있지만,
Started ServerApplication이 출력되었다면 실행에는 문제가 없습니다.
로컬 데이터베이스
현재 로컬 개발 환경에서는 별도의 데이터베이스 설치나 환경변수 설정 없이 H2 인메모리 데이터베이스를 사용합니다.
- H2 Console:
http://localhost:8080/h2-console - 사용자명:
SA - 비밀번호: 입력하지 않음
- JDBC URL: 애플리케이션 실행 로그의
Database available at항목 확인
H2 데이터베이스는 애플리케이션을 실행할 때 생성되고, 애플리케이션을 종료하면 데이터가 초기화됩니다.
실행 확인 결과
JDK 21과 Gradle Wrapper 9.5.1 환경에서 위의 가이드대로 했을때 빌드·테스트·애플리케이션 실행을 확인할 수 있습니다.
빌드 및 테스트
./gradlew clean build: 성공 ✅./gradlew test --rerun-tasks: 성공 ✅- 테스트 실패: 0개 ✅