shared-actions/download-artifact/README.md
Michael Seele ed2dcca9bb
All checks were successful
validate-shared-actions / validate-shared-actions (pull_request) Successful in 56s
Aikido Security PR Check / Aikido Security Scan (pull_request) Successful in 1m7s
feat: add download-artifact and upload-artifact actions with documentation
2026-05-22 09:55:02 +00:00

1.6 KiB

download-artifact

Download Forgejo Actions artifacts by name or pattern. Thin wrapper around forgejo/download-artifact pinned to a specific commit SHA to prevent supply chain attacks.

Inputs

Input Required Default Description
name No "" Exact artifact name or glob pattern (e.g. blob-report-*). If omitted, all artifacts for the run are downloaded.
path No . Local destination directory
merge-multiple No false When true, merge all matched artifacts into a single directory

Usage

Download a single artifact by name:

- uses: https://schmalz-git.git.onstackit.cloud/schmalz/shared-actions/download-artifact@download-artifact-v1
  with:
    name: my-artifact
    path: dist/

Download all artifacts matching a pattern and merge into one directory:

- uses: https://schmalz-git.git.onstackit.cloud/schmalz/shared-actions/download-artifact@download-artifact-v1
  with:
    name: blob-report-*
    path: all-blob-reports/
    merge-multiple: "true"

Download all artifacts for the run:

- uses: https://schmalz-git.git.onstackit.cloud/schmalz/shared-actions/download-artifact@download-artifact-v1
  with:
    path: artifacts/

Notes

  • Wraps forgejo/download-artifact v4 (node20), compatible with Ubuntu 22 runners.
  • The underlying action is pinned to a commit SHA rather than a mutable tag to prevent supply chain attacks.
  • When merge-multiple is false (default), each matched artifact is extracted into its own subdirectory under path.