Skip to content

Latest commit

 

History

History

spring-native

README.md

Spring Native Demo

This is a simple demo of Spring Native subsystem, compiling Spring applications to native executables using the GraalVM native-image compiler.

Arch. Spring CPU Compile T. Build Size Docker Size App Start RSS Memory
amd64 classic AMD Ryzen 9 5950X 7 s 17 M * 218.98 MB 0.84 s 484.332 MB
amd64 native AMD Ryzen 9 5950X 48 s 68 M 68.35 MB 0.032 s 49.824 MB
amd64 classic i7-3632QM 21 s 17 M * 218.98 MB 3.298 s 461.360 MB
amd64 native i7-3632QM 214 s 68 M 68.35 MB 0.098 s 50.004 MB
arm64v8 classic Raspberry PI 4 NA * 17 M * NA 10.997 s 169.416 MB
arm64v8 native Raspberry PI 4 NA * 67 M NA 0.161 s 71.820 MB
  • Compilation Time - in case of classic spring build, the compilation time is to build classic springboot fat jar.
  • Compilation Time * - springboot graal native compilation requires a LOT OF memory, ~20G is recommended. It is possible to emulate ARMv64 VM on x86_64 hardware in case memory on ARMv64 system is not enough. Compilation on Raspberry PI4 8G was failing because of memory shortage, so this example was compiled on qemu ARM64 VM.
  • Build Size - in case of classic build the build size is size of fat jar (only demo and dependencies) which does not include JVM and JVM libraries. JVM typically takes extra ~250MB.
  • Build Size * - in case of native build the resulting binary contains this demo, optimized java library stack and 'Substrate VM' as described here.
  • App Start - start time measured by SpringBoot framework printed in the log file.
  • RSS Memory - allocated measured after start and after REST APIS was exercised cat /proc/<pid>/status | grep VmRSS.

app-startup

Check also this GraalVM native-image plain java application demo.

Demo REST endpoints

  • GET Message 
    curl --request GET --url http://localhost:8080/api/v1/data/message
  • POST Message 
    curl --request POST \
--url http://localhost:8080/api/v1/data/message \
--header 'Content-Type: application/json' \
--data '{
"message": "Hi !"
}'

Build and Test

Install Graal VM and tools

This procedure is valid for Ubuntu 20.04 amd64 and arm64v8 build servers.

sudo apt install zip unzip curl
sudo apt install build-essential libz-dev zlib1g-dev
curl -s "https://get.sdkman.io" | bash
sdk install java 21.3.0.r17-grl
sdk install gradle 7.3.3
gu install native-image

Build Classic Fat jar

  • Build classic springboot fat jar.
gradle clean build test jar
  • Build docker with springboot fat jar.
export VERSION=0.0.1-SNAPSHOT
export ARCH=arm64v8
export ARCH=amd64
docker build -t jurajveverka/spring-native-classic:${VERSION}-${ARCH} \
  --build-arg ARCH=${ARCH} \
  -f Dockerfile.classic .
  
docker push jurajveverka/spring-native-classic:${VERSION}-${ARCH}
docker run -p 8080:8080 jurajveverka/spring-native-classic:${VERSION}-${ARCH}

Build lightweight Container with Cloud Native Buildpacks

gradle clean build test bootBuildImage
docker run --rm -p 8080:8080 spring-native:0.0.1-SNAPSHOT

Build Native Executable

  • Build native binary.
sdk use java 21.3.0.r17-grl
sdk use gradle 7.3.3
gradle clean build test nativeCompile
./build/native/nativeCompile/spring-native
  • Build docker with native binary.
export VERSION=0.0.1-SNAPSHOT
export ARCH=arm64v8
export ARCH=amd64
docker build -t jurajveverka/spring-native-native:${VERSION}-${ARCH} \
  --build-arg ARCH=${ARCH} \
  -f Dockerfile.native .
  
docker push jurajveverka/spring-native-native:${VERSION}-${ARCH}
docker run -p 8080:8080 jurajveverka/spring-native-native:${VERSION}-${ARCH}

References