2019-10-31 23:36:50 +08:00
# Examples
2020-02-27 06:43:11 +08:00
- [Examples ](#examples )
- [C# - NuGet ](#c---nuget )
2020-05-11 22:24:05 +08:00
- [D - DUB ](#d---dub )
2020-02-27 06:43:11 +08:00
- [Elixir - Mix ](#elixir---mix )
- [Go - Modules ](#go---modules )
- [Haskell - Cabal ](#haskell---cabal )
- [Java - Gradle ](#java---gradle )
- [Java - Maven ](#java---maven )
- [Node - npm ](#node---npm )
- [macOS and Ubuntu ](#macos-and-ubuntu )
- [Windows ](#windows )
- [Using multiple systems and `npm config` ](#using-multiple-systems-and-npm-config )
2020-03-21 04:02:11 +08:00
- [Node - Lerna ](#node---lerna )
2020-04-02 22:35:07 +08:00
- [Node - Yarn ](#node---yarn )
2020-07-02 21:43:52 +08:00
- [Node - Yarn 2 ](#node---yarn-2 )
2020-02-27 06:43:11 +08:00
- [OCaml/Reason - esy ](#ocamlreason---esy )
- [PHP - Composer ](#php---composer )
- [Python - pip ](#python---pip )
- [Simple example ](#simple-example )
- [Multiple OS's in a workflow ](#multiple-oss-in-a-workflow )
2020-04-30 02:58:19 +08:00
- [Using pip to get cache location ](#using-pip-to-get-cache-location )
2020-02-27 06:43:11 +08:00
- [Using a script to get cache location ](#using-a-script-to-get-cache-location )
- [R - renv ](#r---renv )
- [Simple example ](#simple-example-1 )
- [Multiple OS's in a workflow ](#multiple-oss-in-a-workflow-1 )
- [Ruby - Bundler ](#ruby---bundler )
- [Rust - Cargo ](#rust---cargo )
- [Scala - SBT ](#scala---sbt )
- [Swift, Objective-C - Carthage ](#swift-objective-c---carthage )
- [Swift, Objective-C - CocoaPods ](#swift-objective-c---cocoapods )
- [Swift - Swift Package Manager ](#swift---swift-package-manager )
2020-07-19 18:52:18 +08:00
- [Swift - Mint ](#swift---mint )
2019-10-31 23:36:50 +08:00
2019-12-10 08:21:47 +08:00
## C# - NuGet
2019-11-06 01:04:07 +08:00
Using [NuGet lock files ](https://docs.microsoft.com/nuget/consume-packages/package-references-in-project-files#locking-dependencies ):
2019-10-31 23:36:50 +08:00
2019-12-13 09:03:43 +08:00
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-12-13 09:03:43 +08:00
with:
path: ~/.nuget/packages
key: ${{ runner.os }}-nuget-${{ hashFiles('**/packages.lock.json') }}
restore-keys: |
${{ runner.os }}-nuget-
```
Depending on the environment, huge packages might be pre-installed in the global cache folder.
2020-07-15 22:36:12 +08:00
With `actions/cache@v2` you can now exclude unwanted packages with [exclude pattern ](https://github.com/actions/toolkit/tree/main/packages/glob#exclude-patterns )
2020-05-27 02:58:07 +08:00
```yaml
- uses: actions/cache@v2
with:
path: |
~/.nuget/packages
!~/.nuget/packages/unwanted
key: ${{ runner.os }}-nuget-${{ hashFiles('**/packages.lock.json') }}
restore-keys: |
${{ runner.os }}-nuget-
```
Or you could move the cache folder like below.
2019-12-16 08:45:29 +08:00
>Note: This workflow does not work for projects that require files to be placed in user profile package folder
2019-10-31 23:36:50 +08:00
```yaml
2019-12-10 08:21:47 +08:00
env:
NUGET_PACKAGES: ${{ github.workspace }}/.nuget/packages
steps:
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-12-10 08:21:47 +08:00
with:
path: ${{ github.workspace }}/.nuget/packages
key: ${{ runner.os }}-nuget-${{ hashFiles('**/packages.lock.json') }}
restore-keys: |
${{ runner.os }}-nuget-
2019-10-31 23:36:50 +08:00
```
2020-05-11 22:24:05 +08:00
## D - DUB
### POSIX
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2020-05-11 22:24:05 +08:00
with:
path: ~/.dub
key: ${{ runner.os }}-dub-${{ hashFiles('**/dub.json') }}
restore-keys: |
${{ runner.os }}-dub-
```
### Windows
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2020-05-11 22:24:05 +08:00
with:
path: ~\AppData\Local\dub
key: ${{ runner.os }}-dub-${{ hashFiles('**/dub.json') }}
restore-keys: |
${{ runner.os }}-dub-
```
2019-11-06 01:04:07 +08:00
## Elixir - Mix
2019-10-31 23:36:50 +08:00
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-10-31 23:36:50 +08:00
with:
2019-11-06 01:04:07 +08:00
path: deps
key: ${{ runner.os }}-mix-${{ hashFiles(format('{0}{1}', github.workspace, '/mix.lock')) }}
2019-10-31 23:36:50 +08:00
restore-keys: |
2019-11-06 01:04:07 +08:00
${{ runner.os }}-mix-
2019-10-31 23:36:50 +08:00
```
2019-11-06 01:04:07 +08:00
## Go - Modules
2019-11-06 00:03:56 +08:00
2019-10-31 23:36:50 +08:00
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-10-31 23:36:50 +08:00
with:
2019-11-06 01:04:07 +08:00
path: ~/go/pkg/mod
key: ${{ runner.os }}-go-${{ hashFiles('**/go.sum') }}
2019-10-31 23:36:50 +08:00
restore-keys: |
2019-11-06 01:04:07 +08:00
${{ runner.os }}-go-
2019-10-31 23:36:50 +08:00
```
2020-01-11 06:07:52 +08:00
## Haskell - Cabal
We cache the elements of the Cabal store separately, as the entirety of `~/.cabal` can grow very large for projects with many dependencies.
```yaml
2020-06-19 01:37:50 +08:00
- name: Cache ~/.cabal/packages, ~/.cabal/store and dist-newstyle
uses: actions/cache@v2
2020-01-11 06:07:52 +08:00
with:
2020-05-27 00:45:38 +08:00
path: |
~/.cabal/packages
~/.cabal/store
dist-newstyle
key: ${{ runner.os }}-${{ matrix.ghc }}
2020-01-11 06:07:52 +08:00
```
2019-10-31 23:36:50 +08:00
## Java - Gradle
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-10-31 23:36:50 +08:00
with:
2020-07-01 16:30:03 +08:00
path: |
~/.gradle/caches
~/.gradle/wrapper
2020-03-18 21:40:55 +08:00
key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*') }}
2019-10-31 23:36:50 +08:00
restore-keys: |
${{ runner.os }}-gradle-
```
## Java - Maven
```yaml
2020-06-19 01:37:50 +08:00
- name: Cache local Maven repository
uses: actions/cache@v2
2019-10-31 23:36:50 +08:00
with:
path: ~/.m2/repository
key: ${{ runner.os }}-maven-${{ hashFiles('**/pom.xml') }}
restore-keys: |
2019-11-01 03:08:09 +08:00
${{ runner.os }}-maven-
2019-10-31 23:36:50 +08:00
```
2019-11-06 01:04:07 +08:00
## Node - npm
2019-10-31 23:36:50 +08:00
2019-11-08 10:04:46 +08:00
For npm, cache files are stored in `~/.npm` on Posix, or `%AppData%/npm-cache` on Windows. See https://docs.npmjs.com/cli/cache#cache
2020-06-16 03:55:57 +08:00
If using `npm config` to retrieve the cache directory, ensure you run [actions/setup-node ](https://github.com/actions/setup-node ) first to ensure your `npm` version is correct.
2019-11-08 10:04:46 +08:00
>Note: It is not recommended to cache `node_modules` , as it can break across Node versions and won't work with `npm ci`
### macOS and Ubuntu
2019-10-31 23:36:50 +08:00
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-06 00:03:56 +08:00
with:
2019-11-08 10:04:46 +08:00
path: ~/.npm
key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
restore-keys: |
${{ runner.os }}-node-
```
### Windows
```yaml
2020-03-19 10:05:56 +08:00
- name: Get npm cache directory
id: npm-cache
run: |
echo "::set-output name=dir::$(npm config get cache)"
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-08 10:04:46 +08:00
with:
2020-03-19 10:05:56 +08:00
path: ${{ steps.npm-cache.outputs.dir }}
key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
2019-11-08 10:04:46 +08:00
restore-keys: |
${{ runner.os }}-node-
```
### Using multiple systems and `npm config`
2020-02-14 22:50:11 +08:00
```yaml
2019-11-08 10:04:46 +08:00
- name: Get npm cache directory
id: npm-cache
run: |
echo "::set-output name=dir::$(npm config get cache)"
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-08 10:04:46 +08:00
with:
path: ${{ steps.npm-cache.outputs.dir }}
2019-11-06 01:04:07 +08:00
key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
2019-11-06 00:03:56 +08:00
restore-keys: |
2019-11-06 01:04:07 +08:00
${{ runner.os }}-node-
2019-10-31 23:36:50 +08:00
```
2020-04-02 22:35:07 +08:00
## Node - Lerna
```yaml
- name: restore lerna
2020-05-27 00:45:38 +08:00
uses: actions/cache@v2
2020-04-02 22:35:07 +08:00
with:
path: |
node_modules
*/* /node_modules
key: ${{ runner.os }}-${{ hashFiles('**/yarn.lock') }}
```
2019-11-06 01:04:07 +08:00
## Node - Yarn
2019-11-13 23:18:47 +08:00
The yarn cache directory will depend on your operating system and version of `yarn` . See https://yarnpkg.com/lang/en/docs/cli/cache/ for more info.
2019-10-31 23:36:50 +08:00
```yaml
2020-02-14 22:50:11 +08:00
- name: Get yarn cache directory path
id: yarn-cache-dir-path
2019-11-13 23:18:47 +08:00
run: echo "::set-output name=dir::$(yarn cache dir)"
2020-07-02 21:43:52 +08:00
- uses: actions/cache@v2
id: yarn-cache # use this to check for `cache-hit` (`steps.yarn-cache.outputs.cache-hit != 'true'`)
with:
path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
restore-keys: |
${{ runner.os }}-yarn-
```
## Node - Yarn 2
The yarn 2 cache directory will depend on your config. See https://yarnpkg.com/configuration/yarnrc#cacheFolder for more info.
```yaml
- name: Get yarn cache directory path
id: yarn-cache-dir-path
run: echo "::set-output name=dir::$(yarn config get cacheFolder)"
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2020-02-14 22:50:11 +08:00
id: yarn-cache # use this to check for `cache-hit` (`steps.yarn-cache.outputs.cache-hit != 'true'`)
2019-10-31 23:36:50 +08:00
with:
2020-02-14 22:50:11 +08:00
path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
2019-11-13 23:18:47 +08:00
key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
2019-10-31 23:36:50 +08:00
restore-keys: |
2019-11-06 01:04:07 +08:00
${{ runner.os }}-yarn-
2019-10-31 23:36:50 +08:00
```
2020-02-27 06:43:11 +08:00
## OCaml/Reason - esy
Esy allows you to export built dependencies and import pre-built dependencies.
```yaml
- name: Restore Cache
id: restore-cache
2020-05-27 00:45:38 +08:00
uses: actions/cache@v2
2020-02-27 06:43:11 +08:00
with:
path: _export
key: ${{ runner.os }}-esy-${{ hashFiles('esy.lock/index.json') }}
restore-keys: |
${{ runner.os }}-esy-
- name: Esy install
run: 'esy install'
- name: Import Cache
run: |
esy import-dependencies _export
rm -rf _export
...(Build job)...
# Re-export dependencies if anything has changed or if it is the first time
- name: Setting dependency cache
run: |
esy export-dependencies
if: steps.restore-cache.outputs.cache-hit != 'true'
```
2020-02-14 22:50:11 +08:00
2019-11-06 05:18:49 +08:00
## PHP - Composer
2020-02-14 22:50:11 +08:00
```yaml
2019-11-06 05:18:49 +08:00
- name: Get Composer Cache Directory
id: composer-cache
run: |
echo "::set-output name=dir::$(composer config cache-files-dir)"
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-06 05:18:49 +08:00
with:
path: ${{ steps.composer-cache.outputs.dir }}
key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
restore-keys: |
${{ runner.os }}-composer-
```
2019-11-13 23:55:05 +08:00
## Python - pip
For pip, the cache directory will vary by OS. See https://pip.pypa.io/en/stable/reference/pip_install/#caching
Locations:
- Ubuntu: `~/.cache/pip`
- Windows: `~\AppData\Local\pip\Cache`
- macOS: `~/Library/Caches/pip`
### Simple example
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-13 23:55:05 +08:00
with:
path: ~/.cache/pip
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
restore-keys: |
${{ runner.os }}-pip-
```
Replace `~/.cache/pip` with the correct `path` if not using Ubuntu.
### Multiple OS's in a workflow
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-13 23:55:05 +08:00
if: startsWith(runner.os, 'Linux')
with:
path: ~/.cache/pip
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
restore-keys: |
${{ runner.os }}-pip-
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-13 23:55:05 +08:00
if: startsWith(runner.os, 'macOS')
with:
path: ~/Library/Caches/pip
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
restore-keys: |
${{ runner.os }}-pip-
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-13 23:55:05 +08:00
if: startsWith(runner.os, 'Windows')
with:
path: ~\AppData\Local\pip\Cache
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
restore-keys: |
${{ runner.os }}-pip-
```
2020-04-30 02:58:19 +08:00
### Using pip to get cache location
> Note: This requires pip 20.1+
```yaml
- name: Get pip cache dir
id: pip-cache
run: |
echo "::set-output name=dir::$(pip cache dir)"
- name: pip cache
2020-05-27 00:45:38 +08:00
uses: actions/cache@v2
2020-04-30 02:58:19 +08:00
with:
path: ${{ steps.pip-cache.outputs.dir }}
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
restore-keys: |
${{ runner.os }}-pip-
```
2019-11-13 23:55:05 +08:00
### Using a script to get cache location
> Note: This uses an internal pip API and may not always work
```yaml
2020-04-30 02:58:19 +08:00
- name: Get pip cache dir
id: pip-cache
run: |
python -c "from pip._internal.locations import USER_CACHE_DIR; print('::set-output name=dir::' + USER_CACHE_DIR)"
2019-11-13 23:55:05 +08:00
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-13 23:55:05 +08:00
with:
path: ${{ steps.pip-cache.outputs.dir }}
key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
restore-keys: |
${{ runner.os }}-pip-
```
2020-01-22 08:22:40 +08:00
## R - renv
For renv, the cache directory will vary by OS. Look at https://rstudio.github.io/renv/articles/renv.html#cache
Locations:
- Ubuntu: `~/.local/share/renv`
- macOS: `~/Library/Application Support/renv`
- Windows: `%LOCALAPPDATA%/renv`
### Simple example
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2020-01-22 08:22:40 +08:00
with:
path: ~/.local/share/renv
key: ${{ runner.os }}-renv-${{ hashFiles('**/renv.lock') }}
restore-keys: |
${{ runner.os }}-renv-
```
Replace `~/.local/share/renv` with the correct `path` if not using Ubuntu.
### Multiple OS's in a workflow
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2020-01-22 08:22:40 +08:00
if: startsWith(runner.os, 'Linux')
with:
path: ~/.local/share/renv
key: ${{ runner.os }}-renv-${{ hashFiles('**/renv.lock') }}
restore-keys: |
${{ runner.os }}-renv-
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2020-01-22 08:22:40 +08:00
if: startsWith(runner.os, 'macOS')
with:
path: ~/Library/Application Support/renv
key: ${{ runner.os }}-renv-${{ hashFiles('**/renv.lock') }}
restore-keys: |
${{ runner.os }}-renv-
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2020-01-22 08:22:40 +08:00
if: startsWith(runner.os, 'Windows')
with:
path: ~\AppData\Local\renv
key: ${{ runner.os }}-renv-${{ hashFiles('**/renv.lock') }}
restore-keys: |
${{ runner.os }}-renv-
```
2020-01-13 07:48:43 +08:00
## Ruby - Bundler
2019-10-31 23:36:50 +08:00
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-10-31 23:36:50 +08:00
with:
path: vendor/bundle
2020-01-13 07:48:43 +08:00
key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}
2019-10-31 23:36:50 +08:00
restore-keys: |
2020-01-13 07:48:43 +08:00
${{ runner.os }}-gems-
2019-11-02 03:27:43 +08:00
```
2019-11-24 03:13:50 +08:00
When dependencies are installed later in the workflow, we must specify the same path for the bundler.
```yaml
- name: Bundle install
run: |
bundle config path vendor/bundle
bundle install --jobs 4 --retry 3
```
2019-11-02 03:27:43 +08:00
2019-11-04 23:15:02 +08:00
## Rust - Cargo
2019-11-06 00:03:56 +08:00
```yaml
2020-05-27 02:58:07 +08:00
- uses: actions/cache@v2
2019-11-04 23:15:02 +08:00
with:
2020-05-27 00:45:38 +08:00
path: |
~/.cargo/registry
~/.cargo/git
target
key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
2019-11-04 23:15:02 +08:00
```
2019-11-06 01:04:07 +08:00
2020-01-11 06:09:06 +08:00
## Scala - SBT
```yaml
- name: Cache SBT
2020-05-27 00:45:38 +08:00
uses: actions/cache@v2
2020-01-11 06:09:06 +08:00
with:
2020-05-27 00:45:38 +08:00
path: |
~/.ivy2/cache
~/.sbt
2020-01-11 06:09:06 +08:00
key: ${{ runner.os }}-sbt-${{ hashFiles('**/build.sbt') }}
```
2019-11-06 01:04:07 +08:00
## Swift, Objective-C - Carthage
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-06 01:04:07 +08:00
with:
path: Carthage
key: ${{ runner.os }}-carthage-${{ hashFiles('**/Cartfile.resolved') }}
restore-keys: |
${{ runner.os }}-carthage-
```
## Swift, Objective-C - CocoaPods
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2019-11-06 01:04:07 +08:00
with:
path: Pods
key: ${{ runner.os }}-pods-${{ hashFiles('**/Podfile.lock') }}
restore-keys: |
${{ runner.os }}-pods-
```
2020-01-30 00:13:59 +08:00
## Swift - Swift Package Manager
```yaml
2020-05-27 00:45:38 +08:00
- uses: actions/cache@v2
2020-01-30 00:13:59 +08:00
with:
path: .build
key: ${{ runner.os }}-spm-${{ hashFiles('**/Package.resolved') }}
restore-keys: |
${{ runner.os }}-spm-
```
2020-07-19 18:52:18 +08:00
## Swift - Mint
```yaml
env:
MINT_PATH: mint/lib
MINT_LINK_PATH: mint/bin
steps:
- uses: actions/cache@v2
with:
path: mint
key: ${{ runner.os }}-mint-${{ hashFiles('**/Mintfile') }}
restore-keys: |
${{ runner.os }}-mint-
```