Daemon: local runtimes
cua.daemon.v1 RuntimeService: the local engines and images the cua daemon orchestrates.
cua.daemon.v1 RuntimeService: the local engines and images the cua daemon orchestrates.
The local runtimes (gVisor, runc, QEMU, Lume) and images the cua daemon orchestrates.
Source: libs/cua/proto/cua/daemon/v1/runtime.proto.
cua.daemon.v1.RuntimeService
Local runtime provisioning (cua runtime doctor|setup).
/cua.daemon.v1.RuntimeService/Doctor, unary: DoctorRequest to DoctorResponse.
Inspects local runtimes (Lume, QEMU, container engine, runsc) without changing anything.
/cua.daemon.v1.RuntimeService/Setup, unary: SetupRequest to SetupResponse.
Installs or starts missing local runtime components. Every step is explicit and logged in the response.
/cua.daemon.v1.RuntimeService/PullImage, unary: PullImageRequest to PullImageResponse.
Pulls an image into the local cache or container engine.
/cua.daemon.v1.RuntimeService/BuildImage, unary: BuildImageRequest to BuildImageResponse.
Builds an image from an images.cua.ai/v1alpha1 Image resource.
/cua.daemon.v1.RuntimeService/PushImage, unary: PushImageRequest to PushImageResponse.
Copies an image (host architecture) to another registry reference.
cua/daemon/v1/runtime.proto#One doctor check.
| Field | # | Type | Description |
|---|---|---|---|
name | 1 | string | Component, for example "lume", "qemu", "docker", "runsc". |
status | 2 | CheckStatus | Status. |
version | 3 | string | Detected version, when present. |
detail | 4 | string | Explanation or remediation. |
Request for RuntimeService.Doctor.
No fields.
Response for RuntimeService.Doctor.
| Field | # | Type | Description |
|---|---|---|---|
checks | 1 | repeated RuntimeCheck | Checks, in a stable order. |
report_json | 2 | string | The full host report (cua-vmm DoctorReport) as JSON. |
Request for RuntimeService.Setup.
| Field | # | Type | Description |
|---|---|---|---|
components | 1 | repeated string | Components to set up. Empty means every installable component. |
dry_run | 2 | bool | Report the plan without changing anything. |
One setup step.
| Field | # | Type | Description |
|---|---|---|---|
name | 1 | string | Component. |
status | 2 | CheckStatus | Status after the step. |
detail | 3 | string | What was done, or would be done on a dry run. |
Response for RuntimeService.Setup.
| Field | # | Type | Description |
|---|---|---|---|
steps | 1 | repeated SetupStep | Steps, in execution order. |
A local image.
| Field | # | Type | Description |
|---|---|---|---|
reference | 1 | string | Reference. |
kind | 2 | string | container or vm. |
location | 3 | string | Local disk path (VM images) or engine image reference (containers). |
size_bytes | 4 | uint64 | Size in bytes, when known. |
Request for RuntimeService.PullImage.
| Field | # | Type | Description |
|---|---|---|---|
reference | 1 | string | Reference, with an optional backend prefix (container:, vm:). |
Response for RuntimeService.PullImage.
| Field | # | Type | Description |
|---|---|---|---|
image | 1 | LocalImage | The pulled image. |
Request for RuntimeService.BuildImage.
| Field | # | Type | Description |
|---|---|---|---|
spec_json | 1 | string | images.cua.ai/v1alpha1 Image resource as JSON. |
base | 2 | string | Base image, with an optional backend prefix (container:, vm:, disk:). |
push | 3 | string | Push the result to this reference. Empty keeps it local. |
Response for RuntimeService.BuildImage.
| Field | # | Type | Description |
|---|---|---|---|
result | 1 | string | reference@digest when pushed, else the local output directory. |
Request for RuntimeService.PushImage.
| Field | # | Type | Description |
|---|---|---|---|
reference | 1 | string | Source reference. |
destination | 2 | string | Destination reference. |
Response for RuntimeService.PushImage.
| Field | # | Type | Description |
|---|---|---|---|
digest | 1 | string | Pushed manifest digest. |
Status of one local runtime component.
| Value | # | Description |
|---|---|---|
CHECK_STATUS_UNSPECIFIED | 0 | Not reported. |
CHECK_STATUS_OK | 1 | Present and usable. |
CHECK_STATUS_INSTALLABLE | 2 | Missing, but cua runtime setup can install it. |
CHECK_STATUS_ERROR | 3 | Missing or broken and needs user action. |
CHECK_STATUS_NOT_APPLICABLE | 4 | Not applicable on this host. |