2020-02-05 16:39:52 +01:00
name : 'Cache'
2020-01-14 16:11:41 +01:00
description : 'Cache artifacts like dependencies and build outputs to improve workflow execution time'
2019-10-30 19:48:49 +01:00
author : 'GitHub'
inputs :
path :
2020-05-26 20:58:07 +02:00
description : 'A list of files, directories, and wildcard patterns to cache and restore'
2019-10-30 19:48:49 +01:00
required : true
key :
description : 'An explicit key for restoring and saving the cache'
required : true
restore-keys :
2021-03-26 00:36:55 +01:00
description : 'An ordered list of keys to use for restoring stale cache if no cache hit occurred for key. Note `cache-hit` returns false in this case.'
2019-10-30 19:48:49 +01:00
required : false
2020-10-02 18:01:24 +02:00
upload-chunk-size :
2020-10-02 18:22:20 +02:00
description : 'The chunk size used to split up large files during upload, in bytes'
2020-10-02 18:01:24 +02:00
required : false
2023-01-05 12:19:13 +01:00
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
2023-01-30 12:10:58 +01:00
fail-on-cache-miss :
description : 'Fail the workflow if cache entry is not found'
default : 'false'
required : false
2023-03-09 13:30:28 +01:00
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
2023-09-13 13:58:52 +02:00
save-always :
description : 'Run the post step to save the cache even if another step before fails'
default : 'false'
required : false
2019-10-30 19:48:49 +01:00
outputs :
cache-hit :
description : 'A boolean value to indicate an exact match was found for the primary key'
2024-02-09 02:07:45 +01:00
save-always-d18d746b9 :
description : "Run the post step to save the cache even if another step before fails"
2019-10-30 19:48:49 +01:00
runs :
2023-11-20 14:30:40 +01:00
using : 'node20'
2019-10-30 19:48:49 +01:00
main : 'dist/restore/index.js'
post : 'dist/save/index.js'
2024-02-09 02:07:45 +01:00
post-if : "success() || (contains(steps.*.outputs.save-always-d18d746b9, 'true') && !contains(steps.*.outputs.save-always-d18d746b9, 'false'))"
2019-10-30 19:48:49 +01:00
branding :
icon : 'archive'
2020-01-14 16:11:41 +01:00
color : 'gray-dark'