2020-05-06 15:10:18 +00:00
# @actions/cache Releases
2024-12-03 10:40:00 +00:00
### 4.0.0
#### Important changes
2024-12-04 13:33:47 +00:00
The cache backend service has been rewritten from the ground up for improved performance and reliability. The [@actions/cache ](https://github.com/actions/toolkit/tree/main/packages/cache ) package now integrates with the new cache service (v2) APIs.
The new service will gradually roll out as of **February 1st, 2025** . The legacy service will also be sunset on the same date. Changes in this release are **fully backward compatible** .
**All previous versions of this package will be deprecated**. We recommend upgrading to version `4.0.0` as soon as possible before **February 1st, 2025.**
If you do not upgrade, all workflow runs using any of the deprecated [@actions/cache ](https://github.com/actions/toolkit/tree/main/packages/cache ) packages will fail.
Upgrading to the recommended version should not break or require any changes to your workflows beyond updating your `package.json` to version `4.0.0` .
Read more about change & access the migration guide: [reference to the announcement ](TBD ).
2024-12-03 10:40:00 +00:00
#### Minor changes
- Update `@actions/core` to `1.11.0`
- Update `semver` `6.3.1`
- Add `twirp-ts` `2.5.0` to dependencies
2024-11-01 17:32:42 +00:00
### 3.3.0
2024-12-03 10:40:00 +00:00
2024-11-01 17:32:42 +00:00
- Update `@actions/core` to `1.11.1`
2024-10-22 16:01:31 +00:00
- Remove dependency on `uuid` package [#1824 ](https://github.com/actions/toolkit/pull/1824 ), [#1842 ](https://github.com/actions/toolkit/pull/1842 )
2024-02-29 15:40:22 +00:00
### 3.2.4
2020-07-10 15:09:32 +00:00
2024-02-29 15:40:22 +00:00
- Updated `isGhes` check to include `.ghe.com` and `.ghe.localhost` as accepted hosts
2024-10-22 16:01:31 +00:00
2024-02-29 15:40:22 +00:00
### 3.2.3
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fixed a bug that mutated path arguments to `getCacheVersion` [#1378 ](https://github.com/actions/toolkit/pull/1378 )
2020-07-20 20:19:26 +00:00
2024-02-29 15:40:22 +00:00
### 3.2.2
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Add new default cache download method to improve performance and reduce hangs [#1484 ](https://github.com/actions/toolkit/pull/1484 )
2020-08-05 15:17:23 +00:00
2024-02-29 15:40:22 +00:00
### 3.2.1
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Updated @azure/storage -blob to `v12.13.0`
2020-10-12 18:47:24 +00:00
2024-02-29 15:40:22 +00:00
### 3.2.0
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Add `lookupOnly` to cache restore `DownloadOptions` .
2020-11-03 19:12:34 +00:00
2024-02-29 15:40:22 +00:00
### 3.1.4
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fix zstd not being used due to `zstd --version` output change in zstd 1.5.4 release. See [#1353 ](https://github.com/actions/toolkit/pull/1353 ).
2020-12-10 15:59:04 +00:00
2024-02-29 15:40:22 +00:00
### 3.1.3
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fix to prevent from setting MYSYS environement variable globally [#1329 ](https://github.com/actions/toolkit/pull/1329 ).
2021-02-02 19:48:46 +00:00
2024-02-29 15:40:22 +00:00
### 3.1.2
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fix issue with symlink restoration on windows.
2021-04-09 19:23:05 +00:00
2024-02-29 15:40:22 +00:00
### 3.1.1
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Reverted changes in 3.1.0 to fix issue with symlink restoration on windows.
- Added support for verbose logging about cache version during cache miss.
2021-11-19 11:04:33 +00:00
2024-02-29 15:40:22 +00:00
### 3.1.0
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Update actions/cache on windows to use gnu tar and zstd by default
- Update actions/cache on windows to fallback to bsdtar and zstd if gnu tar is not available.
- Added support for fallback to gzip to restore old caches on windows.
2022-02-04 08:41:29 +00:00
2024-02-29 15:40:22 +00:00
### 3.1.0-beta.3
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Bug Fixes for fallback to gzip to restore old caches on windows and bsdtar if gnutar is not available.
2022-03-16 18:25:03 +00:00
2024-02-29 15:40:22 +00:00
### 3.1.0-beta.2
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Added support for fallback to gzip to restore old caches on windows.
2022-03-24 11:19:52 +00:00
2024-02-29 15:40:22 +00:00
### 3.0.6
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Added `@azure/abort-controller` to dependencies to fix compatibility issue with ESM [#1208 ](https://github.com/actions/toolkit/issues/1208 )
2022-03-25 09:10:02 +00:00
2024-02-29 15:40:22 +00:00
### 3.0.5
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Update `@actions/cache` to use `@actions/core@^1.10.0`
2022-05-11 21:14:25 +00:00
2024-02-29 15:40:22 +00:00
### 3.0.4
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fix zstd not working for windows on gnu tar in issues [#888 ](https://github.com/actions/cache/issues/888 ) and [#891 ](https://github.com/actions/cache/issues/891 ).
- Allowing users to provide a custom timeout as input for aborting download of a cache segment using an environment variable `SEGMENT_DOWNLOAD_TIMEOUT_MINS` . Default is 60 minutes.
2022-05-13 15:12:58 +00:00
2024-02-29 15:40:22 +00:00
### 3.0.3
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Bug fixes for download stuck issue [#810 ](https://github.com/actions/cache/issues/810 ).
2022-05-24 06:55:11 +00:00
2024-02-29 15:40:22 +00:00
### 3.0.2
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Added 1 hour timeout for the download stuck issue [#810 ](https://github.com/actions/cache/issues/810 ).
2022-06-06 08:03:56 +00:00
2024-02-29 15:40:22 +00:00
### 3.0.1
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fix [#833 ](https://github.com/actions/cache/issues/833 ) - cache doesn't work with github workspace directory.
- Fix [#809 ](https://github.com/actions/cache/issues/809 ) `zstd -d: no such file or directory` error on AWS self-hosted runners.
2022-06-24 09:48:30 +00:00
### 3.0.0
2023-03-06 11:56:51 +00:00
2022-08-03 07:00:38 +00:00
- Updated actions/cache to suppress Actions cache server error and log warning for those error [#1122 ](https://github.com/actions/toolkit/pull/1122 )
2024-02-29 15:40:22 +00:00
### 2.0.6
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fix `Tar failed with error: The process '/usr/bin/tar' failed with exit code 1` issue when temp directory where tar is getting created is actually the subdirectory of the path mentioned by the user for caching. ([issue](https://github.com/actions/cache/issues/689))
2022-08-05 07:20:59 +00:00
2024-02-29 15:40:22 +00:00
### 2.0.5
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fix to avoid saving empty cache when no files are available for caching. ([issue](https://github.com/actions/cache/issues/624))
2022-08-11 07:13:04 +00:00
2024-02-29 15:40:22 +00:00
### 2.0.4
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Update to v2.0.1 of `@actions/http-client` [#1087 ](https://github.com/actions/toolkit/pull/1087 )
2022-08-13 18:46:24 +00:00
2024-02-29 15:40:22 +00:00
### 2.0.3
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Update to v2.0.0 of `@actions/http-client`
2022-10-13 09:36:33 +00:00
2024-02-29 15:40:22 +00:00
### 2.0.0
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Added support to check if Actions cache service feature is available or not [#1028 ](https://github.com/actions/toolkit/pull/1028 )
2022-10-18 17:44:31 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.11
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fix file downloads > 2GB([issue](https://github.com/actions/cache/issues/773))
2023-01-04 06:46:25 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.10
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Update `lockfileVersion` to `v2` in `package-lock.json [#1022 ](https://github.com/actions/toolkit/pull/1022 )
2023-01-04 06:46:25 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.9
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Use @azure/ms -rest-js v2.6.0
- Use @azure/storage -blob v12.8.0
2023-01-04 06:46:25 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.8
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Increase the allowed artifact cache size from 5GB to 10GB ([issue](https://github.com/actions/cache/discussions/497))
2023-01-04 06:46:25 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.7
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fixes permissions issue extracting archives with GNU tar on macOS ([issue](https://github.com/actions/cache/issues/527))
2023-01-04 06:46:25 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.6
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Make caching more verbose [#650 ](https://github.com/actions/toolkit/pull/650 )
- Use GNU tar on macOS if available [#701 ](https://github.com/actions/toolkit/pull/701 )
2023-01-04 06:46:25 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.5
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fix to ensure Windows cache paths get resolved correctly
2023-02-09 11:51:19 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.4
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Use @actions/core v1.2.6
- Fixes uploadChunk to throw an error if any unsuccessful response code is received
2023-02-20 18:38:47 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.3
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Use http-client v1.0.9
- Fixes error handling so retries are not attempted on non-retryable errors (409 Conflict, for example)
- Adds 5 second delay between retry attempts
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.2
2023-03-08 19:03:52 +00:00
2024-02-29 15:40:22 +00:00
- Use posix archive format to add support for some tools
2023-03-08 19:03:52 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.1
2023-03-06 11:56:51 +00:00
2024-02-29 15:40:22 +00:00
- Fix bug in downloading large files (> 2 GBs) with the Azure SDK
2023-08-07 17:25:56 +00:00
2024-02-29 15:40:22 +00:00
### 1.0.0
2023-08-07 17:25:56 +00:00
2024-02-29 15:40:22 +00:00
- Downloads Azure-hosted caches using the Azure SDK for speed and reliability
- Displays download progress
- Includes changes that break compatibility with earlier versions, including:
- `retry` , `retryTypedResponse` , and `retryHttpClientResponse` moved from `cacheHttpClient` to `requestUtils`
2024-01-10 22:32:52 +00:00
2024-02-29 15:40:22 +00:00
### 0.2.1
2024-01-10 22:32:52 +00:00
2024-02-29 15:40:22 +00:00
- Fix to await async function getCompressionMethod
### 0.2.0
2024-01-31 21:19:20 +00:00
2024-02-29 15:40:22 +00:00
- Fixes issues with the zstd compression algorithm on Windows and Ubuntu 16.04 [#469 ](https://github.com/actions/toolkit/pull/469 )
### 0.1.0
2024-01-31 21:19:20 +00:00
2024-02-29 15:40:22 +00:00
- Initial release