掘金 后端 ( ) • 2024-04-12 18:57
  1. Go (gin)示例

  2. Java (Spring Boot)示例

  3. 多阶段构建镜像如何编写

Docker 分阶段构建(Multi-stage Builds)是一种优化镜像构建过程的技术,旨在减小最终生成的镜像大小,同时保持构建过程的简洁与高效。通过分阶段构建,您可以将构建过程划分为多个独立的阶段,每个阶段使用不同的基础镜像,并在不同阶段间只复制必要的文件,从而避免将构建过程中产生的中间文件和工具链等临时依赖项包含在最终镜像中。

通过一个Go和一个Spring Boot实例,演示分阶段构建到底和我们之前的构建有什么不同的地方,下面开始。

go源码地址:https://gitee.com/ft/hello-go

java源码地址:https://gitee.com/ft/hello-java

1. Go (gin)示例

下面是一个使用分阶段构建的示例 Dockerfile,以减小 Go应用的镜像大小:

FROM golang:1.22.2-alpine3.19 as builderLABEL authors="ff755"ENV GO111MODULE=onENV GOPROXY=https://goproxy.cnWORKDIR /appCOPY . /appRUN GOOS=linux GOARCH=amd64 go build -o app​FROM alpine:3.19.1WORKDIR /appCOPY --from=builder /app .​EXPOSE 3000​CMD ["./app"]

使用命令 docker build -f Dockerfile-builder -t hello-go:builder .构建。

下面是一个使用传统方式的示例 Dockerfile,构建出的镜像会比分阶段构建出来的镜像大很多:

FROM golang:1.22.2-alpine3.19LABEL authors="ff755"EXPOSE 3000​ENV GO111MODULE=onENV GOPROXY=https://goproxy.cn​WORKDIR /appCOPY . /appRUN GOOS=linux GOARCH=amd64 go build -o app​CMD ["./app"]

使用命令docker build -t hello-go:default.构建。

➜  hello-java git:(main) docker imagesREPOSITORY                                      TAG                       IMAGE ID       CREATED             SIZEhello-go                                        builder                   5a3c1fc3d461   42 minutes ago      18.1MBhello-go                                        default                   468746cad8de   45 minutes ago      550MB

列出刚构建成功的2个镜像,通过观察可以发现,使用了分阶段构建的镜像只有18.1MB,而未使用分阶段构建镜像的高达550MB。因为Go语言生成二进制文件,不需要安装任何依赖,就可以执行。通过分阶段构建的方式,让镜像仅包含编译好的go文件,可以有效减小构建我们镜像大小。

2. Java (Spring Boot)示例

下面是一个使用分阶段构建的示例 Dockerfile,以减小 Java应用的镜像大小:

# 使用官方的maven:3.9.6-amazoncorretto-21镜像作为基础镜像FROM maven:3.9.6-amazoncorretto-21 AS builder​# 设置维护者信息LABEL maintainer="[email protected]"LABEL version="v0.0.2"WORKDIR /appCOPY . /app/COPY settings.xml /root/.m2/settings.xmlRUN mvn clean package -DskipTests=true​# 使用官方的alpine:3.19.1镜像作为运行镜像FROM alpine:3.19.1​# 设置维护者信息LABEL maintainer="[email protected]"​# 更新系统包并安装必要的工具以解压tar.gz文件RUN apk update && \    apk add --no-cache ca-certificates curl tar gzip bash​ARG JAR_PATH=/app/target/demo-0.0.1-SNAPSHOT.jarARG JDK_ARCHIVE=OpenJDK21U-jre_x64_alpine-linux_hotspot_21.0.2_13.tar.gz# 下载并解压OpenJDK到指定目录(这里假设解压到/usr/lib/jvm)ARG JDK_URL=https://github.com/adoptium/temurin21-binaries/releases/download/jdk-21.0.2%2B13/OpenJDK21U-jre_x64_alpine-linux_hotspot_21.0.2_13.tar.gzWORKDIR /usr/lib/jvmRUN curl -LJO ${JDK_URL} && \    tar -xzf ${JDK_ARCHIVE} && \    rm ${JDK_ARCHIVE}​# 设置Java环境变量ENV JAVA_HOME=/usr/lib/jvm/jdk-21.0.2+13-jreENV PATH=$JAVA_HOME/bin:$PATHEXPOSE 8080# 检查Java是否安装成功RUN java -version​WORKDIR /appCOPY --from=builder ${JAR_PATH} ./app.jar# 容器启动时运行的命令(例如空命令,容器启动后进入bash shell)CMD ["java", "-jar", "app.jar"]

使用docker build -t hello-java:build . 构建。

Java运行阶段只需要jre就可以,无需添加jdk。可以有效减少构建镜像的大小。

网络原因,关于jre通过GithHub下载,如构建镜像的过程无法成功,可以通过windows下载。使用COPY复制进容器操作。

下面是一个使用传统方式的示例 Dockerfile,构建出的镜像会比分阶段构建出来的镜像大很多:

# 使用官方的maven:3.9.6-amazoncorretto-21镜像作为基础镜像FROM maven:3.9.6-amazoncorretto-21​EXPOSE 8080​WORKDIR /appCOPY . /app/# 网络问题,添加maven国内源,节省一支烟COPY settings.xml /root/.m2/settings.xmlRUN mvn clean package -DskipTests=true​EXPOSE 8080​# COPY /app/target/demo-0.0.1-SNAPSHOT.jar ./app.jar# 容器启动时运行的命令(例如空命令,容器启动后进入bash shell)CMD ["java", "-jar", "/app/target/demo-0.0.1-SNAPSHOT.jar"]

使用 `docker build -t hello-java:default . `构建。

➜  hello-java git:(main) docker imagesREPOSITORY                                      TAG                       IMAGE ID       CREATED          SIZEhello-java                                      builder                   c3502bb0f04a   50 seconds ago   201MBhello-java                                      default                   f1e00d0b8941   2 minutes ago    1.01GB                468746cad8de   9 minutes ago       550MB

列出刚构建成功的2个镜像,通过观察可以发现,使用了分阶段构建的镜像只有201.1MB,而未使用分阶段构建镜像的高达1.01GB。

分阶段构建只需要把maven为我们编译好的jar包,使用Alpine配置JRE环境即可运行。有效减小Spring Boot镜像的大小。

默认构建会把编译过程所有文件全部构建镜像,包含了JDK、及maven编译过程中用到的文件,加入了运行Spring Boot不需要的文件,严重影响了构建镜像大小。

3. 多阶段构建镜像如何编写

使用第一个go作为示例:

  • 第一阶段

第一行FROM maven:3.9.6-amazoncorretto-21 AS builder后面的AS builder,给第一阶段构建过程设置一个别名。

  • 第二阶段

在构建FROM alpine:3.19.1过程中,可以COPY --from=builder可以进入builder镜像,使用COPY --from=builder /app .会拷贝builder镜像的/app目录到第二阶段镜像的当前目录(即工作目录)。

对于需要通过编译的编程语言,可以在第一阶段选完整的编译镜像;第二阶段选运行期间最小依赖的镜像,仅包含运行应用程序所需的最小文件集和依赖。通过分阶段构建镜像的方式,可以发现分阶段构建是一中有效优化镜像大小方式,推荐使用。

忍不住要加个关注!不是我吹,但你会后悔没关注的!