mirror of
https://github.com/julia-actions/cache.git
synced 2026-02-13 01:46:52 +08:00
Compare commits
20 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
227b3767fc | ||
|
|
9a3120aab8 | ||
|
|
43522e389d | ||
|
|
e8472695fb | ||
|
|
2061bcf01c | ||
|
|
c4f371876b | ||
|
|
38850d7b75 | ||
|
|
429bb24537 | ||
|
|
8af8844cd0 | ||
|
|
424a20aa56 | ||
|
|
5dc38e58e3 | ||
|
|
05a577a682 | ||
|
|
8205b4547a | ||
|
|
509404de2a | ||
|
|
79b42d2cc0 | ||
|
|
2d7a7cc445 | ||
|
|
46d70a0fdf | ||
|
|
5aaa1e085e | ||
|
|
2c5c26f9c8 | ||
|
|
d9e495f279 |
12
.github/workflows/CI.yml
vendored
12
.github/workflows/CI.yml
vendored
@@ -59,7 +59,7 @@ jobs:
|
||||
env:
|
||||
JULIA_DEPOT_PATH: /tmp/julia-depot
|
||||
steps:
|
||||
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
- name: Set cache-name
|
||||
id: cache-name
|
||||
shell: bash
|
||||
@@ -117,7 +117,7 @@ jobs:
|
||||
env:
|
||||
JULIA_DEPOT_PATH: /tmp/julia-depot
|
||||
steps:
|
||||
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
- uses: julia-actions/setup-julia@v2
|
||||
with:
|
||||
version: ${{ matrix.version }}
|
||||
@@ -161,7 +161,7 @@ jobs:
|
||||
outputs:
|
||||
cache-name: ${{ steps.cache-name.outputs.cache-name }}
|
||||
steps:
|
||||
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
- name: Set cache-name
|
||||
id: cache-name
|
||||
run: |
|
||||
@@ -193,7 +193,7 @@ jobs:
|
||||
needs: test-save-nomatrix
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
- name: Restore cache
|
||||
id: cache
|
||||
uses: ./
|
||||
@@ -233,7 +233,7 @@ jobs:
|
||||
outputs:
|
||||
cache-name: ${{ steps.cache-name.outputs.cache-name }}
|
||||
steps:
|
||||
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
- name: Set cache-name
|
||||
id: cache-name
|
||||
run: |
|
||||
@@ -259,7 +259,7 @@ jobs:
|
||||
needs: test-save-cloned-registry
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
|
||||
- uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
|
||||
- name: Add General registry clone
|
||||
shell: julia --color=yes {0}
|
||||
run: |
|
||||
|
||||
39
README.md
39
README.md
@@ -20,7 +20,7 @@ jobs:
|
||||
test:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/checkout@v6
|
||||
- uses: julia-actions/setup-julia@v2
|
||||
- uses: julia-actions/cache@v2
|
||||
- uses: julia-actions/julia-buildpkg@v1
|
||||
@@ -51,6 +51,8 @@ By default all depot directories called out below are cached.
|
||||
### Outputs
|
||||
|
||||
- `cache-hit` - A boolean value to indicate an exact match was found for the primary key. Returns \"\" when the key is new. Forwarded from actions/cache.
|
||||
- `cache-paths` - A list of paths (as a newline-separated string) that were cached.
|
||||
- `cache-key` - The cache key that was used for this run.
|
||||
|
||||
## How It Works
|
||||
|
||||
@@ -64,8 +66,8 @@ By default, this action removes caches that were previously made by jobs on the
|
||||
GitHub automatically removes old caches after a certain period or when the repository cache allocation is full.
|
||||
It is, however, more efficient to explicitly remove old caches to improve caching for less frequently run jobs.
|
||||
|
||||
For more information about Github caching generically, for example how to manually delete caches, see
|
||||
[this Github documentation page](https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/caching-dependencies-to-speed-up-workflows#managing-caches).
|
||||
For more information about GitHub caching generically, for example how to manually delete caches, see
|
||||
[this GitHub documentation page](https://docs.github.com/en/actions/writing-workflows/choosing-what-your-workflow-does/caching-dependencies-to-speed-up-workflows#managing-caches).
|
||||
|
||||
### Cache keys
|
||||
|
||||
@@ -77,7 +79,7 @@ The cache key that the cache will be saved as is based on:
|
||||
- The run attempt number
|
||||
|
||||
> [!NOTE]
|
||||
> If there is job concurrency that is not fully defined by a matrix you should ensure that `cache-name` is
|
||||
> If there is job concurrency that is not fully defined by a matrix you should ensure that `cache-name` is
|
||||
> unique for each concurrent job, otherwise caching may not be effective.
|
||||
|
||||
### Cache Retention
|
||||
@@ -104,6 +106,35 @@ Which means your caches files will not grow needlessly. GitHub also deletes cach
|
||||
|
||||
To disable deletion set input `delete-old-caches: 'false'`.
|
||||
|
||||
### Caching even if an intermediate job fails
|
||||
|
||||
Just like [the basic actions/cache workflow](https://github.com/actions/cache), this action has a cache restore step, and also a save step which runs after the workflow completes.
|
||||
By default, if any job in the workflow fails, the entire workflow will be stopped, and the cache will not be saved.
|
||||
|
||||
Due to current limitations in GitHub Actions syntax, there is no built-in option for this action to save the cache even if the job fails.
|
||||
However, it does output information which you can feed into `actions/cache` yourself to achieve the same effect.
|
||||
For example, this workflow will ensure that the cache is saved if a step fails (but skipping it if the cache was hit, i.e. there's no need to cache it again).
|
||||
|
||||
```yaml
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
- name: Load Julia packages from cache
|
||||
id: julia-cache
|
||||
uses: julia-actions/cache@v2
|
||||
|
||||
# do whatever you want here (that might fail)
|
||||
|
||||
- name: Save Julia depot cache on cancel or failure
|
||||
id: julia-cache-save
|
||||
if: cancelled() || failure()
|
||||
uses: actions/cache/save@v4
|
||||
with:
|
||||
path: |
|
||||
${{ steps.julia-cache.outputs.cache-paths }}
|
||||
key: ${{ steps.julia-cache.outputs.cache-key }}
|
||||
```
|
||||
|
||||
### Cache Garbage Collection
|
||||
|
||||
Caches are restored and re-saved after every run, retaining the state of the depot throughout runs.
|
||||
|
||||
@@ -58,7 +58,7 @@ runs:
|
||||
using: 'composite'
|
||||
steps:
|
||||
- name: Install jq
|
||||
uses: dcarbone/install-jq-action@f0e10f46ff84f4d32178b4b76e1ef180b16f82c3 # v3.1.1
|
||||
uses: dcarbone/install-jq-action@b7ef57d46ece78760b4019dbc4080a1ba2a40b45 # v3.2.0
|
||||
with:
|
||||
force: false # Skip install when an existing `jq` is present
|
||||
|
||||
@@ -127,7 +127,7 @@ runs:
|
||||
env:
|
||||
MATRIX_JSON: ${{ toJSON(matrix) }}
|
||||
|
||||
- uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
|
||||
- uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v5.0.3
|
||||
id: cache
|
||||
with:
|
||||
path: |
|
||||
@@ -178,7 +178,7 @@ runs:
|
||||
# - https://docs.github.com/en/actions/using-workflows/caching-dependencies-to-speed-up-workflows#usage-limits-and-eviction-policy
|
||||
|
||||
# Not windows
|
||||
- uses: pyTooling/Actions/with-post-step@42e17fae05f224e5ac3d79d021a4e3577878efe5 # v4.2.2
|
||||
- uses: pyTooling/Actions/with-post-step@370c306306304663febee1525552a09e061588fa # v7.4.2
|
||||
if: ${{ inputs.delete-old-caches != 'false' &&
|
||||
github.ref != format('refs/heads/{0}', github.event.repository.default_branch) &&
|
||||
runner.OS != 'Windows' }}
|
||||
@@ -191,7 +191,7 @@ runs:
|
||||
GH_TOKEN: ${{ inputs.token }}
|
||||
|
||||
# Windows (because this action uses command prompt on windows)
|
||||
- uses: pyTooling/Actions/with-post-step@42e17fae05f224e5ac3d79d021a4e3577878efe5 # v4.2.2
|
||||
- uses: pyTooling/Actions/with-post-step@370c306306304663febee1525552a09e061588fa # v7.4.2
|
||||
if: ${{ inputs.delete-old-caches != 'false' &&
|
||||
github.ref != format('refs/heads/{0}', github.event.repository.default_branch) &&
|
||||
runner.OS == 'Windows' }}
|
||||
|
||||
Reference in New Issue
Block a user