Directories
¶
| Path | Synopsis |
|---|---|
|
Package agent runs the long-poll loop on the runner host.
|
Package agent runs the long-poll loop on the runner host. |
|
Package api defines the control-plane<->agent HTTP protocol.
|
Package api defines the control-plane<->agent HTTP protocol. |
|
Package disk reports free space on a runner host's image store.
|
Package disk reports free space on a runner host's image store. |
|
Package dispatch is the controller's persistent record of in-flight dispatches.
|
Package dispatch is the controller's persistent record of in-flight dispatches. |
|
pg
Package pg is a Postgres-backed dispatch.Store for the hosted control plane.
|
Package pg is a Postgres-backed dispatch.Store for the hosted control plane. |
|
Package domain holds neutral types shared across components.
|
Package domain holds neutral types shared across components. |
|
docker
Package docker implements the Driver interface by running each ephemeral runner as a container via the Docker or Podman CLI (autodetected, or pinned via Options.Runtime — the two are drop-in for the subcommands used here).
|
Package docker implements the Driver interface by running each ephemeral runner as a container via the Docker or Podman CLI (autodetected, or pinned via Options.Runtime — the two are drop-in for the subcommands used here). |
|
factory
Package factory builds a Driver from agent config.
|
Package factory builds a Driver from agent config. |
|
lume
Package lume binds the lume CLI (MIT, Apple Virtualization.framework) to the generic VM driver in internal/driver/vmdriver.
|
Package lume binds the lume CLI (MIT, Apple Virtualization.framework) to the generic VM driver in internal/driver/vmdriver. |
|
sshrunner
Package sshrunner holds the SSH-based runner bootstrap shared by the macOS drivers (tart, lume).
|
Package sshrunner holds the SSH-based runner bootstrap shared by the macOS drivers (tart, lume). |
|
tart
Package tart binds the tart CLI (Apple Virtualization.framework) to the generic VM driver in internal/driver/vmdriver.
|
Package tart binds the tart CLI (Apple Virtualization.framework) to the generic VM driver in internal/driver/vmdriver. |
|
vmdriver
Package vmdriver provides a generic ephemeral-VM Driver shared by the macOS drivers (tart, lume).
|
Package vmdriver provides a generic ephemeral-VM Driver shared by the macOS drivers (tart, lume). |
|
Package enroll handles agent authentication for the hosted control plane: per-agent enrollment tokens (validated against Neon) and the browser-session + PKCE handshake behind `ushr login`.
|
Package enroll handles agent authentication for the hosted control plane: per-agent enrollment tokens (validated against Neon) and the browser-session + PKCE handshake behind `ushr login`. |
|
Package jit mints GitHub Actions runner JIT configs per org installation.
|
Package jit mints GitHub Actions runner JIT configs per org installation. |
|
Package ledger is an append-only store of completed ushr jobs.
|
Package ledger is an append-only store of completed ushr jobs. |
|
github
Package github implements a polling Source backed by the GitHub Actions API.
|
Package github implements a polling Source backed by the GitHub Actions API. |
|
scaleset
Package scaleset implements a Source backed by GitHub's Runner Scale Set API (the mechanism behind actions-runner-controller, via the standalone actions/scaleset client).
|
Package scaleset implements a Source backed by GitHub's Runner Scale Set API (the mechanism behind actions-runner-controller, via the standalone actions/scaleset client). |
|
Package svc installs and controls the ushr launchd/systemd user services, so the CLI can take a host from enrolled to running without a repo checkout or hand-run launchctl/systemctl incantations.
|
Package svc installs and controls the ushr launchd/systemd user services, so the CLI can take a host from enrolled to running without a repo checkout or hand-run launchctl/systemctl incantations. |
|
Package telemetry persists the dispatch story the control plane otherwise drops: finished jobs (job_runs), agent liveness (agent_status), and a live transition feed (dispatch_events).
|
Package telemetry persists the dispatch story the control plane otherwise drops: finished jobs (job_runs), agent liveness (agent_status), and a live transition feed (dispatch_events). |
|
Package update installs official agent releases after the host drains.
|
Package update installs official agent releases after the host drains. |
|
Package webhook receives GitHub workflow_job events and feeds completed jobs run on ushr runners into the ledger.
|
Package webhook receives GitHub workflow_job events and feeds completed jobs run on ushr runners into the ledger. |
Click to show internal directories.
Click to hide internal directories.