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 で届きます。ウェブページはありません。
- コンテナーのページを開く. バーの「つくる」を開き、「コンテナーを実行」を選びます。ページは誰でも開けて、Git ラボと SQL ラボはアカウントなしで起動できます。ほかのラボには無料アカウントが必要です。アカウントを作成してサインインし、「起動」を押します。
- ラボを探す. 「サンプルラボ」のカードにすべてのサンプルが並んでいます。WebAssembly:Wasmtime、WASI、コンポーネントを探します。
- 「起動」を押す. 「起動」はそのまま1回の操作で実行します。「先にファイルを編集」は compose ファイルを開くので、起動する前に変更できます。
- 開く. ラボのページで「ターミナルを開く」を押し、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 のコンポーネントもありません。
課題として出す
何を提出するかを課題に書いておきます。
- ラボを作る. モジュールで課題を追加し、「コンテナーラボ」のカードを選んでから「GitHub リポジトリ」を選びます。https://github.com/mitsurutech/lab-wasm-lab とブランチ main を指定します。compose ファイルは既定の compose.yaml です。変更したい場合は、たとえば自分のコンポーネントや許可する別のフォルダーを足すときは、先にリポジトリをフォークしてください。
- 公開して試す. 「公開」すると、確認したコミットに固定されるので、あとでリポジトリを変更しても、すでに出したラボは変わりません。まず自分のコピーを起動してください。
- 配布する. ほかの課題と同じように配布します。期限を付けることもでき、課題には何をするか、何を提出するかを書いておきます。
- 提出物を採点する. 生徒のコピーを開いて提出された内容を確認し、採点します。足りない場合は理由を書いて差し戻します。
このラボを試す、そして費用
無料の個人アカウントで、このラボの基本レッスンに取り組めます。毎月、ほとんどのレッスンに足りる無料クレジットがあり、カードは要りません。クラスで使う場合、学校は最初の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 をそのままコピーしています。ラボはその結果をダイジェストで固定しているので、知らないうちに変わることはありません。ほかのラボのサービスと同じく、権限のない専用アカウントで、ケイパビリティなしで動き、インターネットへの出口もありません。