WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

このラボでは、生徒ひとりひとりにターミナルを渡します。中には、Bytecode Alliance の WebAssembly ランタイム Wasmtime と、WebAssembly のテキスト形式で書いた小さなプログラムとコンポーネントが入っていて、全部を読み通せる短さです。最初の WASI プログラム、許可されたフォルダーからだけファイルを表示するプログラム、渡された変数だけを一覧にするプログラム、WIT のインターフェースで説明したコンポーネント、1つに合成した2つのコンポーネント、WASI 0.2 向けと WASI 0.3 向けのコンポーネント、そして行儀の悪いプラグインが2つです。

Wasmtime は 50.0.1 に固定しているので、どのコピーも同じ結果を表示します。攻撃のラボではありません。どのコピーもインターネットにも、ほかの生徒にもつながらず、何もダウンロードされません。

生徒が学ぶこと

ブラウザーの外の WebAssembly とは何か、なぜ使うのかを学びます。どこでも動く1つのファイル、インポート以外には届かないサンドボックス、そして .wasm ファイルを LEB128 のサイズまでセクションごとに読むことです。--dir でフォルダーを許可し、その外へ上がるパスが WASI error 63 で断られる様子を見て、--env で環境変数を1つ許可します。WIT のワールドを読み、コンポーネントの add を呼び、インポートを満たすものがなくて断られるコンポーネントを見て、2つを1つに合成したものを動かすと 42 と出ます。WASI 0.2 向けと WASI 0.3 向けのコンポーネントを1つずつ動かし、0.3 を切って違いを見ます。最後に、終わらないプラグインをタイムアウトと燃料で止め、メモリーを16ページに制限します。システム、クラウド、セキュリティの講座に向いています。正確な文言は、お使いの資格団体の単元で確認してください。ここには引用していません。

ブラウザーで実行する

ラボは、1つのフォルダーを共有する2つのサービスを起動します。tools には Python とシェルがあり、最初の起動のときに、プログラム、コンポーネント、data と private の2つのフォルダーを書き出します。何もダウンロードしません。wasm は Wasmtime だけを動かすので、ターミナルからは docker exec wasm wasmtime で、Python には docker exec tools で届きます。ウェブページはありません。

  1. コンテナーのページを開く. バーの「つくる」を開き、「コンテナーを実行」を選びます。ページは誰でも開けて、Git ラボと SQL ラボはアカウントなしで起動できます。ほかのラボには無料アカウントが必要です。アカウントを作成してサインインし、「起動」を押します。
  2. ラボを探す. 「サンプルラボ」のカードにすべてのサンプルが並んでいます。WebAssembly:Wasmtime、WASI、コンポーネントを探します。
  3. 「起動」を押す. 「起動」はそのまま1回の操作で実行します。「先にファイルを編集」は compose ファイルを開くので、起動する前に変更できます。
  4. 開く. ラボのページで「ターミナルを開く」を押し、docker exec wasm wasmtime run hello.wat と入力すると、Hello from WebAssembly と表示されます。次に docker exec wasm wasmtime run --dir data cat.wat notes.txt と入力すると、プログラムが許可された1つのフォルダーからファイルを読む様子が見られます。

生徒に提出してもらうもの

自分で行った実験1つの短い報告を提出してもらいます。たとえば、許可したフォルダーと届かなかったパス、コンポーネントに足して合成し直した関数、プラグインに要った最小の燃料とメモリーなどです。入力したコマンドと、Wasmtime の表示を添えます。そこに、分かったことを自分の言葉で1、2文書いてもらいます。自動では採点されません。この文が、理解できたかどうかを示します。さらに力を見たいときは、インポートが足りないコンポーネントが、なぜコードを1行も動かす前に断られるのかを説明してもらいます。

このラボの基本レッスン

WebAssembly Basics は、このラボで進める小さなレッスンです。生徒は最初のプログラムを動かし、何も許可せずに、次にフォルダーを1つ許可してファイルを求め、環境変数を1つ許可し、コンポーネントを呼び、1つに合成した2つのコンポーネントを動かし、終わらないプログラムを燃料の予算で止めます。

無料の個人アカウントでは「ホーム」にある Basics モジュールに入っていて、どの学校もライブラリーの Basics フォルダーからコピーできます。あえて小さくしてあり、ラボで進めるレッスンがどういうものかを先生に見せる役目です。あとはラボが受け持ちます。変更したいときは、自分のモジュールにコピーしてください。大学向けモジュール「WebAssembly コンポーネントと WASI」も、同じラボで進めます。

GitHub のコード

compose ファイルには Dockerfile がありません。公開されている既存のイメージを2つ使い、どちらも権限のない専用アカウントで、ケイパビリティなしで動かします。1つは公式の python:3.12.15-alpine で、メモリーは 64 MB です。もう1つは、ダイジェストで固定した私たち自身の Wasmtime 50.0.1 のイメージで、メモリーは 128 MB です。Bytecode Alliance はイメージを公開していないので、公開リポジトリ mitsurutech/wasmtime-image が、そのリリースアーカイブを SHA-256 で確かめてからイメージを作っています。中の wasmtime プログラムは arm64 でも amd64 でも手を加えていません。Wasmtime のライセンスは LLVM の例外つきの Apache-2.0 で、そのライセンスはイメージの中に入っています。ファイルは最初の起動のときに固定の文章からボリュームに書き出すので、生徒の変更は止めて起動しても残ります。限界もあります。ラボにはコンパイラーもコンポーネントの道具もないので、どのモジュールも手書きのテキストで、async のコンポーネントもありません。

課題として出す

何を提出するかを課題に書いておきます。

  1. ラボを作る. モジュールで課題を追加し、「コンテナーラボ」のカードを選んでから「GitHub リポジトリ」を選びます。https://github.com/mitsurutech/lab-wasm-lab とブランチ main を指定します。compose ファイルは既定の compose.yaml です。変更したい場合は、たとえば自分のコンポーネントや許可する別のフォルダーを足すときは、先にリポジトリをフォークしてください。
  2. 公開して試す. 「公開」すると、確認したコミットに固定されるので、あとでリポジトリを変更しても、すでに出したラボは変わりません。まず自分のコピーを起動してください。
  3. 配布する. ほかの課題と同じように配布します。期限を付けることもでき、課題には何をするか、何を提出するかを書いておきます。
  4. 提出物を採点する. 生徒のコピーを開いて提出された内容を確認し、採点します。足りない場合は理由を書いて差し戻します。

このラボを試す、そして費用

無料の個人アカウントで、このラボの基本レッスンに取り組めます。毎月、ほとんどのレッスンに足りる無料クレジットがあり、カードは要りません。クラスで使う場合、学校は最初の365日間、生徒50人まで無料で、その後は生徒1人あたりの年額です。すべてのラボが含まれ、教職員は無料です。

よくある質問

ターミナルで docker exec wasm wasmtime を使うのはなぜですか。
ラボのターミナルにはいくつかのクライアントが入っていますが、Wasmtime はありません。docker exec wasm は、Wasmtime があってシェルのない wasm サービスの中でコマンドを実行します。そのため、コマンドはいつも wasmtime のあとに、することを続けます。シェルが要るときは docker exec -it tools sh を使います。
プログラムを Rust や C からコンパイルせず、テキストで書いているのはなぜですか。
Wasmtime と一緒にコンパイラーやコンポーネントの道具を持つ固定済みのイメージがなく、ラボは起動しても何もダウンロードしないからです。Wasmtime は WebAssembly のテキスト形式を直接読めるので、プログラムとコンポーネントはそれで手書きしてあり、全部を読み通せます。cargo-component、componentize-py、jco が言語から同じ種類のコンポーネントをどう作るかは、レッスンで説明します。
ラボで WASI 0.3 の async のコードは動きますか。
Wasmtime 50 は WASI 0.3 を既定で有効にしていて、ラボは WASI 0.3 のインターフェースをインポートするコンポーネントを動かします。ただし、ラボに async のコンポーネントはありません。手書きでは読めたものではないからです。async 関数とストリームはレッスンで説明します。
Wasmtime のイメージはどこから来ていますか。
誰でも読める公開リポジトリ mitsurutech/wasmtime-image から来ています。Bytecode Alliance のリリースアーカイブをダウンロードし、SHA-256 を確かめてから、wasmtime をそのままコピーしています。ラボはその結果をダイジェストで固定しているので、知らないうちに変わることはありません。ほかのラボのサービスと同じく、権限のない専用アカウントで、ケイパビリティなしで動き、インターネットへの出口もありません。