docker buildx imagetools create
| 描述 | 基于源镜像创建新镜像 |
|---|---|
| 用法 | docker buildx imagetools create [OPTIONS] [SOURCE...] |
描述
基于源清单创建新的清单列表。源清单可以是清单列表或单平台分发清单，并且必须已存在于创建新清单的注册表中。
如果只指定一个源，并且该源是清单列表或镜像索引，则 create 执行碳拷贝。如果指定一个源，并且该源**不是**列表或索引，则输出将是一个清单列表，但是您可以使用 --prefer-index=false 禁用此行为，它会尝试在输出中保留源清单格式。
选项
| 选项 | 默认值 | 描述 |
|---|---|---|
--annotation | 向镜像添加注解 | |
--append | 附加到现有清单 | |
--dry-run | 显示最终镜像而不是推送 | |
-f, --file | 从文件中读取源描述符 | |
--prefer-index | true | 当只指定一个源时，优先输出镜像索引或清单列表，而不是执行碳拷贝 |
--progress | auto | 设置进度输出类型（`auto`、`plain`、`tty`、`rawjson`）。使用 plain 显示容器输出 |
-t, --tag | 设置新镜像的引用 |
示例
为镜像添加注释（--annotation）
使用 --annotation 标志可以在创建新镜像时为镜像索引、清单和描述符添加注释。
以下命令创建一个 foo/bar:latest 镜像，并在镜像索引上带有 org.opencontainers.image.authors 注释。
$ 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命令支持使用以下类型前缀向镜像索引和描述符添加注释：
indexmanifest-descriptor它不支持注释清单或 OCI 布局。
有关注释的更多信息，请参阅注释。
将新源附加到现有清单列表（--append）
使用 --append 标志将新源附加到目标中的现有清单列表。
覆盖已配置的构建器实例（--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