README
¶
Reactorcide Coordinator and CLI
This Go module builds the reactorcide binary. The binary includes the
coordinator, worker, local runner, remote client, token commands, and secret
commands.
Build
Use the Go version in go.mod:
go build -o reactorcide .
Main Commands
reactorcide serve
reactorcide worker
reactorcide run-local
reactorcide submit
reactorcide logs
reactorcide token
reactorcide secrets
reactorcide secret-grants
reactorcide migrate
Run ./reactorcide COMMAND --help for current arguments.
Tests
Run a package test:
go test ./internal/vcs
Run all module tests:
go test ./...
Some integration tests need a container runtime. See test/README.md.
Documentation
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
vmsmoke
command
This stub keeps `go build ./...` working on every platform/tag combination that is NOT a real smoke target (darwin && vz, or windows).
|
This stub keeps `go build ./...` working on every platform/tag combination that is NOT a real smoke target (darwin && vz, or windows). |
|
internal
|
|
|
auth
Package auth is the auth core for the reactorcide management UI: REACTORCIDE_UI_AUTH_MODE config, LinkKeys local-RP and regular-RP login backends, encrypted credential storage, trusted-identity/domain-pattern admission, single-use login attempts, identity->user provisioning (including first-admin and bootstrap-admin grants), and opaque session tokens.
|
Package auth is the auth core for the reactorcide management UI: REACTORCIDE_UI_AUTH_MODE config, LinkKeys local-RP and regular-RP login backends, encrypted credential storage, trusted-identity/domain-pattern admission, single-use login attempts, identity->user provisioning (including first-admin and bootstrap-admin grants), and opaque session tokens. |
|
authz
Package authz is the role-resolution, capability-computation, and visibility-filtering core for the reactorcide management UI.
|
Package authz is the role-resolution, capability-computation, and visibility-filtering core for the reactorcide management UI. |
|
characteristics
Package characteristics implements the pure logic for reactorcide's characteristic model: parsing/validation, canonicalization, hashing, and the worker-satisfies-queue matching predicate described in).
|
Package characteristics implements the pure logic for reactorcide's characteristic model: parsing/validation, canonicalization, hashing, and the worker-satisfies-queue matching predicate described in). |
|
cipolicy
Package cipolicy parses and evaluates trusted CI admission policy.
|
Package cipolicy parses and evaluates trusted CI admission policy. |
|
coordinatorworker
Package coordinatorworker is the coordinator-mediated worker run loop: Register -> RequestJob -> run via the existing internal/worker.JobRunner -> stream logs to the coordinator via AppendLogBatch -> ReportResult, with a concurrent Heartbeat that renews the worker session and applies cancel/kill directives.
|
Package coordinatorworker is the coordinator-mediated worker run loop: Register -> RequestJob -> run via the existing internal/worker.JobRunner -> stream logs to the coordinator via AppendLogBatch -> ReportResult, with a concurrent Heartbeat that renews the worker session and applies cancel/kill directives. |
|
corndogs/csilapi
Package corndogs contains generated service clients.
|
Package corndogs contains generated service clients. |
|
jobcontrol
Package jobcontrol holds the execution-layer cancel/kill primitives for jobs and workflows, shared between the REST handlers (internal/handlers) and — in a later wave — the CSIL-RPC UI service.
|
Package jobcontrol holds the execution-layer cancel/kill primitives for jobs and workflows, shared between the REST handlers (internal/handlers) and — in a later wave — the CSIL-RPC UI service. |
|
jobtelemetry
Package jobtelemetry stores and queries immutable job telemetry batches.
|
Package jobtelemetry stores and queries immutable job telemetry batches. |
|
profiles
Package profiles enforces monotonic execution-profile authority.
|
Package profiles enforces monotonic execution-profile authority. |
|
pubsub
Package pubsub provides in-memory fan-out of job-related events and a PostgreSQL LISTEN/NOTIFY bridge so events cross coordinator replicas.
|
Package pubsub provides in-memory fan-out of job-related events and a PostgreSQL LISTEN/NOTIFY bridge so events cross coordinator replicas. |
|
resources
Package resources parses and validates per-job compute resource specifications: CPU request/limit and memory limit (memory is limit-only -- there is no memory request in reactorcide).
|
Package resources parses and validates per-job compute resource specifications: CPU request/limit and memory limit (memory is limit-only -- there is no memory request in reactorcide). |
|
secrets
Package secrets provides secret storage abstraction with multiple backend support.
|
Package secrets provides secret storage abstraction with multiple backend support. |
|
store/ctxkey
Package ctxkey provides the transaction context key used by the store packages.
|
Package ctxkey provides the transaction context key used by the store packages. |
|
tokencaps
Package tokencaps defines coordinator API token capabilities.
|
Package tokencaps defines coordinator API token capabilities. |
|
transportsecurity
Package transportsecurity enforces the security properties required when Reactorcide sends credentials or job secrets over a network transport.
|
Package transportsecurity enforces the security properties required when Reactorcide sends credentials or job secrets over a network transport. |
|
uiapi
Package uiapi implements the coordinator-side CSIL-RPC dispatcher for the ReactorcideAuth and ReactorcideUi services (coordinator_api/csil/reactorcide-ui.csil).
|
Package uiapi implements the coordinator-side CSIL-RPC dispatcher for the ReactorcideAuth and ReactorcideUi services (coordinator_api/csil/reactorcide-ui.csil). |
|
uiapi/csilapi
Package csilapi contains generated service clients.
|
Package csilapi contains generated service clients. |
|
worker/vmrunner
Package vmrunner implements the "vm" JobRunner backend: ephemeral, per-job guest VMs used to run native macOS/Windows jobs on host workers.
|
Package vmrunner implements the "vm" JobRunner backend: ephemeral, per-job guest VMs used to run native macOS/Windows jobs on host workers. |
|
workerapi
Package workerapi implements the coordinator side of the ReactorcideWorker CSIL-RPC protocol: Register, RequestJob, Heartbeat, AppendLogs, and ReportResult.
|
Package workerapi implements the coordinator side of the ReactorcideWorker CSIL-RPC protocol: Register, RequestJob, Heartbeat, AppendLogs, and ReportResult. |
|
workerapi/csilapi
Package csilapi contains the self-contained canonical-CBOR codec.
|
Package csilapi contains the self-contained canonical-CBOR codec. |
|
workerauth
Package workerauth provides the worker-side counterparts to internal/auth's UI session/credential primitives: enrollment-token validation (the only human-handled worker credential) and ephemeral, process- lifetime worker sessions.
|
Package workerauth provides the worker-side counterparts to internal/auth's UI session/credential primitives: enrollment-token validation (the only human-handled worker credential) and ephemeral, process- lifetime worker sessions. |
|
workerclient
Package workerclient is the worker-side CSIL-RPC carrier for the coordinator's ReactorcideWorker service.
|
Package workerclient is the worker-side CSIL-RPC carrier for the coordinator's ReactorcideWorker service. |
|
workerclient/csilapi
Package csilapi contains generated service clients.
|
Package csilapi contains generated service clients. |
|
workflowengine
Package workflowengine contains workflow graph rules that are independent from storage and execution.
|
Package workflowengine contains workflow graph rules that are independent from storage and execution. |
|
workflowevents
Package workflowevents publishes workflow and job lifecycle events.
|
Package workflowevents publishes workflow and job lifecycle events. |
Click to show internal directories.
Click to hide internal directories.