docker buildx imagetools create

描述基于源镜像创建一个新镜像
用法docker buildx imagetools create [OPTIONS] [SOURCE] [SOURCE...]

描述

基于源清单文件创建一个新的清单列表。源清单文件可以是清单列表或单平台分发清单，并且必须已经存在于创建新清单的注册表中。

如果只指定一个源，并且该源是清单列表或镜像索引，则create执行完全复制。如果只指定一个源，并且该源 *不是* 列表或索引，则输出将是一个清单列表，但是您可以使用--prefer-index=false禁用此行为，这将尝试在输出中保留源清单格式。

选项

选项默认值描述
--annotation向镜像添加注释
--append追加到现有清单
--dry-run显示最终镜像而不是推送
-f, --file从文件读取源描述符
--prefer-indextrue当只指定单个源时，优先输出镜像索引或清单列表，而不是执行完全复制。
--progressauto设置进度输出类型 (auto, plain, tty, rawjson)。使用plain显示容器输出。
-t, --tag设置新镜像的引用

示例

向镜像添加注释 (--annotation)

--annotation标志允许您在创建新镜像时向镜像索引、清单和描述符添加注释。

以下命令创建一个带有org.opencontainers.image.authors注释的foo/bar:latest镜像。

$ docker buildx imagetools create \
  --annotation "index:org.opencontainers.image.authors=dvdksn" \
  --tag foo/bar:latest \
  foo/bar:alpha foo/bar:beta foo/bar:gamma

注意

imagetools create命令支持使用以下类型前缀向镜像索引和描述符添加注释：

  • index
  • manifest-descriptor

它不支持注释清单或OCI布局。

有关注释的更多信息，请参阅注释。

将新的源追加到现有的清单列表 (--append)

使用--append标志将新的源追加到目标中的现有清单列表。

覆盖已配置的构建器实例 (--builder)

与buildx --builder相同。

显示最终镜像而不是推送 (--dry-run)

使用--dry-run标志不推送镜像，只显示它。

从文件读取源描述符 (-f, --file)

-f FILE or --file FILE

从文件读取源。源可以是清单摘要、清单引用或OCI描述符对象的JSON。

为了定义注释或其他平台属性，例如os.version和os.features，您需要将它们添加到用JSON编码的OCI描述符对象中。

$ docker buildx imagetools inspect --raw alpine | jq '.manifests[0] | .platform."os.version"="10.1"' > descr.json
$ docker buildx imagetools create -f descr.json myuser/image

如果注册表中存在该文件中的描述符，则将其与注册表中的现有描述符合并。

描述符支持的字段在OCI规范中定义。

设置新镜像的引用 (-t, --tag)

-t IMAGE or --tag IMAGE

使用-t或--tag标志设置要创建的镜像的名称。

$ docker buildx imagetools create --dry-run alpine@sha256:5c40b3c27b9f13c873fefb2139765c56ce97fd50230f1f2d5c91e55dec171907 sha256:c4ba6347b0e4258ce6a6de2401619316f982b7bcc529f73d2a410d0097730204
$ docker buildx imagetools create -t tonistiigi/myapp -f image1 -f image2