Skip to content

ci.run

Run one job of a point: every task scheduled there, in order.

The one verb the emitted workflows call, once per job. What the job does is data: the workshop's builtin schedule plus the contract's [[ci.schedule]] entries. A push to main promotes the gate to the merge point, so the shell spells no decision. On a check leg the contract splits, --shard=2of4 names the shard this job runs as: it ends the leg's label and the job's display name, and the walk runs that shard's share; without it the job runs as one shard of one. A person may run a job by hand; the tasks that only CI may do refuse or fail open on their own.

fm ci.run --point=VALUE --job=VALUE [--os=VALUE] [--python=VALUE] [--shard=VALUE]
Parameter Type Default Description
--point=VALUE required the point: gate, merge, nightly, or release
--job=VALUE required the point's job this runner executes
--os=VALUE "" the matrix runner label, on a matrix job
--python=VALUE "" the matrix python, on a matrix job
--shard=VALUE "" the leg's shard, of, on a check leg the contract splits

Example

$ fm ci.run --point=<point> --job=<job>