containerd/runwasi

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

• If you haven't joined the CNCF slack yet, you can do so here.
• Come join us on our slack channel #runwasi on the CNCF slack.
• Public Community Call on Tuesdays every other week at 9:00 AM PT: Zoom, Meeting Notes

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:

• spinkube/containerd-shim-spin
• deislabs/containerd-wasm-shims

Contributing

To begin contributing, please read our Contributing Guide.

Project Details

runwasi is a non-core containerd sub-project, licensed under the Apache 2.0 license. As a containerd sub-project, runwasi follows the containerd project's governance and contributing guidelines. Project maintainers are listed in MAINTAINERS.