Skip to content

containerd/runwasi

Repository files navigation

runwasi logo

runwasi

This is a project to facilitate running wasm workloads managed by containerd either directly (ie. through ctr) or as directed by Kubelet via the CRI plugin. It is intended to be a (rust) library that you can take and integrate with your wasm host. Included in the repository is a PoC for running a plain wasi host (ie. no extra host functions except to support wasi system calls).

Community

See our Community Page for more ways to get involved.

Documentation

For comprehensive documentation, visit our Documentation Site.

For containerd-shim-wasm crate documentation, visit containerd-shim-wasm.

Quick Start

Installation

make build
sudo make install

For detailed installation instructions, see the Installation Guide.

Running an Example

# Pull the image
sudo ctr images pull ghcr.io/containerd/runwasi/wasi-demo-app:latest

# Run the example
sudo ctr run --rm --runtime=io.containerd.wasmtime.v1 ghcr.io/containerd/runwasi/wasi-demo-app:latest testwasm

For more examples and detailed usage, see the Demos.

Projects Using Runwasi

Check out these projects that build on top of runwasi:

Contributing

To begin contributing, please read our Contributing Guide.