Concepts
Artifacts
Files produced by jobs that downstream jobs consume.
An artifact is a file a job produces and persists past its runner's lifetime. Downstream jobs in the same build can fetch artifacts by glob; humans can download them from the dashboard. Typical uses are test reports, coverage data, and deployable build outputs.
How it works
- A job declares
artifact-paths(glob) in its step definition. - The runner uploads matching files to the artifact bucket via the runner protocol after the job's command exits.
harmont-apirecords each artifact against the job and exposes it on the build's REST resource.- Downstream jobs (and the dashboard) fetch by build + path.
Source of truth
api/src/Harmont/Handler/Artifact.hs— REST handler.api/src/Harmont/Model.hs— artifact persistence schema.