Skip to main content
Version: v5.7.0

opschain admin runner-group

Included from Basic tier

Manages runner groups — the durable rows registration tokens reference and enrolment inherits, each carrying a placement contract (registered key=value attributes, node-path bindings, the exclusive flag) and operator drain state. Groups are the unit of placement, zoning and scaling: work demands them by name or by selector, bindings pin subtrees to them, and the demand signal drives autoscalers per group.

SubcommandDoes
listList groups with their contracts and drain state — opschain docs cli/admin-runner-group-list
setCreate or update a group (wholesale replace) — opschain docs cli/admin-runner-group-set
drainDrain every runner of a group — opschain docs cli/admin-runner-group-drain
resumeLift a group's drain — opschain docs cli/admin-runner-group-resume
demandQueued and running work for a group (the autoscaler signal) — opschain docs cli/admin-runner-group-demand
deleteDelete a group nothing references — opschain docs cli/admin-runner-group-delete

The attribute keys a group may carry are registered under opschain admin runner-attributes (opschain docs cli/admin-runner-attributes); how the contract decides dispatch is opschain docs fleet-queue.