渡したものにしか触れないプログラム
WebAssembly は、プログラムを入れる小さなバイナリ形式で、ランタイムがあればどの機械でも動きます。ブラウザーの外では、プラグインや道具をサンドボックスの中で動かします。ランタイムが渡すように言われないかぎり、プログラムはファイルにも設定にもネットワークにも届きません。このラボでは、Bytecode Alliance のランタイム Wasmtime を動かします。
このレッスンが終わると
メモ
Wasmtime で WebAssembly のプログラムを動かし、必要なものだけを渡すことができます。
キーワード
- WebAssembly:どの機械でも動く、プログラムのバイナリ形式。
- ランタイム:WebAssembly を動かすプログラム。ここでは Wasmtime。
- WASI:WebAssembly のプログラムがファイルや設定を求めるときの標準の方法。
- ケイパビリティ:プログラムに渡した1つのもの。たとえばフォルダー。
- コンポーネント:型のついたインポートとエクスポートを持つ WebAssembly のプログラム。
- 燃料:使い切るとプログラムを止める、仕事の予算。
はじめに:もう知っていること
メモ
頭の中で答えてください。1. ノートパソコン向けに作ったプログラムは、スマホでそのまま動きますか。2. フォルダーのアクセス権は何のためにありますか。3. 知らない人のプログラムを自分のパソコンで動かさないのはなぜですか。答え: たいてい動かない。1種類のプロセッサー向けに作られているから。誰がファイルを読んだり変えたりできるかを決めるため。ファイルを読まれたり消されたりするかもしれないから。
始める前に
メモ
レッスンの上のバーにある ラボを開始 を押し、動いていると表示されるまで待ちます。サービスは2つです。wasm は Wasmtime を動かすだけでシェルがないので、どの実行も docker exec wasm wasmtime ... の形です。tools には Python とシェルがあり、2つは同じフォルダーを見ています。下の 実行 ボタンは、それぞれのコマンドをラボのターミナルに、同じセッションの中で順番に入力します。様子を見たいときや自分で入力したいときは、バーの ターミナルを開く を押します。
最初のプログラムを動かす
hello.wat は、テキスト形式で書いた WebAssembly のプログラムで、Wasmtime はそのまま読めます。WASI に求めるのは文字を書く方法ひとつだけで、Hello from WebAssembly と表示します。
docker exec wasm wasmtime run hello.watここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
何も許可せずにファイルを求める
cat.wat はファイルの中身を表示します。ここではフォルダーを1つも許可していないので、探す場所がなく、cannot open notes.txt: WASI error 8 と表示します。ファイルは data フォルダーにちゃんとありますが、プログラムはそのフォルダーを渡されていません。
docker exec wasm wasmtime run cat.wat notes.txtここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
フォルダーを1つ許可する
オプション --dir data は、data フォルダーだけをプログラムに渡します。今度は買い物リストが表示されます。Shopping for Saturday、bread、milk、eggs、つまり土曜日の買い物、パン、牛乳、卵です。../private/key.txt のように、フォルダーの外へ上がるパスは、それでも断られます。
docker exec wasm wasmtime run --dir data cat.wat notes.txtここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
設定を1つ許可する
env.wat は自分の環境変数を一覧にします。Wasmtime は言われないかぎり1つも渡さないので、ホストの設定にあるパスワードは知られません。--env CITY=Leeds を付けると CITY=Leeds だけが表示されます。Leeds はイギリスの町の名前です。
docker exec wasm wasmtime run --env CITY=Leeds env.watここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
確認
ヒント
notes.txt はあるのに、cat.wat が最初に失敗したのはなぜですか。答え: フォルダーを許可していなかったので、プログラムにはどのファイルにも届く手段がなかったからです。
コンポーネントを名前で呼ぶ
calc.wat はコンポーネントです。型のついた関数を持つプログラムで、その説明が calc.wit にあります。Wasmtime はその add を数 2 と 3 で呼び、5 と表示します。
docker exec wasm wasmtime run --invoke 'add(2, 3)' calc.watここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
2つのコンポーネントを1つにつなぐ
doubler.wat には add 関数が必要ですが、自分では持っていません。app.wat はそれを calc.wat とつなぐので、doubler は calc の add を使えます。21 を2倍するように頼むと 42 と表示します。doubler だけで動かすと、add を渡すものがないので断られます。
docker exec wasm wasmtime run --invoke 'double(21)' app.watここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
終わらないプログラムを止める
spin.wat はいつまでもループします。燃料 100000 の予算を与えると、予算を使い切るまで動き、Wasmtime が wasm trap: all fuel consumed by WebAssembly で止めます。Wasmtime 自身は動き続けます。
docker exec wasm wasmtime run -W fuel=100000 spin.watここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
よくある間違い
注意
WebAssembly のプログラムは、動かしている人が読めるものなら何でも読める、と考える人は多いです。使えるのは、Wasmtime が渡したものだけです。たとえばフォルダー1つや設定1つです。必要な最小限だけを渡しましょう。 渡したものは何でも使えるからです。
最後の確認
ヒント
見返さずに答えてください。1. プログラムにフォルダーを渡すオプションはどれですか。2. プログラムは、ふだんどの環境変数を見られますか。3. doubler.wat が単独では断られたのはなぜですか。4. 終わらないプログラムを止めるのは何ですか。答え: --dir。1つも見られない。add を渡すものがなかったから。燃料の予算か、時間の上限。
先生へ
ヒント
このレッスンは、ラボで進めるレッスンの小さな例です。手順と実行ボタンがレッスンで、ラボは生徒ひとりひとりのコピーです。ラボはサービスが2つで、シェルのない Wasmtime と、ファイルを書き出す Python のサービスです。自動採点はありません。生徒は自分で行った実験1つの短い報告を、入力したコマンドと Wasmtime の表示を添えて提出します。学習のポイント:1. WebAssembly のプログラムは、ランタイムが許可したものにしか届かない。2. コンポーネントには型のついたインポートとエクスポートがあり、2つをつなげられる。3. 燃料か時間の上限が、止まらないプログラムを止める。よくある思い込み:プログラムは使う人が読めるものなら何でも読めると考えること。用意するもの:ラボとブラウザー。ヒント:3つ目の実行の前に、data と private のフォルダーを並べて見せてください。ご自分のモジュールにコピーして変更するか、レッスンビルダーのラボメニューから一から作ってください。