본문 바로가기
백엔드/스프링 프레임워크 & 스프링 부트

gradlew 명령어 알아보기

by slowcloud_ 2025. 8. 3.

gradlew를 기반으로 gradle을 조작할 수 있다. 윈도우 환경에서는 gradlew.bat을 이용하여 이를 활용할 수 있다.

가장 자주 사용되는 명령어 위주로 정리하였다.

 

gradlew

gradlew에 대해 간략한 소개 문구가 나온다.

 

gradlew --help

gradlew에서 적용할 수 있는 옵션들을 나열한다.

 

gradlew help --task [task]

특정 태스크에 대한 설명과 가용한 옵션을 나열한다.

 

gradlew tasks

gradle에서 실행 가능한 태스크들을 확인할 수 있다. 적용한 플러그인에 따라 사용 가능한 명령어들이 추가된다.

 

gradlew bootRun

스프링부트를 실행한다. 

 

gradlew bootTestRun

테스트 환경으로 스프링부트를 실행한다.

 

gradlew bootBuildImage

도커 등에서 실행할 수 있는 OCI 이미지를 생성한다.

GraalVM 플러그인 적용 시 AOT가 적용된 이미지를 생성한다.

--imageName 옵션으로 이미지 이름을 지정할 수 있다.

더 많은 옵션과 상세한 설명, 기본값 등은 다음 링크에서 확인할 수 있다.

https://docs.spring.io/spring-boot/gradle-plugin/packaging-oci-image.html#build-image.customization

 

gradlew bootJar

실행 가능한 Jar 파일을 생성한다.

bootJar는 스프링부트 플러그인에서 제공하는 테스크이다.

 

gradlew build

bootJar처럼 실행 가능한 파일을 생성하나, 테스트 등의 작업을 선행적으로 수행한다.

build는 gradle 자체에서 기본적으로 제공하는 태스크이다.

 

gradlew test

테스트를 수행한다.

 

gradlew clean

'build' 디렉터리를 삭제한다.

 

 

네이티브 컴파일을 위해 GraalVM 플러그인을 적용하면 다음과 같은 명령어가 추가된다

aotClasses

aotTestClasses 

metadataCopy

nativeCompile

nativeRun

nativeTestCompile

nativeTest

 

gradlew nativeCompile

네이티브 이미지를 생성한다. OCI 이미지가 아니며, OS 종속적인 실행파일이다.

 

gradlew nativeRun

네이티브 빌드 후 실행한다.

 

gradlew nativeTest

네이티브 빌드 후 테스트를 수행한다.