yaml
- uses: actions/setup-node@v4
with:
node-version: 20
cache: npmNotes
Prefer first-party built-in caching support when available.
GitHub Actions: Caching, Artifacts, and GitHub CLI Workflows
Cache dependencies, upload and download artifacts, and drive workflows with GitHub CLI commands in GitHub Actions.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
Caching dependencies
Reduce workflow time by caching dependencies and build inputs.
yaml
- uses: actions/cache@v4
with:
path: |
~/.cache/pip
.venv
key: ${{ runner.os }}-pip-${{ hashFiles('requirements.txt') }}
restore-keys: |
${{ runner.os }}-pip-Notes
Choose keys that change when dependencies change, and use restore keys for partial hits.
Artifacts and GitHub CLI
Store outputs and interact with workflows using `gh`.
Upload build output as an artifact
Save files from the workflow run for later download or later jobs.
yamlANYupload-artifactartifacts
yaml
- uses: actions/upload-artifact@v4
with:
name: build-output
path: dist/Notes
Artifacts are great for test reports, build outputs, logs, and release bundles.
yaml
- uses: actions/download-artifact@v4
with:
name: build-output
path: ./artifactsNotes
Artifacts are a common way to hand off generated files between jobs.
bash
gh workflow listNotes
Useful for debugging and automating workflow management from a terminal or script.
bash
gh workflow run deploy.yml -f environment=stagingNotes
The target workflow must define the `workflow_dispatch` trigger and compatible inputs.
bash
gh run watchNotes
Helpful when you want live feedback without keeping the GitHub Actions page open.
Download workflow artifacts with gh
Fetch artifacts from a completed workflow run.
bashANYghrundownloadartifacts
bash
gh run download RUN_ID -n build-outputNotes
Great for pulling logs or build output from CI to your local machine.
More in GitHub Actions
GitHub Actions: Debugging, Logs, and Troubleshooting
Debug failing GitHub Actions workflows with log grouping, debug logging, step summaries, shell flags, and common troubleshooting patterns.
GitHub Actions: Runners, Containers, Services, and Self-Hosted Execution
GitHub-hosted runners, self-hosted runners, job containers, service containers, labels, and operational patterns for GitHub Actions execution.
GitHub Actions: Testing, Build, Release, and Deploy Pipelines
Practical CI/CD recipes for testing, build matrices, release creation, package publishing, and environment-based deployments in GitHub Actions.
GitHub Actions: Secrets, Permissions, Security, and OIDC
Secure GitHub Actions workflows with permissions, environments, secrets, masking, fork safety, and OpenID Connect for cloud auth.
GitHub Actions: Expressions, Contexts, Variables, and Outputs
Expressions, contexts, env vars, configuration variables, step outputs, job outputs, and dynamic workflow logic in GitHub Actions.
GitHub Actions: Jobs, Steps, Matrix, and Reusable Building Blocks
Jobs, steps, matrix builds, conditional execution, reusable workflows, composite actions, and service containers in GitHub Actions.