mirror of
https://github.com/vhaudiquet/ecrou.git
synced 2026-11-12 22:22:44 +00:00
vhaudiquet
4aadc5d28a
The code is the source of truth now; what stays is the part code cannot carry — the founding rule and confinement budget (fixed: the budget said no child process, the machine child is one), the run contracts (exit codes rewritten to match the engine-failure and reserved-code semantics), the trust model, the falsification tests, and the roadmap. Cut: the engine call list, the RunOptions listing, the CLI flags table, the cache layout tree, the workspace/module map, the ecr porting table, and the open questions — all answered or all mirrors of code that answers them faster.
ecrou
a small microVM runtime based on libkrun
Try ecrou in the terminal
Installation
ecrou is available as a strictly confined snap:
sudo snap install ecrou
sudo snap connect ecrou:kvm
Usage
$ ecrou run -it ubuntu
root@ecrou-vm-m2glhl:/#
Embed ecrou into your project
ecrou is both a library and a tiny CLI frontend around it. The library is embeddable into any project, allowing to use microVMs easily.
Rust
ecrou is a Rust library, which can just be called:
use ecrou::vm::RunOptions;
use ecrou::NoProgress;
fn main() -> ecrou::Result<std::process::ExitCode> {
let code = ecrou::vm::run(
&RunOptions {
image: "ubuntu:resolute".into(),
command: vec!["uname".into(), "-a".into()],
..RunOptions::default()
},
&NoProgress,
)?;
Ok(std::process::ExitCode::from(code.clamp(0, 255) as u8))
}