将 Bake 与其他上下文一起使用

除了主要的contextkey 来定义构建上下文，则每个 Target 还可以使用使用 key 定义的映射来定义其他命名上下文contexts.这些值映射到--build-contextbuild 中的标志命令。

在 Dockerfile 中，这些上下文可以与FROM指令或--from旗。

支持的上下文值包括：

本地文件系统目录
容器镜像
Git 网址
HTTP 网址
Bake 文件中另一个目标的名称

固定 alpine 镜像

# syntax=docker/dockerfile:1
FROM alpine
RUN echo "Hello world"

# docker-bake.hcl
target "app" {
  contexts = {
    alpine = "docker-image://alpine:3.13"
  }
}

使用辅助源目录

# syntax=docker/dockerfile:1
FROM scratch AS src

FROM golang
COPY --from=src . .

# docker-bake.hcl
target "app" {
  contexts = {
    src = "../path/to/source"
  }
}

将目标用作构建上下文

要将一个目标的结果用作另一个目标的构建上下文，请指定目标 name 替换为target:前缀。

# syntax=docker/dockerfile:1
FROM baseapp
RUN echo "Hello world"

# docker-bake.hcl
target "base" {
  dockerfile = "baseapp.Dockerfile"
}

target "app" {
  contexts = {
    baseapp = "target:base"
  }
}

在大多数情况下，您应该只使用单个多阶段 Dockerfile，其中包含多个目标进行类似行为。仅在以下情况下建议使用此案例多个 Dockerfile，这些 Dockerfile 无法轻松合并为一个。

删除重复的上下文传输

注意
从 Buildx 版本 0.17.0 及更高版本开始，Bake 会自动删除重复数据 Context Transfer （上下文传输）。除了 Buildx 版本 0.17.0，则构建器必须运行 BuildKit 版本 0.16.0 或 later，并且 Dockerfile 语法必须为docker/dockerfile:1.10或之后。
如果您满足这些要求，则无需手动删除重复数据上下文传输，如本节所述。
要检查您的 Buildx 版本，请运行docker buildx version.
要检查您的 BuildKit 版本，请运行docker buildx inspect --bootstrap和查找BuildKit version田。
要检查您的 Dockerfile 语法版本，请检查syntax parser 指令。如果它不存在，默认版本与您的当前版本的 BuildKit。要显式设置版本，请添加#syntax=docker/dockerfile:1.10位于 Dockerfile 的顶部。

当您使用组并发构建目标时，将加载构建上下文独立。如果多个目标使用相同的上下文在组中，每次使用该上下文时，都会传输一次该上下文。这可以对构建时间产生重大影响，具体取决于您的构建配置。例如，假设您有一个 Bake 文件，它定义了以下内容目标组：

group "default" {
  targets = ["target1", "target2"]
}

target "target1" {
  target = "target1"
  context = "."
}

target "target2" {
  target = "target2"
  context = "."
}

在这种情况下，上下文.在构建默认的组：一次target1和 1 次用于target2.

如果您的上下文较小，并且您使用的是本地构建器，请复制上下文传输可能没什么大不了的。但是，如果您的构建上下文很大，或者您有大量目标，或者您正在通过网络传输到远程构建器，上下文传输将成为性能瓶颈。

为避免多次传输同一上下文，您可以定义一个命名的 context 的 context，它只加载上下文文件，并且每个目标都需要这些文件引用该命名 context。例如，以下 Bake 文件定义命名目标ctx，它由target1和target2:

group "default" {
  targets = ["target1", "target2"]
}

target "ctx" {
  context = "."
  target = "ctx"
}

target "target1" {
  target = "target1"
  contexts = {
    ctx = "target:ctx"
  }
}

target "target2" {
  target = "target2"
  contexts = {
    ctx = "target:ctx"
  }
}

命名上下文ctx表示一个 Dockerfile 阶段，该阶段将复制文件从其上下文（.).Dockerfile 中的其他阶段现在可以引用ctx命名 context，例如，使用--mount=from=ctx.

FROM scratch AS ctx
COPY --link . .

FROM golang:alpine AS target1
WORKDIR /work
RUN --mount=from=ctx \
    go build -o /out/client ./cmd/client \

FROM golang:alpine AS target2
WORKDIR /work
RUN --mount=from=ctx \
    go build -o /out/server ./cmd/server