SpringBoot 原生镜像分层

让编译、推拉镜像进入秒级

SpringBoot提供分层能力，支持构建分层的镜像，分层自下向上分四层

release版本依赖
快照版依赖
spring loader
项目编译后文件基于分层后的镜像，可以让编译、推拉镜像进入秒级，日常的编译后文件只有kb或者5M内大小

实践#

1. springboot生成分层元信息#

Springboot 2.4 版本及后layers默认打开

springboot插件的配置打开分层参数 layers=true

1
            <plugin>
2
                <groupId>org.springframework.boot</groupId>
3
                <artifactId>spring-boot-maven-plugin</artifactId>
4
                <version>2.3.8.RELEASE</version>
5
                <configuration>
6
                    <!-- 启用分层打包支持 -->
7
                    <layers>
8
                        <enabled>true</enabled>
9
                    </layers>
10
                </configuration>
11
                <executions>
12
                    <execution>
13
                        <goals>
14
                            <goal>repackage</goal>
15
                        </goals>
16
                    </execution>
17
                </executions>
18
            </plugin>

开启分层后，springboot会在fat jar中生成layers.idx元信息 layers.idx内容示例：

1
  - "dependencies":
2
    - "BOOT-INF/lib/dependency1.jar"
3
    - "BOOT-INF/lib/dependency2.jar"
4
  - "spring-boot-loader":
5
    - "org/"
6
  - "snapshot-dependencies":
7
    - "BOOT-INF/lib/dependency3-SNAPSHOT.jar"
8
    - "BOOT-INF/lib/dependency4-SNAPSHOT.jar"
9
  - "application":
10
    - "BOOT-INF/classes/"
11
    - "META-INF/"

2. 拆包和打镜像#

spingboot提供了拆包的命令，把springboot fat jar 拆包到extract目录示例命令 java -Djarmode=layertools -jar app.jar extract 执行后可以在extract中获得如下的目录

dependencies release版本依赖
snapshot-dependencies 快照版依赖
spring-boot-loader
application 项目编译后文件

简化打包的dockerfile，第一个镜像用于执行拆包，第二个构建启动镜像

1
# 分层构建, 加速增量构建
2

3
FROM openjdk:8 as builder
4

5
WORKDIR app
6
ARG JAR_FILE=target/*.jar
7
COPY ${JAR_FILE} app.jar
8
RUN java -Djarmode=layertools -jar app.jar extract && rm app.jar
9

10
FROM openjdk:8
11
ENV TZ=Asia/Shanghai
12
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
13
ENV JAVA_OPTS=" -server -Xmx1024m -Xms256m -Xmn512m -Xss256k"
14

15
WORKDIR app
16

17
COPY --from=builder /app/dependencies/ ./
18
COPY --from=builder /app/spring-boot-loader/ ./
19
COPY --from=builder /app/snapshot-dependencies/ ./
20
COPY --from=builder /app/application/ ./
21

22
EXPOSE 9081
23

24
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS org.springframework.boot.loader.JarLauncher"]

3. 集成mvn docker插件#

请先配置好docker的私有仓库、推拉

在mvn中可以增加docker插件，可以简化镜像的构建。

配置<dockerFileDir>${project.basedir}</dockerFileDir> 表示dockerfile文件在当前模块的根，和pom.xml平级。

示例

1
<properties>
2
        <docker.plugin.version>0.43.4</docker.plugin.version>
3
        <docker.registry>example.docker.com</docker.registry>
4
        <docker.namespace>example-dev</docker.namespace>
5
    </properties>
6
 <build>
7
        <plugins>
8
        <plugin>
9
                <groupId>io.fabric8</groupId>
10
                <artifactId>docker-maven-plugin</artifactId>
11
                <version>${docker.plugin.version}</version>
12
                <configuration>
13
                    <!-- Docker Remote Api-->
14
                    <!-- 本机则可以注释掉, 如果没有监听2375端口 -->
15
<!--                    <dockerHost>${docker.host}</dockerHost>-->
16
                    <!-- Docker 镜像私服-->
17
                    <registry>${docker.registry}</registry>
18

19
                    <images>
20
                        <image>
21
                            <name>${docker.registry}/${docker.namespace}/${project.name}:${project.version}</name>
22
                            <build>
23
                                <dockerFileDir>${project.basedir}</dockerFileDir>
24
                            </build>
25
                        </image>
26
                    </images>
27
                </configuration>
28
        <!-- build-image 把构建镜像绑定到了install流程，如果不需要可以把这块配置删除-->
29
                <executions>
30
                    <execution>
31
                        <id>build-image</id>
32
                        <phase>install</phase>
33
                        <goals>
34
                            <goal>build</goal>
35
                        </goals>
36
                    </execution>
37
                </executions>
38
            </plugin>
39
        </plugins>
40
    </build>

然后就可以使用下面命令打包和构建镜像了

1
# 编译jar包, 构建镜像和推送
2
mvn clean install docker:build docker:push

实践#

1. springboot生成分层元信息#

2. 拆包和打镜像#

3. 集成mvn docker插件#

参考文档#