WebAssembly-Lab: Wasmtime, WASI-Capabilities, WIT-Komponenten und Plugin-Grenzen

Dieses Lab gibt allen Lernenden ein Terminal mit Wasmtime, der WebAssembly-Laufzeitumgebung der Bytecode Alliance, und kleine Programme und Komponenten im WebAssembly-Textformat, kurz genug, um sie ganz zu lesen: ein erstes WASI-Programm, eines, das eine Datei nur aus einem freigegebenen Ordner ausgibt, eines, das nur die übergebenen Variablen auflistet, eine Komponente mit WIT-Schnittstelle, zwei Komponenten, die zu einer verbunden sind, je eine Komponente für WASI 0.2 und für WASI 0.3 und zwei Plugins, die sich danebenbenehmen.

Wasmtime ist auf 50.0.1 festgelegt, daher gibt jede Kopie dasselbe aus. Es ist kein Angriffs-Lab: Jede Kopie hat keinen Weg ins Internet und keinen zu anderen Lernenden, und es wird nichts hineingeladen.

Was Lernende lernen

Was WebAssembly außerhalb des Browsers ist und wozu: eine portable Datei, eine Sandbox, die nichts außer ihren Importen erreicht, und eine .wasm-Datei, Abschnitt für Abschnitt gelesen, bis hinunter zu den LEB128-Größen. Sie geben mit --dir einen Ordner frei und sehen, wie ein Pfad, der hinausführt, mit WASI error 63 abgelehnt wird, und geben mit --env eine Umgebungsvariable frei. Sie lesen eine WIT-Welt, rufen add einer Komponente auf, sehen eine Komponente abgelehnt, weil niemand ihren Import liefert, und starten zwei zu einer verbundene Komponenten, die 42 ausgeben. Sie starten eine Komponente für WASI 0.2 und eine für WASI 0.3 und schalten 0.3 aus, um den Unterschied zu sehen. Zuletzt stoppen sie ein Plugin ohne Ende mit einem Timeout und mit Fuel und deckeln seinen Speicher auf 16 Seiten. Es passt zu Kursen in Systemen, Cloud und IT-Sicherheit; prüfen Sie die genaue Formulierung in der Einheit Ihrer eigenen Prüfungsstelle, hier wird keine zitiert.

Im Browser ausführen

Das Lab startet zwei Dienste, die sich einen Ordner teilen. tools hat Python und eine Shell und schreibt beim ersten Start die Programme, die Komponenten und zwei Ordner, data und private, ohne etwas herunterzuladen. wasm führt Wasmtime aus und sonst nichts, darum erreicht das Terminal es mit docker exec wasm wasmtime und Python mit docker exec tools. Eine Webseite gibt es nicht.

  1. Container-Seite öffnen. Öffnen Sie in der Leiste „Entwickeln“ und wählen Sie „Einen Container ausführen“. Die Seite kann jeder öffnen, und das Git-Lab und das SQL-Lab starten ohne Konto. Alle anderen Labs brauchen ein kostenloses Konto: Erstellen Sie eines, melden Sie sich an und klicken Sie dann auf „Starten“.
  2. Lab suchen. Die Karte „Beispiel-Labs“ listet alle Beispiele auf. Suchen Sie WebAssembly: Wasmtime, WASI und Komponenten.
  3. Auf „Starten“ klicken. „Starten“ führt das Lab unverändert mit einem einzigen Klick aus. „Zuerst die Datei bearbeiten“ öffnet die Compose-Datei, damit Sie sie vor dem Start ändern können.
  4. Öffnen. Klicken Sie auf der Seite des Labs auf „Terminal öffnen“ und tippen Sie docker exec wasm wasmtime run hello.wat, um Hello from WebAssembly zu sehen. Tippen Sie dann docker exec wasm wasmtime run --dir data cat.wat notes.txt. Sie sehen, wie ein Programm eine Datei aus dem einen Ordner liest, der ihm freigegeben wurde.

Was Lernende abgeben sollen

Einen kurzen Bericht über ein eigenes Experiment, etwa einen freigegebenen Ordner und einen Pfad, der nicht erreichbar war, eine Funktion, die sie einer Komponente hinzugefügt und neu verbunden haben, oder das wenigste Fuel und den kleinsten Speicher, die ein Plugin brauchte, mit den getippten Befehlen und dem, was Wasmtime ausgegeben hat. Dazu ein oder zwei Sätze in eigenen Worten, was sie gefunden haben. Nichts wird automatisch bewertet: Der Satz zeigt, ob es verstanden wurde. Für anspruchsvollere Arbeiten lassen Sie erklären, warum eine Komponente mit fehlendem Import abgelehnt wird, bevor ihr Code überhaupt läuft.

Eine Basis-Lektion zu diesem Lab

WebAssembly Basics ist eine kleine Lektion, die in diesem Lab gearbeitet wird. Darin starten Lernende ein erstes Programm, fragen ohne Freigabe und dann mit einem Ordner nach einer Datei, geben eine Umgebungsvariable frei, rufen eine Komponente auf, starten zwei zu einer verbundene Komponenten und stoppen ein Programm ohne Ende mit einem Fuel-Budget.

Kostenlose persönliche Konten haben sie im Modul Basics, das auf der Startseite liegt, und jede Einrichtung kann sie aus dem Basics-Ordner der Bibliothek kopieren. Sie ist bewusst klein: Sie zeigt einer Lehrkraft, was eine im Lab gearbeitete Lektion ist, und das Lab leistet den Rest. Kopieren Sie sie in ein eigenes Modul, um sie zu ändern. Das Hochschulmodul WebAssembly-Komponenten und WASI wird im selben Lab bearbeitet.

Der Code auf GitHub

Die Compose-Datei hat kein Dockerfile: Sie startet zwei öffentliche Images, jedes mit einem unprivilegierten Konto ohne Capabilities. Das eine ist das offizielle python:3.12.15-alpine mit 64 MB. Das andere ist unser eigenes Image von Wasmtime 50.0.1, per Digest festgelegt, mit 128 MB: Die Bytecode Alliance veröffentlicht kein Image, deshalb baut das öffentliche Repository mitsurutech/wasmtime-image eines aus ihren Release-Archiven, per SHA-256 geprüft, mit unverändertem Programm wasmtime für arm64 und amd64. Wasmtime steht unter Apache-2.0 mit der LLVM-Ausnahme, und die Lizenz liegt im Image bei. Die Dateien werden beim ersten Start aus festem Text auf ein Volume geschrieben, daher übersteht eigene Arbeit Stoppen und Starten. Die Grenzen sind ehrlich: Im Lab gibt es keinen Compiler und kein Werkzeug für Komponenten, jedes Modul ist also handgeschriebener Text, und keine Komponente hier ist async.

Als Aufgabe stellen

Schreiben Sie in die Aufgabe, was abzugeben ist.

  1. Lab erstellen. Fügen Sie in Ihrem Modul eine Aufgabe hinzu und wählen Sie die Karte „Container-Lab“, dann „In einem GitHub-Repository“. Geben Sie https://github.com/mitsurutech/lab-wasm-lab mit dem Branch main an. Die Compose-Datei ist standardmäßig compose.yaml. Forken Sie das Repository zuerst, wenn Sie es ändern möchten, zum Beispiel für eine eigene Komponente oder einen weiteren Ordner zum Freigeben.
  2. Veröffentlichen und ausprobieren. „Veröffentlichen“ legt den Commit fest, den Sie gesehen haben. Eine spätere Änderung im Repository verändert also kein Lab, das Sie bereits gestellt haben. Starten Sie zuerst Ihre eigene Kopie.
  3. Zuweisen. Weisen Sie es wie jede Aufgabe zu, auf Wunsch mit Fälligkeitsdatum, und schreiben Sie in die Aufgabe, was zu tun ist und was abgegeben werden soll.
  4. Abgaben bewerten. Öffnen Sie die Kopie einer lernenden Person und die abgegebene Arbeit, bewerten Sie sie und geben Sie sie mit einer Begründung zur Überarbeitung zurück, wenn mehr nötig ist.

Dieses Lab ausprobieren, und was es kostet

Mit einem kostenlosen persönlichen Konto können Sie die Grundlagenlektionen in diesem Lab durcharbeiten, mit genug kostenlosem Guthaben pro Monat für die meisten Lektionen und ohne Karte. Für eine Klasse sind die ersten 365 Tage für eine Schule kostenlos, für bis zu 50 Lernende; danach zahlt sie je lernender Person und Jahr, alle Labs inklusive und Lehrkräfte kostenlos.

Häufige Fragen

Warum nutzt das Terminal docker exec wasm wasmtime?
Das Terminal des Labs enthält einige Clients, aber kein Wasmtime. docker exec wasm führt einen Befehl im Dienst wasm des Labs aus, der Wasmtime und keine Shell hat. Der Befehl ist also immer wasmtime, gefolgt von dem, was zu tun ist. Für eine Shell nutzen Sie docker exec -it tools sh.
Warum sind die Programme Text und nicht aus Rust oder C übersetzt?
Kein festgelegtes Image enthält neben Wasmtime einen Compiler oder Werkzeuge für Komponenten, und ein Lab lädt beim Start nichts herunter. Wasmtime liest das WebAssembly-Textformat direkt, daher sind Programme und Komponenten von Hand darin geschrieben und lassen sich ganz lesen. Die Lektionen erklären, wie cargo-component, componentize-py und jco dieselbe Art Komponente aus einer Sprache bauen.
Führt das Lab Async-Code für WASI 0.3 aus?
In Wasmtime 50 ist WASI 0.3 standardmäßig eingeschaltet, und das Lab startet eine Komponente, die eine Schnittstelle aus WASI 0.3 importiert. Keine Komponente im Lab ist async, weil eine von Hand geschriebene nicht lesbar wäre; Async-Funktionen und Streams erklären die Lektionen.
Woher kommt das Wasmtime-Image?
Aus dem öffentlichen Repository mitsurutech/wasmtime-image, das jeder lesen kann: Es lädt das Release-Archiv der Bytecode Alliance, prüft dessen SHA-256 und kopiert wasmtime unverändert hinein. Das Lab legt das Ergebnis per Digest fest, es kann sich also nicht unbemerkt ändern. Es läuft wie jeder Dienst eines Labs mit einem unprivilegierten Konto, ohne Capabilities und ohne Weg ins Internet.