arcbox-core 0.1.4

Core orchestration layer for ArcBox
docs.rs failed to build arcbox-core-0.1.4
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

arcbox-core

Core orchestration runtime for ArcBox.

Overview

arcbox-core provides the host-side runtime that coordinates machine lifecycle, VM readiness, guest-agent connectivity, and networking/port-forward state.

The main entry point is Runtime:

  • Runtime::new(config) creates the runtime synchronously
  • runtime.init().await prepares runtime state and assets
  • runtime.ensure_vm_ready().await ensures the default machine is running

Key Components

  • Runtime: top-level orchestrator
  • MachineManager: named machine lifecycle and metadata
  • VmLifecycleManager: automatic start/health/recovery for default machine
  • AgentClient: guest RPC client over vsock
  • NetworkManager: network lifecycle and IP allocation

Usage

use arcbox_core::{Config, Runtime};

let runtime = Runtime::new(Config::default())?;
runtime.init().await?;
let cid = runtime.ensure_vm_ready().await?;
println!("default machine CID: {cid}");

Architecture

arcbox-api / arcbox-cli
          |
          v
      arcbox-core::Runtime
          |
          +-- MachineManager
          +-- VmLifecycleManager
          +-- NetworkManager
          +-- AgentClient accessors

License

MIT OR Apache-2.0