Go (gin)示例
Java (Spring Boot)示例
多阶段构建镜像如何编写
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 builder
LABEL authors="ff755"
ENV GO111MODULE=on
ENV GOPROXY=https://goproxy.cn
WORKDIR /app
COPY . /app
RUN GOOS=linux GOARCH=amd64 go build -o app
FROM alpine:3.19.1
WORKDIR /app
COPY --from=builder /app .
EXPOSE 3000
CMD ["./app"]
使用命令 docker build -f Dockerfile-builder -t hello-go:builder .
构建。
下面是一个使用传统方式的示例 Dockerfile,构建出的镜像会比分阶段构建出来的镜像大很多:
FROM golang:1.22.2-alpine3.19
LABEL authors="ff755"
EXPOSE 3000
ENV GO111MODULE=on
ENV GOPROXY=https://goproxy.cn
WORKDIR /app
COPY . /app
RUN GOOS=linux GOARCH=amd64 go build -o app
CMD ["./app"]
使用命令docker build -t hello-go:default.
构建。
➜ hello-java git:(main) docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-go builder 5a3c1fc3d461 42 minutes ago 18.1MB
hello-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="ff755@outlook.com"
LABEL version="v0.0.2"
WORKDIR /app
COPY . /app/
COPY settings.xml /root/.m2/settings.xml
RUN mvn clean package -DskipTests=true
# 使用官方的alpine:3.19.1镜像作为运行镜像
FROM alpine:3.19.1
# 设置维护者信息
LABEL maintainer="ff755@outlook.com"
# 更新系统包并安装必要的工具以解压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.jar
ARG 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.gz
WORKDIR /usr/lib/jvm
RUN curl -LJO ${JDK_URL} && \
tar -xzf ${JDK_ARCHIVE} && \
rm ${JDK_ARCHIVE}
# 设置Java环境变量
ENV JAVA_HOME=/usr/lib/jvm/jdk-21.0.2+13-jre
ENV PATH=$JAVA_HOME/bin:$PATH
EXPOSE 8080
# 检查Java是否安装成功
RUN java -version
WORKDIR /app
COPY --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 /app
COPY . /app/
# 网络问题,添加maven国内源,节省一支烟
COPY settings.xml /root/.m2/settings.xml
RUN 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 images
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-java builder c3502bb0f04a 50 seconds ago 201MB
hello-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
目录到第二阶段镜像的当前目录(即工作目录)。
对于需要通过编译的编程语言,可以在第一阶段选完整的编译镜像;第二阶段选运行期间最小依赖的镜像,仅包含运行应用程序所需的最小文件集和依赖。通过分阶段构建镜像的方式,可以发现分阶段构建是一中有效优化镜像大小方式,推荐使用。
忍不住要加个关注!不是我吹,但你会后悔没关注的!