Documentation
¶
Overview ¶
Package domain holds neutral types shared across components.
Index ¶
Constants ¶
const RunnerNamePrefix = "ushr-"
RunnerNamePrefix is the prefix the controller gives every JIT runner it mints ("ushr-{agent}-{jobid}"). It's the contract that lets cost attribution and the webhook ledger recognise a job as ushr-served, so minting and attribution must share this one constant.
Variables ¶
This section is empty.
Functions ¶
func LabelsSatisfied ¶
LabelsSatisfied reports whether every label a job requires is advertised by a runner. Case-insensitive: GitHub preserves the case a workflow wrote and an operator's config rarely matches it.
Both the control plane (deciding what to offer an agent) and the agent (deciding what is worth reporting) must apply the same test — an agent that reports work it can never be offered leaks that work into its queue forever, because nothing but running a job to completion clears an entry.
func RandomName ¶
RandomName returns prefix plus a random 4-byte hex suffix — the one name generator for runners, VMs, and containers, so entropy/format changes land everywhere at once.
func RunnerName ¶
RunnerName is the dispatch id == slot handle == runner name for a job an agent will run: "ushr-{agent}-{jobid}". The single source of truth, shared by the control plane (which assigns it) and the agent (which mints under it). JobID, not RunID: a multi-job run shares a RunID, so a RunID-based name collides on the second job; JobID is unique per job, which also makes a re-dispatch of the same job hit the 409-reap path rather than leak a runner.
func SplitRepoScope ¶
SplitRepoScope splits an "owner/repo" scope. ok is false for an org scope (a '/' is legal in neither an org login nor a bare repo name).
Types ¶
type Job ¶
type Job struct {
// Org is the tenant scope: a GitHub org login, or "owner/repo" for a
// repo-scoped target (personal accounts have no org-level runner pool, so
// their runners are per-repo). Everything downstream — dispatch dedup, the
// enrollment-token grant set, tenant matching — treats it as an opaque
// string; only the agent's GitHub calls interpret org vs repo. See SplitRepoScope.
Org string
Repo string
RunID int64
JobID int64
Labels []string
QueuedAt time.Time
}
Job is a queued unit of work that needs a runner.
Source Files