Share feedback
Answers are generated based on the documentation.

矩阵目标（Matrix targets）

Table of contents

矩阵策略让你可以根据指定的参数将单个目标分叉为多个不同的变体。其工作方式类似于 GitHub Actions 的矩阵策略。 你可以用它来减少 Bake 定义中的重复。

矩阵属性是一个从参数名到值列表的映射。Bake 将每个可能的值组合作为一个独立目标进行构建。

每个生成的目标都必须有唯一的名称。要指定目标名称应如何解析，请使用 name 属性。

以下示例将 app 目标解析为 app-foo 和 app-bar。它还使用矩阵值来定义 目标构建阶段。

docker-bake.hcl 
target "app" {
  name = "app-${tgt}"
  matrix = {
    tgt = ["foo", "bar"]
  }
  target = tgt
}
$ docker buildx bake --print app
[+] Building 0.0s (0/0)
{
  "group": {
    "app": {
      "targets": [
        "app-foo",
        "app-bar"
      ]
    },
    "default": {
      "targets": [
        "app"
      ]
    }
  },
  "target": {
    "app-bar": {
      "context": ".",
      "dockerfile": "Dockerfile",
      "target": "bar"
    },
    "app-foo": {
      "context": ".",
      "dockerfile": "Dockerfile",
      "target": "foo"
    }
  }
}

多个轴

你可以在矩阵中指定多个键，以在多个轴上分叉目标。使用多个矩阵键时，Bake 会构建每个可能的变体。

以下示例构建四个目标：

  • app-foo-1-0
  • app-foo-2-0
  • app-bar-1-0
  • app-bar-2-0
docker-bake.hcl 
target "app" {
  name = "app-${tgt}-${replace(version, ".", "-")}"
  matrix = {
    tgt = ["foo", "bar"]
    version = ["1.0", "2.0"]
  }
  target = tgt
  args = {
    VERSION = version
  }
}

每个矩阵目标多个值

如果你想在多个值上区分矩阵，而不只是单个值，可以使用 map 作为矩阵值。Bake 为每个 map 创建一个目标， 你可以使用点表示法访问嵌套值。

以下示例构建两个目标：

  • app-foo-1-0
  • app-bar-2-0
docker-bake.hcl 
target "app" {
  name = "app-${item.tgt}-${replace(item.version, ".", "-")}"
  matrix = {
    item = [
      {
        tgt = "foo"
        version = "1.0"
      },
      {
        tgt = "bar"
        version = "2.0"
      }
    ]
  }
  target = item.tgt
  args = {
    VERSION = item.version
  }
}