You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
6.4 KiB
6.4 KiB
Image and registry exporters
The image exporter outputs the build result into a container image format. The
registry exporter is identical, but it automatically pushes the result by
setting push=true.
Synopsis
Build a container image using the image and registry exporters:
$ docker buildx build --output type=image[,parameters] .
$ docker buildx build --output type=registry[,parameters] .
The following table describes the available parameters that you can pass to
--output for type=image:
| Parameter | Value | Default | Description |
|---|---|---|---|
name |
String | Specify image name(s) | |
push |
true,false |
false |
Push after creating the image. |
push-by-digest |
true,false |
false |
Push image without name. |
registry.insecure |
true,false |
false |
Allow pushing to insecure registry. |
dangling-name-prefix |
<value> |
Name image with prefix@<digest>, used for anonymous images |
|
name-canonical |
true,false |
Add additional canonical name name@<digest> |
|
compression |
uncompressed,gzip,estargz,zstd |
gzip |
Compression type, see compression |
compression-level |
0..22 |
Compression level, see compression | |
force-compression |
true,false |
false |
Forcefully apply compression, see compression |
oci-mediatypes |
true,false |
false |
Use OCI media types in exporter manifests, see OCI Media types |
buildinfo |
true,false |
true |
Attach inline build info |
buildinfo-attrs |
true,false |
false |
Attach inline build info attributes |
unpack |
true,false |
false |
Unpack image after creation (for use with containerd) |
store |
true,false |
true |
Store the result images to the worker's (for example, containerd) image store, and ensures that the image has all blobs in the content store. Ignored if the worker doesn't have image store (when using OCI workers, for example). |
annotation.<key> |
String | Attach an annotation with the respective key and value to the built image,see annotations |
Annotations
These exporters support adding OCI annotation using annotation.* dot notation
parameter. The following example sets the org.opencontainers.image.title
annotation for a build:
$ docker buildx build \
--output "type=<type>,name=<registry>/<image>,annotation.org.opencontainers.image.title=<title>" .
For more information about annotations, see BuildKit documentation.
Further reading
For more information on the image or registry exporters, see the
BuildKit README.