Documentación offline Docker main
por @raupulus

Azure Blob Storage cache

main Documentación oficial Licencia Apache-2.0Descargado el 2026-09-15 Bundle .md (6.1 MB) ↓

En esta página

{{< summary-bar feature_name="Azure blob" >}}

The azblob cache store uploads your resulting build cache to Azure's blob storage service.

This cache storage backend is not supported with the default docker driver. To use this feature, create a new builder using a different driver. See Build drivers for more information.

Synopsis#

$ docker buildx build --push -t <registry>/<image> \
  --cache-to type=azblob,name=<cache-image>[,parameters...] \
  --cache-from type=azblob,name=<cache-image>[,parameters...] .

The following table describes the available CSV parameters that you can pass to --cache-to and --cache-from.

Name Option Type Default Description
name cache-to,cache-from String Required. The name of the cache image.
account_url cache-to,cache-from String Base URL of the storage account.
secret_access_key cache-to,cache-from String Blob storage account key, see authentication.
mode cache-to min,max min Cache layers to export, see cache mode.
ignore-error cache-to Boolean false Ignore errors caused by failed cache exports.

Authentication#

The secret_access_key, if left unspecified, is read from environment variables on the BuildKit server following the scheme for the Azure Go SDK. The environment variables are read from the server, not the Buildx client.

Further reading#

For an introduction to caching see Docker build cache.

For more information on the azblob cache backend, see the BuildKit README.