Spring Boot3 本机镜像构建

简单玩玩 Java 构建本机镜像，像 Go 一样直接启动

介绍#

我们构建 Java 项目的构件产出通常是 jar 包，运行它需要使用 JRE 环境。

jar 包的优势很明显，跨平台，放哪个平台上都可以跑，很方便。但是对于内存的消耗会大一些。而 Graalvm 可以把 Jar 包编译为本机可执行文件，不再需要 JRE 运行环境，启动很快，内存占用也会少一点。

年初时候我尝试把生产项目改成本机模式，发现复杂度太高了，很难在编译时候让编译器识别到全部需要的依赖。Java的反射和接口一类用的太多了。遂放弃了。

最近用到了一个简单的 Spring boot项目 simple-boot-douban-api 发现可以玩一玩。

升级 Spring Boot 3#

在检出项目后，修改项目 pom 配置，把 spring-boot-starter-parent 升级到了 3.3.2

1
   <parent>
2
        <groupId>org.springframework.boot</groupId>
3
        <artifactId>spring-boot-starter-parent</artifactId>
4
        <version>3.3.2</version>
5
        <relativePath/> <!-- lookup parent from repository -->
6
    </parent>

修改 JDK 使用 17 版本, jsoup也跟着升级一下。

1
<properties>
2
        <java.version>17</java.version>
3
        <jsoup.version>1.18.1</jsoup.version>
4
</properties>

Spring boot 2 ==> 3 的升级，Java EE 变成了 Jakarta EE 包路径基本都发生了改变比如 javax.servlet ==> jakarta.servlet

使用 IDEA 可以在使用重构进行迁移

79ax4t

搞完之后，mvn clean install 后，测试启动项目，ok

增加本机构建#

还是在 pom 文件中，增加 native 相关配置。

1
    <profiles>
2
        <profile>
3
            <id>native</id>
4
            <build>
5
                <plugins>
6
                    <plugin>
7
                        <groupId>org.graalvm.buildtools</groupId>
8
                        <artifactId>native-maven-plugin</artifactId>
9
                        <executions>
10
                            <execution>
11
                                <id>build-native</id>
12
                                <goals>
13
                                    <goal>compile-no-fork</goal>
14
                                </goals>
15
                                <phase>package</phase>
16
                            </execution>
17
                        </executions>
18
                    </plugin>
19
                </plugins>
20
            </build>
21
        </profile>
22
    </profiles>

本地要安装 graalvm jdk17 环境，并设置为JAVA_HOME。之后便可以尝试构建了。命令 mvn -Pnative -DskipTests=true native:compile

在经历一段时间后，会在target目录中生成 simple-boot-douban-api 文件， ./simple-boot-douban-api 直接可以启动。

尝试调用，出现报错找不到 caffeine cache相关的类。网上搜索一下，有给出解决方案的，使用 spring 提供的接口，把依赖的类型注册进去。测试了一下挺麻烦的，也没解决问题。spring core本身提供的内建的缓存，直接用也行。遂移除依赖 spring-boot-starter-cache 和 caffeine ，重新构建，功能OK。

对比 simple-boot-douban-api.jar 20MB的体积，simple-boot-douban-api 大小涨到 70MB，使用 upx 处理后，大约 30MB。体积还行。
启动速度上 jar包是 1.004，本机启动 0.07，快了不少
内存占用大约少了1/3

设备 Macbook pro M3 max

Docker镜像构建#

目前我需要构建 x64 和 arm64 的镜像，使用docker的buildx 拉起两个环境，分别构建。

示例 Dockerfile

1
# Start with base image
2
FROM vegardit/graalvm-maven:latest-java17 AS build
3
WORKDIR /app
4
COPY ./ /app
5
RUN --mount=type=cache,id=maven,target=/mvn/store mvn -Dmaven.repo.local=/mvn/store -Pnative -DskipTests=true clean  native:compile
6
RUN upx /app/target/simple-boot-douban-api
7
# Start with base image
8
FROM debian:bookworm-slim
9

10
WORKDIR /app
11
# Add Maintainer Info
12
LABEL maintainer="jianyun8023"
13

14
# Add a temporary volume
15
VOLUME /tmp
16

17
# Expose Port 8085
18
EXPOSE 8085
19

20
ENV DOUBAN_CONCURRENCY_SIZE="5"
21
ENV DOUBAN_BOOK_CACHE_SIZE="1000"
22
ENV DOUBAN_BOOK_CACHE_EXPIRE="24h"
23
ENV DOUBAN_PROXY_IMAGE_URL="true"
24

25
# Add Application Jar File to the Container
26
COPY --from=build /app/target/simple-boot-douban-api simple-boot-douban-api
27

28
# Run the JAR file
29
ENTRYPOINT ["bash","-c","/app/simple-boot-douban-api"]

Github Action 配置

1
name: Build simple-boot-douban-api Images
2
on:
3
  workflow_dispatch:
4
  release:
5
    types: [published]
6
env:
7
  IMAGE_NAME: simple-boot-douban-api
8
  VERSION: '0.0.1'
9

10
jobs:
11
  docker:
12
    runs-on: ubuntu-latest
13
    steps:
14
      - name: Set VERSION for release
15
        if: github.event_name == 'release'
16
        run: echo "VERSION=${{ github.event.release.tag_name }}" >> $GITHUB_ENV
17

18
      - name: Checkout
19
        uses: actions/checkout@v3
20
      - name: Set up Java
21
        uses: actions/setup-java@v3
22
        with:
23
          distribution: 'adopt'
24
          java-version: '17'
25

26
      - name: Create Maven repository directory
27
        run: |
28
          mkdir -p ~/.m2/repository
29
          chmod 755 ~/.m2/repository
30

31
      - name: Cache Maven packages
32
        uses: actions/cache@v4
33
        id: cache
34
        with:
35
          path: ~/.m2/repository
36
          key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
37
          restore-keys: |
38
            ${{ runner.os }}-maven-
39

40
      - name: inject Maven packages cache into docker
41
        uses: reproducible-containers/[email protected]
42
        with:
43
          cache-map: |
44
            {
45
              "~/.m2/repository": "/mvn/store"
46
            }
47
          skip-extraction: ${{ steps.cache.outputs.cache-hit }}
48

49
      - name: Set up QEMU
50
        uses: docker/setup-qemu-action@v2
51
      - name: Set up Docker Buildx
52
        uses: docker/setup-buildx-action@v2
53
      - name: Log in to registry
54
        uses: docker/login-action@v2
55
        with:
56
          registry: ghcr.io
57
          username: ${{ github.actor }}
58
          password: ${{ secrets.GITHUB_TOKEN }}
59

60
      - name: Build and push
61
        uses: docker/build-push-action@v4
62
        with:
63
          context: ./
64
          platforms: linux/amd64,linux/arm64
65
          cache-from: type=gha
66
          cache-to: type=gha,mode=max
67
          build-args: |
68
            VERSION=${{ env.VERSION }}
69
          push: true
70
          tags: |
71
            ghcr.io/${{ github.repository_owner }}/${{ env.IMAGE_NAME }}:${{ env.VERSION }}
72
            ghcr.io/${{ github.repository_owner }}/${{ env.IMAGE_NAME }}:latest

镜像信息 hZECuA

个人感受#

使用 GraalVM 可以构建出 Java 的本机镜像，可以降低资源的使用量，提高启动速度。但是它带来的繁琐度和维护成本增加，个人感觉没太大吸引力。使用 Go 做这件事它不香吗？

对企业来说，维护难度低比少点内存，少占一点资源更有吸引力。至于启动速度，我想一分钟以内的差距应该问题不大。

对我而言，非常简单的项目可能会玩一下，如果我写这个项目，我会换成 Go 实现。复杂项目使用它太麻烦了。当然，构建本机镜像可以做到像Go那像简单，我会很乐意使用的。

参考资料#

simple-boot-douban-api: https://github.com/fugary/simple-boot-douban-api
Native Images with Spring Boot and GraalVM: https://www.baeldung.com/spring-native-intro