Skip to content

Facilitates running Wasm / WASI workloads managed by containerd

License

Notifications You must be signed in to change notification settings

jprendes/runwasi

 
 

Repository files navigation

runwasi logo

runwasi

CI status crates.io docs.rs Downloads website

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.

About

Facilitates running Wasm / WASI workloads managed by containerd

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 91.3%
  • Makefile 4.4%
  • Shell 2.4%
  • WebAssembly 1.0%
  • Python 0.5%
  • Dockerfile 0.2%
  • Other 0.2%