使用 Bake 与额外上下文

目录

除了定义构建上下文的主 `context` 键外，每个目标还可以使用键为 `contexts` 定义的映射来定义额外的命名上下文。这些值对应于 构建命令 中的 `--build-context` 标志。

在 Dockerfile 中，这些上下文可以与 `FROM` 指令或 `--from` 标志一起使用。

支持的上下文值包括

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

固定 alpine 镜像

Dockerfile
# syntax=docker/dockerfile:1
FROM alpine
RUN echo "Hello world"
docker-bake.hcl
target "app" {
  contexts = {
    alpine = "docker-image://alpine:3.13"
  }
}

使用二级源目录

Dockerfile
FROM golang
COPY --from=src . .
docker-bake.hcl
# Running `docker buildx bake app` will result in `src` not pointing
# to some previous build stage but to the client filesystem, not part of the context.
target "app" {
  contexts = {
    src = "../path/to/source"
  }
}

将目标用作构建上下文

要将一个目标的结果用作另一个目标的构建上下文，请使用 `target:` 前缀指定目标名称。

baseapp.Dockerfile
FROM scratch
Dockerfile
# 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 时才建议使用这种情况。

去除重复的上下文传输

注意

从 Buildx 0.17.0 及更高版本开始，Bake 会自动为共享相同上下文的目标去除重复的上下文传输。除了 Buildx 0.17.0 版本外，构建器必须运行 BuildKit 0.16.0 或更高版本，并且 Dockerfile 语法必须为 `docker/dockerfile:1.10` 或更高。

如果您满足这些要求，则无需手动去除本节所述的重复上下文传输。

  • 要检查 Buildx 版本，运行 `docker buildx version`。
  • 要检查 BuildKit 版本，运行 `docker buildx inspect --bootstrap` 并查找 `BuildKit version` 字段。
  • 要检查 Dockerfile 语法版本，请查看 Dockerfile 中的 `syntax` 解析器指令。如果不存在，则使用与当前 BuildKit 版本捆绑的默认版本。要显式设置版本，请在 Dockerfile 顶部添加 `#syntax=docker/dockerfile:1.10`。

使用组并行构建目标时，每个目标独立加载构建上下文。如果同一组中的多个目标使用相同的上下文，则该上下文会根据其使用次数传输多次。这可能会对构建时间产生显著影响，具体取决于您的构建配置。例如，假设您有一个定义了以下目标组的 Bake 文件

docker-bake.hcl
group "default" {
  targets = ["target1", "target2"]
}

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

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

在这种情况下，构建默认组时，上下文 `.` 会传输两次：`target1` 一次，`target2` 一次。

如果您的上下文很小，并且您使用的是本地构建器，则重复的上下文传输可能不是大问题。但是，如果您的构建上下文很大，或者您有大量目标，或者您通过网络将上下文传输到远程构建器，则上下文传输会成为性能瓶颈。

为了避免多次传输相同的上下文，您可以定义一个仅加载上下文文件的命名上下文，并让需要这些文件的每个目标引用该命名上下文。例如，以下 Bake 文件定义了一个名为 `ctx` 的目标，`target1` 和 `target2` 都使用了该目标

docker-bake.hcl
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` 命名上下文，例如，使用 `--mount=from=ctx` 挂载其文件。

Dockerfile
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
页面选项