docker buildx create

描述	创建一个新的构建器实例
用法	`docker buildx create [OPTIONS] [CONTEXT\|ENDPOINT]`

描述

Create 命令创建一个新的构建器实例，指向 Docker 上下文或端点，其中上下文是从docker context ls获取的上下文名称，端点是 Docker socket 的地址（例如，DOCKER_HOST 值）。

默认情况下，使用当前 Docker 配置来确定上下文/端点值。

构建器实例是用于调用构建的隔离环境。所有 Docker 上下文也都获得默认的构建器实例。

选项	默认值	描述
`--append`		将节点附加到构建器而不是更改它
`--bootstrap`		创建后启动构建器
`--buildkitd-config`		BuildKit 守护进程配置文件
`--buildkitd-flags`		BuildKit 守护进程标志
`--driver`		要使用的驱动程序（可用：`docker-container`, `kubernetes`, `remote`)
`--driver-opt`		驱动程序的选项
`--leave`		从构建器中删除节点而不是更改它
`--name`		构建器实例名称
`--node`		创建/修改具有给定名称的节点
`--platform`		当前节点的固定平台
`--use`		设置当前构建器实例

--append 标志将命令的操作更改为将新节点附加到由--name指定的现有构建器。Buildx 将根据其支持的平台为构建选择合适的节点。

$ docker buildx create mycontext1
eager_beaver

$ docker buildx create --name eager_beaver --append mycontext2
eager_beaver

--buildkitd-config FILE

指定要使用的 BuildKit 守护进程的配置文件。该配置可以被--buildkitd-flags覆盖。查看示例 BuildKit 守护进程配置文件。

如果未指定配置文件，Buildx 会默认在以下位置查找：

请注意，如果您创建了一个docker-container构建器并在buildkitd.toml配置中为注册表指定了证书，则这些文件将复制到容器中的/etc/buildkit/certs下，并且配置将更新以反映这一点。

--buildkitd-flags FLAGS

启动 BuildKit 守护进程时添加标志。它们优先于--buildkitd-config指定的配置文件。有关可用标志，请参见buildkitd --help。

--buildkitd-flags '--debug --debugaddr 0.0.0.0:6666'

您可以使用--buildkitd-config指定的配置文件使用worker.oci.networkMode选项或此处使用的--oci-worker-net标志来指定 BuildKit 守护进程的网络模式。默认值为auto，可以是bridge、cni、host之一。

--buildkitd-flags '--oci-worker-net bridge'

注意
从 BuildKit v0.13 版本开始支持“bridge”网络模式，并且将在下一个 v0.14 版本中成为默认值。

--driver DRIVER

设置要使用的构建器驱动程序。驱动程序是 BuildKit 后端的配置。Buildx 支持以下驱动程序：

有关构建驱动程序的更多信息，请参见此处。

使用内置于 Docker 守护程序中的构建器。使用此驱动程序，默认情况下，在buildx build中隐含--load标志。但是，目前不支持构建多平台镜像或导出缓存。

使用通过 Docker 生成的 BuildKit 容器。使用此驱动程序，支持构建多平台镜像和导出缓存。

与docker驱动程序不同，构建的镜像不会自动出现在docker images中，需要使用build --load来实现。

使用 Kubernetes Pod。使用此驱动程序，您可以启动具有定义的 BuildKit 容器镜像的 Pod 来构建您的镜像。

与docker驱动程序不同，构建的镜像不会自动出现在docker images中，需要使用build --load来实现。

通过任意连接使用 BuildKit 守护进程的远程实例。使用此驱动程序，您可以手动创建和管理 BuildKit 实例，并配置 buildx 指向它。

与docker驱动程序不同，构建的镜像不会自动出现在docker images中，需要使用build --load来实现。

--driver-opt OPTIONS

传递其他特定于驱动程序的选项。有关可用驱动程序选项的信息，请参阅特定驱动程序的详细文档。

--leave标志将命令的操作更改为从构建器中删除节点。需要使用--name指定构建器，并使用--node设置要删除的节点。

$ docker buildx create --name mybuilder --node mybuilder0 --leave

--name NAME

--name标志指定要创建或修改的构建器的名称。如果未指定，则会自动生成一个名称。

--node NODE

--node标志指定要创建或修改的节点的名称。如果未指定名称，则节点名称默认为其所属构建器的名称，后缀为索引号。

--platform PLATFORMS

--platform标志设置节点支持的平台。它需要一个以 OS/架构/变体形式的平台的逗号分隔列表。节点还将自动检测其支持的平台，但手动值优先于检测到的值，并且可以在多个节点支持构建同一平台时使用。

$ docker buildx create --platform linux/amd64
$ docker buildx create --platform linux/arm64,linux/arm/v7

--use标志会自动将当前构建器切换到新创建的构建器。相当于运行docker buildx use $(docker buildx create ...)。