arcbox-vm 0.4.9

Guest-side Firecracker sandbox manager (frozen; see arcbox-vmm for host VMM).
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

//! Firecracker process spawn helpers — shared between `manager` and `sandbox`.

use std::path::Path;
use std::time::Duration;

use fc_sdk::process::{FirecrackerProcessBuilder, JailerProcessBuilder};

use crate::config::{FirecrackerConfig, JailerConfig};
use crate::error::{Result, VmmError};

/// Configure and spawn a Firecracker process via the Jailer.
///
/// Returns the spawned process. The caller can query `process.socket_path()`
/// to obtain the API socket inside the chroot.
pub async fn spawn_jailer(
    jc: &JailerConfig,
    fc_cfg: &FirecrackerConfig,
    id: &str,
) -> Result<fc_sdk::FirecrackerProcess> {
    let mut jb = JailerProcessBuilder::new(&jc.binary, &fc_cfg.binary, id, jc.uid, jc.gid);
    if let Some(ref base) = jc.chroot_base_dir {
        jb = jb.chroot_base_dir(base);
    }
    if let Some(ref ns) = jc.netns {
        jb = jb.netns(ns);
    }
    if jc.new_pid_ns {
        jb = jb.new_pid_ns(true);
    }
    if let Some(ref ver) = jc.cgroup_version {
        jb = jb.cgroup_version(ver);
    }
    if let Some(ref parent) = jc.parent_cgroup {
        jb = jb.parent_cgroup(parent);
    }
    for limit in &jc.resource_limits {
        jb = jb.resource_limit(limit);
    }
    if let Some(secs) = fc_cfg.socket_timeout_secs {
        jb = jb.socket_timeout(Duration::from_secs(secs));
    }
    jb.spawn()
        .await
        .map_err(|e| VmmError::Process(e.to_string()))
}

/// Configure and spawn a Firecracker process directly (no Jailer).
pub async fn spawn_direct(
    fc_cfg: &FirecrackerConfig,
    id: &str,
    socket_path: &Path,
    log_path: &Path,
    metrics_path: &Path,
) -> Result<fc_sdk::FirecrackerProcess> {
    let mut fb = FirecrackerProcessBuilder::new(&fc_cfg.binary, socket_path).id(id);
    fb = fb.log_path(log_path).metrics_path(metrics_path);
    if let Some(ref level) = fc_cfg.log_level {
        fb = fb.log_level(level);
    }
    if fc_cfg.no_seccomp {
        fb = fb.no_seccomp(true);
    }
    if let Some(ref filter) = fc_cfg.seccomp_filter {
        fb = fb.seccomp_filter(filter);
    }
    if let Some(size) = fc_cfg.http_api_max_payload_size {
        fb = fb.http_api_max_payload_size(size);
    }
    if let Some(size) = fc_cfg.mmds_size_limit {
        fb = fb.mmds_size_limit(size);
    }
    if let Some(secs) = fc_cfg.socket_timeout_secs {
        fb = fb.socket_timeout(Duration::from_secs(secs));
    }
    tracing::debug!(
        id,
        socket = %socket_path.display(),
        log = %log_path.display(),
        metrics = %metrics_path.display(),
        binary = %fc_cfg.binary,
        "spawning firecracker (direct mode)"
    );
    fb.spawn()
        .await
        .map_err(|e| VmmError::Process(e.to_string()))
}