多阶段构建
多阶段构建对于那些努力优化 Dockerfile 同时保持其易于阅读和维护的人来说非常有用。
使用多阶段构建
通过多阶段构建，您可以FROM在 Dockerfile 中使用多个语句。每条FROM指令可以使用不同的基础，并且每条指令都开始构建的新阶段。您可以有选择地将工件从一个阶段复制到另一个阶段，从而在最终图像中留下您不想要的所有内容。
以下 Dockerfile 有两个独立的阶段：一个用于构建二进制文件，另一个阶段将二进制文件从第一阶段复制到下一阶段。
# syntax=docker/dockerfile:1
FROM golang:1.21
WORKDIR /src
COPY <<EOF ./main.go
package main
import "fmt"
func main() {
fmt.Println("hello, world")
}
EOF
RUN go build -o /bin/hello ./main.go
FROM scratch
COPY --from=0 /bin/hello /bin/hello
CMD ["/bin/hello"]您只需要单个 Dockerfile。不需要单独的构建脚本。赶紧跑docker build。
$ docker build -t hello .
最终结果是一个很小的生产图像，里面除了二进制文件之外什么也没有。生成的映像中不包含构建应用程序所需的任何构建工具。
它是如何工作的？第二条指令以图像为基础FROM开始新的构建阶段。scratch该COPY --from=0生产线仅将前一阶段中构建的工件复制到新阶段中。 Go SDK 和任何中间工件都会被留下，并且不会保存在最终映像中。
命名您的构建阶段
默认情况下，阶段没有命名，您可以通过它们的整数来引用它们，第一FROM条指令从 0 开始。但是，您可以通过在指令AS <NAME>中添加 来命名您的阶段FROM。此示例通过命名阶段并在COPY指令中使用名称来改进前一个示例。这意味着即使 Dockerfile 中的指令稍后重新排序，也COPY不会中断。
# syntax=docker/dockerfile:1
FROM golang:1.21 as build
WORKDIR /src
COPY <<EOF /src/main.go
package main
import "fmt"
func main() {
fmt.Println("hello, world")
}
EOF
RUN go build -o /bin/hello ./main.go
FROM scratch
COPY --from=build /bin/hello /bin/hello
CMD ["/bin/hello"]停止在特定的构建阶段
当您构建镜像时，您不一定需要构建整个 Dockerfile（包括每个阶段）。您可以指定目标构建阶段。以下命令假设您正在使用上一个命令Dockerfile，但在名为 的阶段停止build：
$ docker build --target build -t hello .
这可能有用的一些场景是：
- 调试特定构建阶段
- 使用
debug启用了所有调试符号或工具的阶段以及精益production阶段 - 使用
testing应用程序填充测试数据的阶段，但使用使用真实数据的不同阶段进行生产构建
使用外部图像作为舞台
使用多阶段构建时，您不仅限于从之前在 Dockerfile 中创建的阶段进行复制。您可以使用该COPY --from指令从单独的映像进行复制，可以使用本地映像名称、本地或 Docker 注册表上可用的标签或标签 ID。如果需要，Docker 客户端会拉取映像并从那里复制工件。语法是：
COPY --from=nginx:latest /etc/nginx/nginx.conf /nginx.conf使用前一个阶段作为新阶段
您可以在使用该指令时通过引用上一阶段停止的地方继续进行FROM。例如：
# syntax=docker/dockerfile:1
FROM alpine:latest AS builder
RUN apk --no-cache add build-base
FROM builder AS build1
COPY source1.cpp source.cpp
RUN g++ -o /binary source.cpp
FROM builder AS build2
COPY source2.cpp source.cpp
RUN g++ -o /binary source.cpp遗留构建器和 BuildKit 之间的差异
旧版 Docker 引擎构建器处理 Dockerfile 的所有阶段，直到选定的--target.即使所选目标不依赖于该阶段，它也会构建一个阶段。
BuildKit只构建目标阶段所依赖的阶段。
例如，给定以下 Dockerfile：
# syntax=docker/dockerfile:1
FROM ubuntu AS base
RUN echo "base"
FROM base AS stage1
RUN echo "stage1"
FROM base AS stage2
RUN echo "stage2"启用 BuildKit后，
stage2在此 Dockerfile 中构建目标仅意味着base和stage2被处理。不依赖于stage1，因此被跳过。
$ DOCKER_BUILDKIT=1 docker build --no-cache -f Dockerfile --target stage2 .
[+] Building 0.4s (7/7) FINISHED
=> [internal] load build definition from Dockerfile 0.0s
=> => transferring dockerfile: 36B 0.0s
=> [internal] load .dockerignore 0.0s
=> => transferring context: 2B 0.0s
=> [internal] load metadata for docker.io/library/ubuntu:latest 0.0s
=> CACHED [base 1/2] FROM docker.io/library/ubuntu 0.0s
=> [base 2/2] RUN echo "base" 0.1s
=> [stage2 1/1] RUN echo "stage2" 0.2s
=> exporting to image 0.0s
=> => exporting layers 0.0s
=> => writing image sha256:f55003b607cef37614f607f0728e6fd4d113a4bf7ef12210da338c716f2cfd15 0.0s
另一方面，在没有 BuildKit 的情况下构建相同的目标会导致所有阶段都被处理：
$ DOCKER_BUILDKIT=0 docker build --no-cache -f Dockerfile --target stage2 .
Sending build context to Docker daemon 219.1kB
Step 1/6 : FROM ubuntu AS base
---> a7870fd478f4
Step 2/6 : RUN echo "base"
---> Running in e850d0e42eca
base
Removing intermediate container e850d0e42eca
---> d9f69f23cac8
Step 3/6 : FROM base AS stage1
---> d9f69f23cac8
Step 4/6 : RUN echo "stage1"
---> Running in 758ba6c1a9a3
stage1
Removing intermediate container 758ba6c1a9a3
---> 396baa55b8c3
Step 5/6 : FROM base AS stage2
---> d9f69f23cac8
Step 6/6 : RUN echo "stage2"
---> Running in bbc025b93175
stage2
Removing intermediate container bbc025b93175
---> 09fc3770a9c4
Successfully built 09fc3770a9c4
遗留构建器进程stage1，即使stage2不依赖它。