Ein Programm, das nur anfasst, was du ihm gibst
WebAssembly ist ein kleines Binärformat für Programme, das auf jedem Rechner mit einer Laufzeitumgebung läuft. Außerhalb des Browsers führt es Plugins und Werkzeuge in einer Sandbox aus: Das Programm erreicht keine Datei, keine Einstellung und kein Netzwerk, solange die Laufzeitumgebung es ihm nicht ausdrücklich gibt. In diesem Lab läuft Wasmtime, die Laufzeitumgebung der Bytecode Alliance.
Am Ende dieser Lektion
Notiz
Ich kann ein WebAssembly-Programm mit Wasmtime starten und ihm nur das geben, was es braucht.
Schlüsselwörter
- WebAssembly: ein portables Binärformat für Programme.
- Laufzeitumgebung: das Programm, das WebAssembly ausführt, hier Wasmtime.
- WASI: der Standardweg, auf dem ein WebAssembly-Programm nach Dateien und Einstellungen fragt.
- Capability: eine Sache, die ein Programm bekommen hat, etwa ein Ordner.
- Komponente: ein WebAssembly-Programm mit typisierten Importen und Exporten.
- Fuel: ein Arbeitsbudget, das ein Programm stoppt, sobald es aufgebraucht ist.
Zum Einstieg: was du schon weißt
Notiz
Antworte im Kopf. 1. Läuft ein Programm, das für einen Laptop gebaut wurde, unverändert auf einem Handy? 2. Wozu gibt es Rechte für Ordner? 3. Warum würdest du das Programm einer fremden Person nicht auf deinem eigenen Rechner starten? Antworten: meistens nicht, es wurde für eine Art Prozessor gebaut; um festzulegen, wer Dateien lesen oder ändern darf; es könnte deine Dateien lesen oder löschen.
Bevor du anfängst
Notiz
Klicke oben in der Leiste dieser Lektion auf Lab starten und warte, bis dort steht, dass es läuft. Es gibt zwei Dienste. wasm führt Wasmtime aus und hat keine Shell, darum beginnt jeder Befehl mit docker exec wasm wasmtime .... tools hat Python und eine Shell, und beide sehen denselben Ordner. Jede Schaltfläche Ausführen unten tippt ihren Befehl ins Terminal deines Labs, einen nach dem anderen in derselben Sitzung. Wenn du zuschauen oder eigene Befehle tippen willst, klicke in der Leiste auf Terminal öffnen (neuer Tab).
Ein erstes Programm starten
hello.wat ist ein WebAssembly-Programm im Textformat, das Wasmtime direkt liest. Es verlangt von WASI genau eine Sache, eine Möglichkeit, Text zu schreiben, und gibt Hello from WebAssembly aus.
docker exec wasm wasmtime run hello.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Ohne Freigabe nach einer Datei fragen
cat.wat gibt eine Datei aus. Hier wurde kein Ordner freigegeben, also weiß es nicht, wo es suchen soll, und gibt cannot open notes.txt: WASI error 8 aus. Die Datei liegt direkt im Ordner data, aber das Programm hat diesen Ordner nicht bekommen.
docker exec wasm wasmtime run cat.wat notes.txtHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Einen Ordner freigeben
Die Option --dir data gibt dem Programm den Ordner data und sonst nichts. Jetzt gibt es die englische Einkaufsliste aus: Shopping for Saturday, bread, milk, eggs. Ein Pfad, der aus dem Ordner hinausführt, etwa ../private/key.txt, würde weiterhin abgelehnt.
docker exec wasm wasmtime run --dir data cat.wat notes.txtHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Eine Einstellung freigeben
env.wat listet seine Umgebungsvariablen auf. Wasmtime reicht keine weiter, solange man es nicht sagt, ein Passwort in den Einstellungen des Hosts bleibt also privat. Mit --env CITY=Leeds gibt es CITY=Leeds aus und sonst nichts.
docker exec wasm wasmtime run --env CITY=Leeds env.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Prüfe dich
Tipp
Warum ist cat.wat beim ersten Mal gescheitert, obwohl notes.txt existiert? Antwort: Es war kein Ordner freigegeben, also hatte das Programm keinen Weg zu irgendeiner Datei.
Eine Komponente beim Namen aufrufen
calc.wat ist eine Komponente: ein Programm mit typisierten Funktionen, beschrieben in calc.wit. Wasmtime ruft ihre Funktion add mit den Zahlen 2 und 3 auf und gibt 5 aus.
docker exec wasm wasmtime run --invoke 'add(2, 3)' calc.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Zwei Komponenten zu einer verbunden
doubler.wat braucht eine Funktion add, die es selbst nicht hat. app.wat verbindet es mit calc.wat, also nutzt doubler das add von calc. Soll es 21 verdoppeln, gibt es 42 aus. Allein gestartet würde doubler abgelehnt, weil ihm niemand add gibt.
docker exec wasm wasmtime run --invoke 'double(21)' app.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Ein Programm ohne Ende stoppen
spin.wat läuft in einer Endlosschleife. Mit einem Budget von 100000 Einheiten Fuel läuft es, bis das Budget verbraucht ist, und Wasmtime stoppt es mit wasm trap: all fuel consumed by WebAssembly. Wasmtime selbst läuft weiter.
docker exec wasm wasmtime run -W fuel=100000 spin.watHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Ein häufiger Fehler
Warnung
Viele denken, ein WebAssembly-Programm könne alles lesen, was die Person lesen kann, die es startet. Es kann aber nur nutzen, was Wasmtime ihm gibt, etwa einen Ordner oder eine Einstellung. Gib ihm das Wenigste, was es braucht, denn alles, was du freigibst, kann es auch nutzen.
Abschlusscheck
Tipp
Antworte, ohne zurückzublättern. 1. Welche Option gibt einem Programm einen Ordner? 2. Welche Umgebungsvariablen sieht ein Programm, wenn du nichts angibst? 3. Warum wurde doubler.wat allein abgelehnt? 4. Was stoppt ein Programm, das nie endet? Antworten: --dir; keine; niemand gab ihm add; ein Fuel-Budget oder ein Zeitlimit.
Für Lehrkräfte
Tipp
Diese Lektion ist ein kleines Beispiel für eine Lektion, die in einem Lab abläuft: Die Schritte und die Schaltflächen „Ausführen“ sind die Lektion, und das Lab ist die eigene Kopie jeder lernenden Person. Das Lab hat zwei Dienste, Wasmtime ohne Shell und einen Python-Dienst, der die Dateien schreibt, und nichts hier bewertet sich selbst: Die Lernenden geben einen kurzen Bericht über ein eigenes Experiment ab, mit den Befehlen und dem, was Wasmtime ausgegeben hat. Wichtigste Lernpunkte: 1. Ein WebAssembly-Programm erreicht nur, was die Laufzeitumgebung freigibt. 2. Eine Komponente hat typisierte Importe und Exporte, und zwei lassen sich verbinden. 3. Fuel oder ein Zeitlimit stoppt ein außer Kontrolle geratenes Programm. Häufiger Fehler: zu glauben, das Programm könne alles lesen, was sein Benutzer lesen kann. Die Ausgaben des Labs sind englisch. Material: das Lab und ein Browser. Tipp: Zeigen Sie vor dem dritten Befehl die Ordner data und private nebeneinander. Kopieren Sie die Lektion in Ihr eigenes Modul und ändern Sie sie, oder bauen Sie im Lektionseditor über das Menü Lab eine neue von Grund auf.