Merge pull request #20322 from dvdksn/cache-backends-docker

build(fix): cache backends require containerd with docker worker
This commit is contained in:
David Karlsson 2024-06-28 17:31:00 +02:00 committed by GitHub
commit 355c18cda0
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 7 additions and 5 deletions

View File

@ -17,9 +17,9 @@ An external cache becomes almost essential in CI/CD build environments. Such
environments usually have little-to-no persistence between runs, but it's still environments usually have little-to-no persistence between runs, but it's still
important to keep the runtime of image builds as low as possible. important to keep the runtime of image builds as low as possible.
The default `docker` driver supports the `inline` and `local` cache backends. The default `docker` driver supports the `inline`, `local`, `registry`, and
Other cache backends require you to select a different `gha` cache backends, but only if you have enabled the [containerd image store](/desktop/containerd.md).
[driver](../../drivers/index.md). Other cache backends require you to select a different [driver](../../drivers/_index.md).
> **Warning** > **Warning**
> >

View File

@ -39,7 +39,6 @@ The following table describes the available CSV parameters that you can pass to
| Name | Option | Type | Default | Description | | Name | Option | Type | Default | Description |
| ------------------- | ----------------------- | ----------------------- | ------- | -------------------------------------------------------------------- | | ------------------- | ----------------------- | ----------------------- | ------- | -------------------------------------------------------------------- |
| `ref` | `cache-to`,`cache-from` | String | | Full name of the cache image to import. | | `ref` | `cache-to`,`cache-from` | String | | Full name of the cache image to import. |
| `dest` | `cache-to` | String | | Path of the local directory where cache gets exported to. |
| `mode` | `cache-to` | `min`,`max` | `min` | Cache layers to export, see [cache mode][1]. | | `mode` | `cache-to` | `min`,`max` | `min` | Cache layers to export, see [cache mode][1]. |
| `oci-mediatypes` | `cache-to` | `true`,`false` | `true` | Use OCI media types in exported manifests, see [OCI media types][2]. | | `oci-mediatypes` | `cache-to` | `true`,`false` | `true` | Use OCI media types in exported manifests, see [OCI media types][2]. |
| `compression` | `cache-to` | `gzip`,`estargz`,`zstd` | `gzip` | Compression type, see [cache compression][3]. | | `compression` | `cache-to` | `gzip`,`estargz`,`zstd` | `gzip` | Compression type, see [cache compression][3]. |

View File

@ -27,11 +27,14 @@ The following table outlines some differences between drivers.
| Feature | `docker` | `docker-container` | `kubernetes` | `remote` | | Feature | `docker` | `docker-container` | `kubernetes` | `remote` |
| :--------------------------- | :---------: | :----------------: | :----------: | :----------------: | | :--------------------------- | :---------: | :----------------: | :----------: | :----------------: |
| **Automatically load image** | ✅ | | | | | **Automatically load image** | ✅ | | | |
| **Cache export** | Inline only | ✅ | ✅ | ✅ | | **Cache export** | ✓\* | ✅ | ✅ | ✅ |
| **Tarball output** | | ✅ | ✅ | ✅ | | **Tarball output** | | ✅ | ✅ | ✅ |
| **Multi-arch images** | | ✅ | ✅ | ✅ | | **Multi-arch images** | | ✅ | ✅ | ✅ |
| **BuildKit configuration** | | ✅ | ✅ | Managed externally | | **BuildKit configuration** | | ✅ | ✅ | Managed externally |
\* _The `docker` driver doesn't support all cache export options.
See [Cache storage backends](../cache/backends/_index.md) for more information._
## Loading to local image store ## Loading to local image store
Unlike when using the default `docker` driver, images built using other drivers Unlike when using the default `docker` driver, images built using other drivers