wasmCloud Tutorials

This repository contains assets to start understanding wasmCloud as a technology.

About | WASM | Component Model | NATS | wasmCloud Components | wasmCloud Providers | Kubernetes Demo | License

---

About

This repository aims at providing an overview of the most important aspects of wasmCloud using easily digestible tutorials. For a bit more background on wasmCloud, check out our recent blog post.

Usage

In order to easily provide the tools that you require for this tutorial, we have provided Devbox files for the various sections. You can install Devbox using the following command on Linux, Mac, or WSL2 for Windows:

curl -fsSL https://get.jetify.com/devbox | bash

Alternatively, you can use a container to run Devbox:

# once inside the container, run `cd /app`
docker run --rm --name devbox -v ./:/app -it jetpackio/devbox sh
# or using podman, note that you will need to make the current directory world read/writable:
# chmod -R o+rwx .
podman run --rm --name devbox -v ./:/app -it docker.io/jetpackio/devbox sh

WebAssembly

This repository does not contain an explicit introduction into WebAssembly, but build on top of it. If you are unfamiliar with WebAssembly, have a look at the official website.

The Component Model

The component model is central to wasmCloud. Check out a small tutorial on it under component-model/.

For more information on the component model, visit its page from the Bytecode Alliance.

NATS

NATS is a central technology to wasmCloud, essentially enabling the communication between WebAssembly components running on the platform. Check out a small tutorial on NATS under nats/.

wasmCloud Components

WasmCloud components are essentially identical to components in the component model. We have not designed a separate tutorial for wasmCloud components, but they can be seen in action in the provider tutorial or in the Kubernetes demo.

wasmCloud Providers

Providers expands the functionality space of components. Check out the tutorial at custom-provider/ to learn more about it.

Kubernetes Demo

WasmCloud is a very capable application platform. However, in most cases, one requires more flexibility to deploy services on a platform, especially since the WebAssembly adoption is not currently very strong. This it can make a lot of sense to combine wasmCloud with a Kubernetes platform to host standardized container workloads for services. We have designed a small demo on this in the kubernetes/ directory.

License

The license can be found under ./LICENSE.