From 9e02f8fbde73a41a3727cc89e9a8a3b6e36d53e9 Mon Sep 17 00:00:00 2001 From: Salman Muin Kayser Chishti Date: Thu, 11 Dec 2025 21:03:28 +0000 Subject: [PATCH 1/4] Prepare v5.0.0 release - Bump package version to 5.0.0 - Add v5.0.0 release notes (Node.js 24 runtime + runner requirement) --- RELEASES.md | 7 +++++++ package-lock.json | 13 ++----------- package.json | 2 +- 3 files changed, 10 insertions(+), 12 deletions(-) diff --git a/RELEASES.md b/RELEASES.md index 079df26..c156522 100644 --- a/RELEASES.md +++ b/RELEASES.md @@ -1,5 +1,12 @@ # Releases +## Changelog + +### 5.0.0 + +- Updated to the Node.js 24 runtime. +- Requires minimum Actions Runner version v2.327.1. + ### 4.3.0 - Bump `@actions/cache` to [v4.1.0](https://github.com/actions/toolkit/pull/2132) diff --git a/package-lock.json b/package-lock.json index bbc4307..8c48ea1 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "cache", - "version": "4.3.0", + "version": "5.0.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "cache", - "version": "4.3.0", + "version": "5.0.0", "license": "MIT", "dependencies": { "@actions/cache": "^5.0.0", @@ -1762,7 +1762,6 @@ "integrity": "sha512-94EQTWZ40mzBc42ATNIBimBEDltSJ9RQHCC8vc/PDbxi4k8dVwUAv4o98dk50M1zB+JGFxp43FP7f8+FP8R6Sw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@eslint-community/regexpp": "^4.10.0", "@typescript-eslint/scope-manager": "7.18.0", @@ -1797,7 +1796,6 @@ "integrity": "sha512-4Z+L8I2OqhZV8qA132M4wNL30ypZGYOQVBfMgxDH/K5UX0PNqTu1c6za9ST5r9+tavvHiTWmBnKzpCJ/GlVFtg==", "dev": true, "license": "BSD-2-Clause", - "peer": true, "dependencies": { "@typescript-eslint/scope-manager": "7.18.0", "@typescript-eslint/types": "7.18.0", @@ -2027,7 +2025,6 @@ "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", "dev": true, "license": "MIT", - "peer": true, "bin": { "acorn": "bin/acorn" }, @@ -2480,7 +2477,6 @@ } ], "license": "MIT", - "peer": true, "dependencies": { "baseline-browser-mapping": "^2.9.0", "caniuse-lite": "^1.0.30001759", @@ -3185,7 +3181,6 @@ "deprecated": "This version is no longer supported. Please see https://eslint.org/version-support for other options.", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@eslint-community/eslint-utils": "^4.2.0", "@eslint-community/regexpp": "^4.6.1", @@ -3242,7 +3237,6 @@ "integrity": "sha512-iI1f+D2ViGn+uvv5HuHVUamg8ll4tN+JRHGc6IJi4TP9Kl976C57fzPXgseXNs8v0iA8aSJpHsTWjDb9QJamGQ==", "dev": true, "license": "MIT", - "peer": true, "bin": { "eslint-config-prettier": "bin/cli.js" }, @@ -4995,7 +4989,6 @@ "integrity": "sha512-NIy3oAFp9shda19hy4HK0HRTWKtPJmGdnvywu01nOqNC2vZg+Z+fvJDxpMQA88eb2I9EcafcdjYgsDthnYTvGw==", "dev": true, "license": "MIT", - "peer": true, "dependencies": { "@jest/core": "^29.7.0", "@jest/types": "^29.6.3", @@ -6354,7 +6347,6 @@ "integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==", "dev": true, "license": "MIT", - "peer": true, "bin": { "prettier": "bin/prettier.cjs" }, @@ -7472,7 +7464,6 @@ "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", "dev": true, "license": "Apache-2.0", - "peer": true, "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" diff --git a/package.json b/package.json index f56a529..c468614 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "cache", - "version": "4.3.0", + "version": "5.0.0", "private": true, "description": "Cache dependencies and build outputs", "main": "dist/restore/index.js", From 07629789a8e1387a1731ea6c0831e183ebb37e72 Mon Sep 17 00:00:00 2001 From: Salman Muin Kayser Chishti Date: Thu, 11 Dec 2025 21:08:31 +0000 Subject: [PATCH 2/4] docs: update README for v5 release with Node 24 and runner version requirements --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index 336cda6..63d5067 100644 --- a/README.md +++ b/README.md @@ -34,6 +34,11 @@ Upgrading to the recommended versions will not break your workflows. Read more about the change & access the migration guide: [reference to the announcement](https://github.com/actions/cache/discussions/1510). +### v5 + +* Updated to node 24 +* Requires a minimum Actions Runner version of `2.327.1` + ### v4 * Integrated with the new cache service (v2) APIs. @@ -69,6 +74,10 @@ Create a workflow `.yml` file in your repository's `.github/workflows` directory If you are using this inside a container, a POSIX-compliant `tar` needs to be included and accessible from the execution path. +> **Note** +> `actions/cache@v5` runs on Node.js 24 and requires a minimum Actions Runner version of `2.327.1`. +> If you are using self-hosted runners, ensure they are updated before upgrading. + If you are using a `self-hosted` Windows runner, `GNU tar` and `zstd` are required for [Cross-OS caching](https://github.com/actions/cache/blob/main/tips-and-workarounds.md#cross-os-cache) to work. They are also recommended to be installed in general so the performance is on par with `hosted` Windows runners. ### Inputs From 054c1f230199f21a083466e8e5abd99625506e8a Mon Sep 17 00:00:00 2001 From: Salman Muin Kayser Chishti Date: Thu, 11 Dec 2025 21:11:33 +0000 Subject: [PATCH 3/4] readme note --- README.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 63d5067..7e49684 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,10 @@ See ["Caching dependencies to speed up workflows"](https://docs.github.com/en/ac ### ⚠️ Important changes +> [!IMPORTANT] +> `actions/cache@v5` runs on the Node.js 24 runtime and requires a minimum Actions Runner version of `2.327.1`. +> If you are using self-hosted runners, ensure they are updated before upgrading. + The cache backend service has been rewritten from the ground up for improved performance and reliability. [actions/cache](https://github.com/actions/cache) 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 these releases are **fully backward compatible**. @@ -74,9 +78,7 @@ Create a workflow `.yml` file in your repository's `.github/workflows` directory If you are using this inside a container, a POSIX-compliant `tar` needs to be included and accessible from the execution path. -> **Note** -> `actions/cache@v5` runs on Node.js 24 and requires a minimum Actions Runner version of `2.327.1`. -> If you are using self-hosted runners, ensure they are updated before upgrading. +Note: `actions/cache@v5` runs on Node.js 24 and requires a minimum Actions Runner version of `2.327.1`. If you are using a `self-hosted` Windows runner, `GNU tar` and `zstd` are required for [Cross-OS caching](https://github.com/actions/cache/blob/main/tips-and-workarounds.md#cross-os-cache) to work. They are also recommended to be installed in general so the performance is on par with `hosted` Windows runners. From 3bb0d78750a39cefce0c2b5a0a9801052b4359ad Mon Sep 17 00:00:00 2001 From: Salman Muin Kayser Chishti Date: Thu, 11 Dec 2025 21:12:24 +0000 Subject: [PATCH 4/4] docs: highlight v5 runner requirement in releases --- RELEASES.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/RELEASES.md b/RELEASES.md index c156522..5e189d6 100644 --- a/RELEASES.md +++ b/RELEASES.md @@ -4,8 +4,9 @@ ### 5.0.0 -- Updated to the Node.js 24 runtime. -- Requires minimum Actions Runner version v2.327.1. +> [!IMPORTANT] +> `actions/cache@v5` runs on the Node.js 24 runtime and requires a minimum Actions Runner version of `2.327.1`. +> If you are using self-hosted runners, ensure they are updated before upgrading. ### 4.3.0