Struct InstanceSpec 

pub struct InstanceSpec {

    pub box_id: String,
    pub vcpus: u8,
    pub memory_mib: u32,
    pub rootfs_path: PathBuf,
    pub exec_socket_path: PathBuf,
    pub pty_socket_path: PathBuf,
    pub attest_socket_path: PathBuf,
    pub fs_mounts: Vec<FsMount>,
    pub entrypoint: Entrypoint,
    pub console_output: Option<PathBuf>,
    pub workdir: String,
    pub tee_config: Option<TeeInstanceConfig>,
    pub port_map: Vec<String>,
    pub user: Option<String>,
    pub network: Option<NetworkInstanceConfig>,
    pub resource_limits: ResourceLimits,
}

Complete configuration for a VM instance.

Serialized and passed to the shim subprocess, which uses it to configure and start the VM via the underlying hypervisor.

Fields

box_id: String

Unique identifier for this box instance

vcpus: u8

Number of vCPUs (default: 2)

memory_mib: u32

Memory in MiB (default: 512)

rootfs_path: PathBuf

Path to the root filesystem

exec_socket_path: PathBuf

Path to the Unix socket for exec communication

pty_socket_path: PathBuf

Path to the Unix socket for PTY communication

attest_socket_path: PathBuf

Path to the Unix socket for TEE attestation communication

fs_mounts: Vec<FsMount>

Filesystem mounts (virtio-fs shares)

entrypoint: Entrypoint

Guest agent entrypoint

console_output: Option<PathBuf>

Optional console output file path

workdir: String

Working directory inside the VM

tee_config: Option<TeeInstanceConfig>

TEE configuration (None for standard VM)

port_map: Vec<String>

TSI port mappings: [“host_port:guest_port”, …]

user: Option<String>

User to run as inside the VM (from OCI USER directive). Format: “uid”, “uid:gid”, “user”, or “user:group”

network: Option<NetworkInstanceConfig>

Network configuration for passt-based networking. None = TSI mode (default), Some = passt virtio-net mode.

resource_limits: ResourceLimits

Resource limits (PID limits, CPU pinning, ulimits, cgroup controls).

Trait Implementations

impl Clone for InstanceSpec

fn clone(&self) -> InstanceSpec

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for InstanceSpec

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for InstanceSpec

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for InstanceSpec

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for InstanceSpec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.