mirror of
https://gitea.com/Lydanne/buildx.git
synced 2025-05-18 00:47:48 +08:00
1a8af33ff6
Use the usage output of `--help` for each subcommand, to make sure all flags/options are included on the page, and to make it easier to keep docs in sync. Note that the usage output is only used when reading these docs on GitHub; docs.docker.com only consumes the "description" and "example" sections (when present), and generates flag information and usage output from source Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
50 lines
1.5 KiB
Markdown
50 lines
1.5 KiB
Markdown
# buildx imagetools create
|
|
|
|
```
|
|
Usage: docker buildx imagetools create [OPTIONS] [SOURCE] [SOURCE...]
|
|
|
|
Create a new image based on source images
|
|
|
|
Options:
|
|
--append Append to existing manifest
|
|
--builder string Override the configured builder instance
|
|
--dry-run Show final image instead of pushing
|
|
-f, --file stringArray Read source descriptor from file
|
|
-t, --tag stringArray Set reference for new image
|
|
```
|
|
|
|
## Description
|
|
|
|
Imagetools contains commands for working with manifest lists in the registry.
|
|
These commands are useful for inspecting multi-platform build results.
|
|
|
|
Create creates a new manifest list based on source manifests. The source
|
|
manifests can be manifest lists or single platform distribution manifests and
|
|
must already exist in the registry where the new manifest is created. If only
|
|
one source is specified create performs a carbon copy.
|
|
|
|
### `--append`
|
|
|
|
Append appends the new sources to an existing manifest list in the destination.
|
|
|
|
### `--dry-run`
|
|
|
|
Do not push the image, just show it.
|
|
|
|
### `-f, --file FILE`
|
|
|
|
Reads source from files. A source can be a manifest digest, manifest reference,
|
|
or a JSON of OCI descriptor object.
|
|
|
|
### `-t, --tag IMAGE`
|
|
|
|
Name of the image to be created.
|
|
|
|
Examples:
|
|
|
|
```console
|
|
docker buildx imagetools create --dry-run alpine@sha256:5c40b3c27b9f13c873fefb2139765c56ce97fd50230f1f2d5c91e55dec171907 sha256:c4ba6347b0e4258ce6a6de2401619316f982b7bcc529f73d2a410d0097730204
|
|
|
|
docker buildx imagetools create -t tonistiigi/myapp -f image1 -f image2
|
|
```
|