多阶段构建(缩小体积)

镜像尺寸顺序：`Distroless` < `Alpine` < `Slim`
```bash
# 镜像分析工具
docker scout quickview <镜像>
```

## Node.js 多阶段构建
这个示例为 [Docker-Nginx Config(配置生成器)](/doc/586/)，通过多阶段构建来缩小镜像体积
```bash
# 使用多阶段构建的 Dockerfile,旨在减小最终镜像的体积
# 生成的镜像只会保留最后一个阶段的

# 这个阶段主要用于构建项目的依赖和生成静态文件
# 基础镜像,as build-deps 定义阶段标签 build-deps,用于复制构建
FROM node:16.16 as build-deps
# 设置工作目录
WORKDIR /app
# 复制当前文件夹下所有文件到容器/app文件夹下
COPY . ./
# 安装项目所需依赖并完成构建静态文件
RUN npm install && npm run build

# 这个阶段用于构建最终的镜像
# 基础镜像
FROM nginx:1.12-alpine
# 复制构建的后静态文件,--from=build-deps 设置复制源为 build-deps(镜像名或标签)
# 从之前的构建阶段中的 /app/dist 目录复制静态文件到 Nginx 的默认静态文件目录 /usr/share/nginx/html
COPY --from=build-deps /app/dist /usr/share/nginx/html
# 声明容器端口80
EXPOSE 80
# 运行Nginx前台模式运行
CMD ["nginx", "-g", "daemon off;"]
```

## Go 多阶段构建
```bash
# 使用多阶段构建的 Dockerfile，旨在减小最终镜像的体积
# 生成的镜像只会保留最后一个阶段的内容

# 构建环境阶段
# 基础镜像为 Go 1.21，用于编译 Go 项目
FROM golang:1.21 AS builder
# 设置工作目录为 /app
WORKDIR /app
# 将 go.mod 和 go.sum 文件复制到工作目录中
# 这样可以提前下载依赖，利用 Docker 缓存机制，减少重复构建时间
COPY go.mod go.sum ./
# 下载项目依赖
RUN go mod download
# 将当前目录下的所有文件复制到工作目录中
COPY . .
# 设置 CGO_ENABLED=0 和 GOOS=linux，以编译出无依赖的静态二进制文件
# 使用 ldflags 参数去除符号表和调试信息，减小二进制文件大小
RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-w -s" -o app

# 运行环境阶段
# 基础镜像为 distroless/static-debian12，这是一个轻量级的静态运行环境
FROM gcr.io/distroless/static-debian12
# 设置工作目录为 /app
WORKDIR /app
# 从构建阶段的镜像中复制编译好的应用程序
COPY --from=builder /app/app .
# 从构建阶段的镜像中复制模板文件夹
COPY --from=builder /app/templates ./templates
# 设置用户为非特权用户（UID:GID = 65534:65534），提高安全性
USER 65534:65534
# 声明容器运行时暴露的端口为 8080
EXPOSE 8080
# 定义容器启动时运行的命令，直接运行编译好的应用程序
CMD ["/app/app"]
```

## Java 多阶段构建
```bash
# 使用多阶段构建的 Dockerfile，旨在减小最终镜像的体积并优化构建过程
# 生成的镜像只会保留最后一个阶段的内容

# 阶段1：Maven构建
# 基础镜像为 Maven 3.8 和 JDK 11，用于编译 Java 项目
FROM maven:3.8-jdk-11 AS builder
# 将项目源代码复制到工作目录的 src 子目录中
COPY src /app/src
# 将项目的 pom.xml 文件复制到工作目录中
COPY pom.xml /app
# 运行 Maven 命令，指定 pom.xml 文件路径，执行 clean 和 package 操作，生成 JAR 文件
RUN mvn -f /app/pom.xml clean package

# 阶段2：JRE瘦身
# 基础镜像为 Eclipse Temurin JDK 17 JRE 的 Alpine 版本
FROM eclipse-temurin:17-jre-alpine AS runtime
# 使用 jlink 工具创建一个精简的 JRE，去除调试信息、手册页和头文件
# 添加所有模块路径中的模块，并进行压缩，输出到 /jre-mini 目录
RUN jlink --strip-debug \
    --no-man-pages \
    --no-header-files \
    --add-modules ALL-MODULE-PATH \
    --compress=2 \
    --output /jre-mini

# 最终阶段
# 基础镜像为 Alpine 3.18，用于构建最终的轻量级运行环境
FROM alpine:3.18
# 从 JRE 瘦身阶段的镜像中复制精简后的 JRE 到 /opt/jre 目录
COPY --from=runtime /jre-mini /opt/jre
# 设置环境变量，指定 JAVA_HOME 为精简后的 JRE 目录
ENV JAVA_HOME=/opt/jre
# 将 Java 的可执行路径添加到系统的 PATH 环境变量中
ENV PATH="${JAVA_HOME}/bin:${PATH}"
# 从 Maven 构建阶段的镜像中复制生成的 JAR 文件到当前镜像的根目录
COPY --from=builder /app/target/*.jar /app.jar
# 声明容器运行时暴露的端口为 8080
EXPOSE 8080
# 定义容器启动时运行的命令，直接运行 JAR 文件
ENTRYPOINT ["java", "-jar", "/app.jar"]
```