Lab WebAssembly : Wasmtime, capacités WASI, composants WIT et limites des plugins

Ce lab donne à chaque étudiant un terminal avec Wasmtime, le runtime WebAssembly de la Bytecode Alliance, et de petits programmes et composants écrits dans le format texte de WebAssembly, assez courts pour être lus en entier : un premier programme WASI, un programme qui n’affiche un fichier que depuis le dossier qu’on lui a accordé, un autre qui ne liste que les variables qu’on lui a données, un composant décrit par une interface WIT, deux composants réunis en un seul, un composant construit pour WASI 0.2 et un autre pour WASI 0.3, et deux plugins qui se conduisent mal.

Wasmtime est épinglé en version 50.0.1 : chaque copie affiche donc la même chose. Ce n’est pas un lab d’attaque : chaque copie n’a aucun accès à internet ni à aucun autre étudiant, et rien n’y est téléchargé.

Ce que les étudiants apprennent

Ce qu’est WebAssembly hors du navigateur, et pourquoi : un seul fichier portable, un bac à sable qui n’atteint rien d’autre que ses imports, et un fichier .wasm lu section par section, jusqu’à ses tailles en LEB128. Ils accordent un dossier avec --dir et voient un chemin qui en sort refusé avec WASI error 63, puis accordent une seule variable d’environnement avec --env. Ils lisent un monde WIT, appellent la fonction add d’un composant, voient un composant refusé parce que rien ne fournit son import, et lancent deux composants réunis en un seul, qui affiche 42. Ils lancent un composant construit pour WASI 0.2 et un autre pour WASI 0.3, puis désactivent 0.3 pour voir la différence. Enfin, ils arrêtent un plugin sans fin par un délai et par le carburant, et plafonnent sa mémoire à 16 pages. Il convient aux cours de systèmes, de cloud et de sécurité ; vérifiez la formulation exacte dans l’unité de votre propre organisme certificateur, aucune n’est citée ici.

Le lancer dans votre navigateur

Le lab démarre deux services qui partagent un même dossier. tools a Python et un shell, et écrit au premier démarrage les programmes, les composants et deux dossiers, data et private, sans rien télécharger. wasm fait tourner Wasmtime et rien d’autre : le terminal l’atteint donc avec docker exec wasm wasmtime, et Python avec docker exec tools. Il n’y a pas de page web.

  1. Ouvrir la page Conteneur. Ouvrez « Créer » dans la barre et choisissez « Lancer un conteneur ». Tout le monde peut ouvrir la page, et le lab Git et le lab SQL se lancent sans compte. Tous les autres labs demandent un compte gratuit : créez-en un, connectez-vous, puis appuyez sur « Démarrer ».
  2. Trouver le lab. La carte « Laboratoires d’exemple » liste tous les exemples. Trouvez WebAssembly : Wasmtime, WASI et composants.
  3. Appuyer sur Démarrer. « Démarrer » le lance tel quel, en un clic. « Modifier le fichier d’abord » ouvre le fichier compose pour que vous puissiez le changer avant de démarrer.
  4. L’ouvrir. Sur la page du lab, appuyez sur « Ouvrir le terminal » et tapez docker exec wasm wasmtime run hello.wat pour voir Hello from WebAssembly. Tapez ensuite docker exec wasm wasmtime run --dir data cat.wat notes.txt pour voir un programme lire un fichier dans le seul dossier qu’on lui a accordé.

Que demander aux étudiants de rendre

Un court compte rendu d’une expérience à eux, par exemple un dossier accordé et un chemin qu’ils n’ont pas pu atteindre, une fonction ajoutée à un composant puis recomposée, ou le minimum de carburant et de mémoire dont un plugin a eu besoin, avec les commandes tapées et ce que Wasmtime a affiché. Puis une ou deux phrases, avec leurs propres mots, sur ce qu’ils ont trouvé. Rien n’est noté automatiquement : la phrase montre si c’était compris. Pour un travail plus poussé, demandez d’expliquer pourquoi un composant dont un import manque est refusé avant que la moindre ligne de son code tourne.

Une leçon de base sur ce lab

WebAssembly Basics est une petite leçon qui se fait dans ce lab. L’étudiant y lance un premier programme, demande un fichier sans rien accorder puis avec un dossier, accorde une variable d’environnement, appelle un composant, lance deux composants réunis en un seul, et arrête avec un budget de carburant un programme qui ne finit jamais.

Un compte personnel gratuit la reçoit dans le module Basics, qui se trouve sur « Accueil », et chaque établissement peut la copier depuis le dossier Basics de la Bibliothèque. Elle est volontairement petite : elle montre à un enseignant ce qu’est une leçon qui se fait dans un lab, et le lab fait le reste. Copiez-la dans un module à vous pour la modifier. Le module universitaire Composants WebAssembly et WASI se travaille dans le même lab.

Le code sur GitHub

Le fichier compose n’a pas de Dockerfile : il lance deux images publiques, chacune avec un compte sans privilèges et sans capacités. L’une est l’image officielle python:3.12.15-alpine, avec 64 Mo. L’autre est notre propre image de Wasmtime 50.0.1, figée par son empreinte, avec 128 Mo : la Bytecode Alliance ne publie pas d’image, alors le dépôt public mitsurutech/wasmtime-image en construit une à partir de ses archives, vérifiées par SHA-256, sans toucher au programme wasmtime, pour arm64 comme pour amd64. Wasmtime est sous licence Apache-2.0 avec l’exception LLVM, et sa licence est fournie dans cette image. Les fichiers sont écrits à partir d’un texte fixe sur un volume, au premier démarrage : les modifications d’un étudiant survivent donc à un arrêt et à un redémarrage. Les limites sont honnêtes : le lab n’a ni compilateur ni outil de composants, donc chaque module est du texte écrit à la main, et aucun composant ici n’est async.

En faire un travail

Indiquez dans la tâche ce qu’il faut rendre.

  1. Créer le lab. Dans votre module, ajoutez une tâche et choisissez la carte « Lab de conteneurs », puis « Dans un dépôt GitHub ». Indiquez https://github.com/mitsurutech/lab-wasm-lab avec la branche main. Le fichier compose par défaut est compose.yaml. Faites d’abord un fork du dépôt si vous voulez le modifier, par exemple pour ajouter un composant à vous ou un autre dossier à accorder.
  2. Publier et l’essayer. « Publier » fige le commit qui vous a été montré : un changement ultérieur dans le dépôt ne modifie donc pas un lab que vous avez déjà proposé. Démarrez d’abord votre propre copie.
  3. Le distribuer. Attribuez-le comme n’importe quelle tâche, avec une échéance si vous le souhaitez, et indiquez dans la tâche ce qu’il faut faire et ce qu’il faut rendre.
  4. Noter ce qui est rendu. Ouvrez la copie d’un étudiant et le travail rendu, notez-le et renvoyez-le avec un motif s’il demande un complément.

Essayer ce lab, et ce qu’il coûte

Un compte personnel gratuit permet de suivre les leçons de base de ce lab, avec chaque mois assez de crédit gratuit pour suivre la plupart des leçons, sans carte. Pour une classe, un établissement a ses 365 premiers jours gratuits pour 50 élèves au plus, puis paie par élève et par an, tous les labs compris et les enseignants gratuits.

Questions fréquentes

Pourquoi le terminal utilise-t-il docker exec wasm wasmtime ?
Le terminal du lab contient quelques clients, mais pas Wasmtime. docker exec wasm lance une commande dans le service wasm du lab, qui a Wasmtime et pas de shell : la commande est donc toujours wasmtime, suivi de ce qu’il faut faire. Pour un shell, utilisez docker exec -it tools sh.
Pourquoi les programmes sont-ils écrits en texte, et non compilés depuis Rust ou C ?
Aucune image épinglée ne contient de compilateur ni d’outils de composants à côté de Wasmtime, et un lab ne télécharge rien au démarrage. Wasmtime lit directement le format texte de WebAssembly : les programmes et les composants y sont donc écrits à la main, et se lisent en entier. Les leçons expliquent comment cargo-component, componentize-py et jco fabriquent la même sorte de composant depuis un langage.
Le lab fait-il tourner du code async de WASI 0.3 ?
Wasmtime 50 active WASI 0.3 par défaut, et le lab lance un composant qui importe une interface WASI 0.3. Aucun composant du lab n’est async, car un composant async écrit à la main n’est pas lisible ; les fonctions async et les streams sont expliqués dans les leçons.
D’où vient l’image de Wasmtime ?
Du dépôt public mitsurutech/wasmtime-image, que chacun peut lire : il télécharge l’archive publiée par la Bytecode Alliance, vérifie son SHA-256 et copie wasmtime tel quel. Le lab fige le résultat par son empreinte, donc il ne peut pas changer sous vos pieds. Elle tourne avec un compte sans privilèges, sans capacités et sans accès à internet, comme chaque service de lab.