Devcontainer WASM-Go

Simple devcontainer for Go development

Usage

Github Codespaces

Just click the button:

Visual Studio Code

Note this assumes that you have the VS code support for remote containers and docker installed on your machine.

git clone https://github.com/dev-wasm/dev-wasm-go
cd dev-wasm-go
code ./

Visual studio should prompt you to see if you want to relaunch the workspace in a container, you do.

Building and Running

Simple example

tinygo build -target=wasi -o main.wasm main.go
wasmtime main.wasm --dir .

WASM Web serving with WASI-HTTP

There is an example of web serving via the WASI-HTTP API in webserver/wasi-http.

To build:

cd webserver/wasi-http
tinygo build -o main.wasm -target=wasi main.go

To run it, you will need to install the wasi-go runtime as wasmtime does not support serving (yet).

# Only needed once to install the wasirun binary
go install github.com/stealthrocket/wasi-go@v0.8.0

wasirun --http-server-add localhost:8080 --http v1 main.wasm

Once it is running you can connect to it via http://localhost:8080

WASM CGI web serving with lighttpd

There is an example of web serving via WebAssembly + CGI (WAGI) in the webserver/wagi directory. It uses the lighttpd web server and mod_cgi. See the webserver/lighttpd.conf file for more details.

tinygo build -target=wasi -o wagi.wasm webserver/wagi.go
lighttpd -D -f webserver/lighttpd.conf

Once the server is running, VS Code or Codespaces should prompt you to connect to the open port.

HTTP Client Example

There is a more complicated example in the http directory which shows an example of making an HTTP client call using the experimental wasi+http support in wasmtime-http.

Mossaka/dev-wasm-go