Skip to main content

Module sandbox

Module sandbox 

Source
Expand description

ComputerManager — 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_computer 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§

CheckpointInfo
Info returned after a successful checkpoint.
CheckpointSummary
Lightweight checkpoint summary for ListSnapshots.
ComputerEvent
A sandbox lifecycle event broadcast to subscribers.
ComputerInfo
Detailed sandbox state for Inspect.
ComputerManager
Manages the full lifecycle of multiple sandbox microVMs.
ComputerMountSpec
A single bind-mount into the sandbox.
ComputerNetworkIdentity
A sandbox’s network identity as seen by forwarding and DNS consumers.
ComputerNetworkInfo
Network details within ComputerInfo.
ComputerNetworkSpec
Network configuration supplied at sandbox creation time.
ComputerSpec
Full sandbox creation parameters.
ComputerSummary
Lightweight summary for List operations.
ExecutionOutput
One offset-addressed chunk delivered on an attach stream.
ExecutionSnapshot
Point-in-time view of an execution.
ExecutionSpec
Parameters for starting an execution.
LifecycleUpdate
A partial lifecycle update applied by SetLifecycle (CORE-60).
RestoreComputerSpec
Parameters to restore a sandbox from a checkpoint.
StdinState
Stdin acceptance state, the anchor for offset-resumable writes.
TemplateWarmRef
A template’s pre-warmed boot-to-ready snapshot, threaded through ComputerSpec (CORE-107).

Enums§

ComputerState
Lifecycle state of a sandbox.
ExecutionChannel
Which stdio channel an attach chunk belongs to. For TTY executions the merged PTY stream arrives on Stdout.
IdleAction
What happens when a sandbox’s idle timeout expires (CORE-21).

Type Aliases§

ComputerId