#containerd

app containerd-runc-shim

Rust implementation of containerd's runc v2 shim runtime

2 releases

0.1.1 Mar 11, 2022
0.1.0 Mar 11, 2022

#15 in #containerd

Apache-2.0

365KB
8K SLoC

Rust containerd shim v2 for runc container

Crates.io docs.rs Crates.io CI

By default containerd relies on runc shim v2 runtime (written in Go) to launch containers. This crate is an alternative Rust implementation of the shim runtime. It conforms to containerd's integration tests and can be replaced with the original Go runtime interchangeably.

Usage

To build binary, run:

cargo build --release --bin containerd-shim-runc-v2-rs

Replace it to the containerd shim dir: /usr/local/bin/containerd-shim-runc-v2-rs

In order to use it from containerd, use:

$ sudo ctr run --rm --runtime io.containerd.runc.v2-rs -t docker.io/library/hello-world:latest hello

You can run a container by ctr, crictl or kubernetes API.

Dependencies

~9–20MB
~321K SLoC