mirror of
https://github.com/drillster/drone-volume-cache.git
synced 2026-06-26 15:52:19 +08:00
Michael de Wit
43 lines
1.6 KiB
Markdown
43 lines
1.6 KiB
Markdown
Use the Volume-cache plugin to preserve files and directories between builds.
|
|
Because it uses a mounted volume, it requires repositories using it to enable the *"Trusted"* flag.
|
|
|
|
## Config
|
|
The following parameters are used to configure the plugin:
|
|
- **restore** - instruct plugin to restore cache, can be `true` or `false`
|
|
- **rebuild** - instruct plugin to rebuild cache, can be `true` or `false`
|
|
- **mount** - list of folders to cache
|
|
|
|
## Examples
|
|
```yaml
|
|
pipeline:
|
|
restore-cache:
|
|
image: drillster/drone-volume-cache
|
|
restore: true
|
|
mount:
|
|
- ./node_modules
|
|
# Mount the cache volume, needs "Trusted"
|
|
volumes:
|
|
- /tmp/cache:/cache
|
|
|
|
build:
|
|
image: node
|
|
commands:
|
|
- npm install
|
|
|
|
rebuild-cache:
|
|
image: drillster/drone-volume-cache
|
|
rebuild: true
|
|
mount:
|
|
- ./node_modules
|
|
# Mount the cache volume, needs "Trusted"
|
|
volumes:
|
|
- /tmp/cache:/cache
|
|
```
|
|
|
|
The example above illustrates a typical Node.js project Drone configuration. It caches the `./node_modules` directory to a mounted volume on the host system: `/tmp/cache`. This prevents `npm` from downloading and installing the dependencies for every build.
|
|
|
|
## Clearing Cache
|
|
Should you want to clear the cache for a project, you can do so by including `[CLEAR CACHE]` in the commit message. The entire cache folder for the project will be cleared before it is restored. The rebuilding of cache will proceed as normal.
|
|
|
|
## Skipping Cache
|
|
If you want to run a build without using cache, put `[NO CACHE]` in the commit message. Both the restoring and rebuilding of cache will be skipped. Your cache will remain intact. |