FabricFabricRunway
Reference

runway.json

The delivery manifest fr init writes and fr deploy / fr promote read back.

runway.json is the delivery manifest at the root of a Runway project. fr init writes it, and fr deploy / fr promote read it to know what to build, where to stage it, and which gate to run.

runway.json
{
  "name": "support-agent",
  "template": "rag-agent",
  "gate": "eval-suite",
  "artifact": ".fabricharness/build/databricks-app",
  "artifactVolume": "/Volumes/main/runway/artifacts"
}

Fields

FieldRequiredDescription
nameyesThe app name. Must match ^[a-z][a-z0-9-]*$. Used as the catalog key and in the UC Volume artifact path.
templateyesThe template the repo was scaffolded from (e.g. rag-agent). Recorded in the catalog.
gateyesThe Fabric Experiments gate / evaluator name requested by fr deploy and required before promotion.
artifactyesThe bundle root produced by the build step. Defaults to Harness's output, .fabricharness/build/databricks-app.
artifactVolumenoThe customer-owned Unity Catalog Volume root for immutable release artifacts. The staged path is <artifactVolume>/<name>/<sha256>.

How the fields are used

  • artifact points fr deploy at the directory to digest and upload.
  • artifactVolume determines where the content-addressed artifact is staged. It must be a /Volumes/<catalog>/<schema>/<volume>/… path your identity can write to.
  • gate is the evaluator gate_evaluate requests and the gate a promotion requires.
  • name keys the app in the catalog and slugs into the artifact path.

The file is validated by hand (the CLI is zero-dependency): a missing or empty name, template, gate, or artifact is a usage error, and artifactVolume, if present, must be a string.

On this page