Azure Blob Storage cache

Table of contents

Experimental

This is an experimental feature. The interface and behavior are unstable and may change in future releases.

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.

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.

Azure Blob Storage cache

Synopsis

Authentication

Further reading