firec

firec (pronounced "fyrek") is Rust client library to interact with [Firecracker]. It allows you to create, manipulate, query and stop VMMs.

Examples

```rust,no_run use std::path::Path; use firec::{ Machine, config::{Config, Drive, Jailer, Machine as MachineCfg, network::Interface}}; use tokio::time::{sleep, Duration};

[tokio::main]

async fn main() -> Result<(), Box> { let jailer = Jailer::builder() .chrootbasedir(Path::new("/srv")) .exec_file(Path::new("/usr/bin/firecracker")) .build();

let root_drive = Drive::builder("root", Path::new("debian.ext4"))
    .is_root_device(true)
    .build();

let kernel_args = Some("console=ttyS0 reboot=k panic=1 pci=off random.trust_cpu=on");

let iface = Interface::new("eth0", "tap0");

let machine_cfg = MachineCfg::builder()
    .vcpu_count(2)
    .mem_size_mib(1024)
    .build();

let config = Config::builder(Path::new("debian-vmlinux"))
    .jailer_cfg(Some(jailer))
    .kernel_args(kernel_args)
    .machine_cfg(machine_cfg)
    .add_drive(root_drive)
    .add_network_interface(iface)
    .socket_path(Path::new("/tmp/firecracker.socket"))
    .build();
let machine = Machine::create(config).await?;

machine.start().await?;

// Let the machine run for a bit before we KILL IT :)
sleep(Duration::from_secs(15)).await;

machine.stop().await?;

Ok(())

} ```

status

Currently heavily in development and therefore expect a lot of API breakage for a while.

Having said that, we'll be following Cargo's SemVer rules so breaking changes will be released in new minor releases. However, we will only support the latest release.