runc

Crates.iorunc
lib.rsrunc
version0.2.0
sourcesrc
created_at2022-02-11 17:49:00.074264
updated_at2022-03-10 23:55:09.686552
descriptionA crate for consuming the runc binary in your Rust applications
homepagehttps://containerd.io
repositoryhttps://github.com/containerd/rust-extensions
max_upload_size
id530852
size90,795
Maksym Pavlenko (mxpv)

documentation

README

Rust bindings for runc CLI

Crates.io docs.rs Crates.io CI

A crate for consuming the runc binary in your Rust applications, similar to go-runc for Go. This crate is based on archived rust-runc.

Usage

Both sync/async version is available. You can build runc client with RuncConfig in method chaining style. Call build() or build_async() to get client. Note that async client depends on tokio, then please use it on tokio runtime.

use runc;

#[tokio::main]
async fn main() {
    let config = runc::Config::new()
        .root("./new_root")
        .debug(false)
        .log("/path/to/logfile.json")
        .log_format(runc::LogFormat::Json)
        .rootless(true);

    let client = config.build_async().unwrap();

    let opts = runc::options::CreateOpts::new()
        .pid_file("/path/to/pid/file")
        .no_pivot(true);
    
    client.create("container-id", "path/to/bundle", Some(&opts)).unwrap();
}

Limitations

  • Supported commands are only:
    • create
    • start
    • state
    • kill
    • delete
  • Exec is not available in RuncAsyncClient now.
  • Console utilites are not available
Commit count: 551

cargo fmt