Expand description
SandboxManager — orchestrates sandbox microVM lifecycle.
A sandbox is a short-lived, strongly-isolated microVM decoupled from its
workload: when the initial cmd process exits the sandbox transitions back
to Ready rather than stopping, and continues accepting Run calls until
an explicit Stop/Remove or TTL expiry.
create_sandbox returns immediately with state "starting". The VM boots
in a background task which broadcasts a "ready" event on success.
Modules§
- pause_
reason - Reason attribute values for pause/resume events.
Structs§
- Checkpoint
Info - Info returned after a successful checkpoint.
- Checkpoint
Summary - Lightweight checkpoint summary for
ListSnapshots. - Execution
Output - One offset-addressed chunk delivered on an attach stream.
- Execution
Snapshot - Point-in-time view of an execution.
- Execution
Spec - Parameters for starting an execution.
- Lifecycle
Update - A partial lifecycle update applied by
SetLifecycle(CORE-60). - Restore
Sandbox Spec - Parameters to restore a sandbox from a checkpoint.
- Sandbox
Event - A sandbox lifecycle event broadcast to subscribers.
- Sandbox
Info - Detailed sandbox state for
Inspect. - Sandbox
Manager - Manages the full lifecycle of multiple sandbox microVMs.
- Sandbox
Mount Spec - A single bind-mount into the sandbox.
- Sandbox
Network Identity - A sandbox’s network identity as seen by forwarding and DNS consumers.
- Sandbox
Network Info - Network details within
SandboxInfo. - Sandbox
Network Spec - Network configuration supplied at sandbox creation time.
- Sandbox
Spec - Full sandbox creation parameters.
- Sandbox
Summary - Lightweight summary for
Listoperations. - Stdin
State - Stdin acceptance state, the anchor for offset-resumable writes.
- Template
Warm Ref - A template’s pre-warmed boot-to-ready snapshot, threaded through
SandboxSpec(CORE-107).
Enums§
- Execution
Channel - Which stdio channel an attach chunk belongs to. For TTY executions the
merged PTY stream arrives on
Stdout. - Idle
Action - What happens when a sandbox’s idle timeout expires (CORE-21).
- Sandbox
State - Lifecycle state of a sandbox.