OCI and Docker exporters

فهرست فصل‌ها دانلود آرشیوناشر

Docker Docs · نسخهٔ 747e4c7528c7 · CC BY 4.0 برای مستندات و مجوزهای همراه

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](/manuals/build/builders/drivers/docker.md) 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:

console
$ docker buildx build --output type=oci[,parameters] .
console
$ docker buildx build --output type=docker[,parameters] .

The following table describes the available parameters:

ParameterTypeDefaultDescription
nameStringSpecify image name(s)
destStringPath
tartrue,falsetrueBundle the output into a tarball layout
compressionuncompressed,gzip,estargz,zstdgzipCompression type, see [compression][1]
compression-level0..22Compression level, see [compression][1]
force-compressiontrue,falsefalseForcefully apply compression, see [compression][1]
oci-mediatypestrue,falseUse OCI media types in exporter manifests. Defaults to true for type=oci, and false for type=docker. See [OCI Media types][2]
annotation.<key>StringAttach an annotation with the respective key and value to the built image, see [annotations][3]
rewrite-timestamptrue,falsefalseRewrite the file timestamps to the SOURCE_DATE_EPOCH value. See [build reproducibility][4] for how to specify the SOURCE_DATE_EPOCH value.

[1]: _index.md#compression [2]: _index.md#oci-media-types [3]: #annotations [4]: https://github.com/moby/buildkit/blob/master/docs/build-repro.md

Annotations

These exporters support adding OCI annotation using annotation parameter, followed by the annotation name using dot notation. The following example sets the org.opencontainers.image.title annotation:

console
$ 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.