mirror of
https://github.com/actions/cache.git
synced 2026-06-06 09:04:21 +00:00
085b8e14fb
- Add to and inputs, making the absence-of-value behaviour explicit and consistent with all other optional inputs in the file. - Expand the output description to document all three observable states: 'true' on exact key match, 'false' on partial restore-key match or unavailable cache service, and not set when no cache entry is found (intentional; see actions/cache#1466). Co-authored-by: Kranthi Poturaju <152148+kranthipoturaju@users.noreply.github.com> Co-authored-by: Panuganti Saketh <sakethpanuganti@gmail.com>
48 lines
2.1 KiB
YAML
48 lines
2.1 KiB
YAML
name: 'Cache'
|
|
description: 'Cache artifacts like dependencies and build outputs to improve workflow execution time'
|
|
author: 'GitHub'
|
|
inputs:
|
|
path:
|
|
description: 'A list of files, directories, and wildcard patterns to cache and restore'
|
|
required: true
|
|
key:
|
|
description: 'An explicit key for restoring and saving the cache'
|
|
required: true
|
|
restore-keys:
|
|
description: 'An ordered multiline string listing the prefix-matched keys, that are used for restoring stale cache if no cache hit occurred for key. Note `cache-hit` returns false in this case.'
|
|
required: false
|
|
default: ''
|
|
upload-chunk-size:
|
|
description: 'The chunk size used to split up large files during upload, in bytes'
|
|
required: false
|
|
enableCrossOsArchive:
|
|
description: 'An optional boolean when enabled, allows windows runners to save or restore caches that can be restored or saved respectively on other platforms'
|
|
default: 'false'
|
|
required: false
|
|
fail-on-cache-miss:
|
|
description: 'Fail the workflow if cache entry is not found'
|
|
default: 'false'
|
|
required: false
|
|
lookup-only:
|
|
description: 'Check if a cache entry exists for the given input(s) (key, restore-keys) without downloading the cache'
|
|
default: 'false'
|
|
required: false
|
|
save-always:
|
|
description: 'Run the post step to save the cache even if another step before fails'
|
|
default: 'false'
|
|
required: false
|
|
deprecationMessage: |
|
|
save-always does not work as intended and will be removed in a future release.
|
|
A separate `actions/cache/restore` step should be used instead.
|
|
See https://github.com/actions/cache/tree/main/save#always-save-cache for more details.
|
|
outputs:
|
|
cache-hit:
|
|
description: "A boolean value to indicate an exact match was found for the primary key. Returns 'true' on exact key match, 'false' on partial match via restore-keys or when the cache service is unavailable. Not set when no cache entry is found."
|
|
runs:
|
|
using: 'node24'
|
|
main: 'dist/restore/index.js'
|
|
post: 'dist/save/index.js'
|
|
post-if: "success()"
|
|
branding:
|
|
icon: 'archive'
|
|
color: 'gray-dark'
|