Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

Grundlagen von WebAssembly

Die ganze Lektion ist kostenlos und interaktiv. Lesen Sie sie hier, oder drücken Sie „Lab starten“, um sie wirklich in einem Live-Lab auszuführen, ganz ohne Konto.

Container-Lab10 Min. Lesezeit7 Befehle

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.

Befehl
docker exec wasm wasmtime run hello.wat

Hier 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.

Befehl
docker exec wasm wasmtime run cat.wat notes.txt

Hier 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.

Befehl
docker exec wasm wasmtime run --dir data cat.wat notes.txt

Hier 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.

Befehl
docker exec wasm wasmtime run --env CITY=Leeds env.wat

Hier 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.

Befehl
docker exec wasm wasmtime run --invoke 'add(2, 3)' calc.wat

Hier 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.

Befehl
docker exec wasm wasmtime run --invoke 'double(21)' app.wat

Hier 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.

Befehl
docker exec wasm wasmtime run -W fuel=100000 spin.wat

Hier 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.

Über dieses Lab und seinen Quellcode: WebAssembly-Lab: Wasmtime, WASI-Capabilities, WIT-Komponenten und Plugin-Grenzen

Sie unterrichten eine Klasse? Weisen Sie diese Lektionen Ihren Lernenden zu, mit Bewertung und einem Lab für jede lernende Person.