Harmont docs
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

  1. A job declares artifact-paths (glob) in its step definition.
  2. The runner uploads matching files to the artifact bucket via the runner protocol after the job's command exits.
  3. harmont-api records each artifact against the job and exposes it on the build's REST resource.
  4. 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.

On this page