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.
3.9 KiB
3.9 KiB
OCI and Docker exporters
The oci
exporter outputs the build result into an
OCI image layout
tarball. The docker
exporter behaves the same way, except it exports a Docker
image layout instead.
The docker
driver doesn't support these exporters. You
must use docker-container
or some other driver if you want to generate these
outputs.
Synopsis
Build a container image using the oci
and docker
exporters:
$ docker buildx build --output type=oci[,parameters] .
$ docker buildx build --output type=docker[,parameters] .
The following table describes the available parameters:
Parameter | Type | Default | Description |
---|---|---|---|
name |
String | Specify image name(s) | |
dest |
String | Path | |
tar |
true ,false |
true |
Bundle the output into a tarball layout |
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 |
Use OCI media types in exporter manifests. Defaults to true for type=oci , and false for type=docker . See OCI Media types |
|
buildinfo |
true ,false |
true |
Attach inline build info |
buildinfo-attrs |
true ,false |
false |
Attach inline build info attributes |
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 oci
or docker
exporters, see the
BuildKit README.