Plus facile à lire avec un fond crème, une teinte, plus de contraste ou un texte plus grand ? Choisissez vos couleurs et votre texte, une fois pour toutes les pages.

Leçon gratuite

Les bases de WebAssembly

La leçon entière est gratuite et interactive. Lisez-la ici, ou appuyez sur Démarrer le labo pour la pratiquer pour de vrai dans un labo en direct, sans compte.

Labo de conteneurs10 min de lecture7 commandes

Un programme qui ne touche que ce que tu lui donnes

WebAssembly est un petit format binaire pour les programmes, qui tourne sur n'importe quelle machine équipée d'un runtime. Hors du navigateur, il fait tourner des plugins et des outils dans un bac à sable : le programme n'atteint aucun fichier, aucun réglage et aucun réseau, sauf si l'on dit au runtime de les lui donner. Ce lab utilise Wasmtime, le runtime de la Bytecode Alliance.

À la fin de cette leçon

Remarque

Je peux lancer un programme WebAssembly avec Wasmtime et ne lui accorder que ce dont il a besoin.

Mots-clés

  • WebAssembly : un format binaire portable pour les programmes.
  • Runtime : le programme qui fait tourner WebAssembly, ici Wasmtime.
  • WASI : la façon standard dont un programme WebAssembly demande des fichiers et des réglages.
  • Capacité : une chose précise qu'on a donnée au programme, comme un dossier.
  • Composant : un programme WebAssembly avec des imports et des exports typés.
  • Carburant : un budget de travail qui arrête le programme quand il est épuisé.

Pour commencer : ce que tu sais déjà

Remarque

Réponds dans ta tête. 1. Un programme construit pour un ordinateur portable tourne-t-il tel quel sur un téléphone ? 2. À quoi sert un droit sur un dossier ? 3. Pourquoi ne lancerais-tu pas le programme d'un inconnu sur ton ordinateur ? Réponses : en général non, il a été construit pour un seul type de processeur ; à dire qui peut lire ou modifier les fichiers ; il pourrait lire ou effacer tes fichiers.

Avant de commencer

Remarque

Appuie sur Démarrer le lab dans la barre en haut de la leçon et attends qu'il indique qu'il est en marche. Il y a deux services. wasm fait tourner Wasmtime et n'a pas de shell, donc chaque bouton lance docker exec wasm wasmtime .... tools a Python et un shell, et les deux voient le même dossier. Chaque bouton Exécuter ci-dessous tape sa commande dans le terminal de ton lab, l'une après l'autre, dans la même session. Pour suivre les commandes ou taper les tiennes, appuie sur Ouvrir le terminal (nouvel onglet) dans la barre.

Lancer un premier programme

hello.wat est un programme WebAssembly écrit en format texte, que Wasmtime lit directement. Il demande une seule chose à WASI, un moyen d'écrire du texte, et il affiche Hello from WebAssembly. Les programmes du lab écrivent en anglais.

Commande
docker exec wasm wasmtime run hello.wat

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Demander un fichier sans rien accorder

cat.wat affiche un fichier. Ici, aucun dossier n'a été accordé : il n'a nulle part où chercher et affiche cannot open notes.txt: WASI error 8. Le fichier est pourtant là, dans le dossier data, mais le programme n'a pas reçu ce dossier.

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Accorder un seul dossier

L'option --dir data donne au programme le dossier data, et rien d'autre. Il affiche maintenant la liste de courses : Shopping for Saturday, bread, milk, eggs. Un chemin qui sort du dossier, comme ../private/key.txt, serait toujours refusé.

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Accorder un seul réglage

env.wat liste ses variables d'environnement. Wasmtime n'en transmet aucune sans qu'on le lui demande, donc un mot de passe rangé dans les réglages de la machine reste privé. Avec --env CITY=Leeds, il affiche CITY=Leeds, et rien de plus.

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Vérifie

Astuce

Pourquoi cat.wat a-t-il échoué la première fois alors que notes.txt existe ? Réponse : aucun dossier n'était accordé, donc le programme n'avait aucun moyen d'atteindre un fichier.

Appeler un composant par son nom

calc.wat est un composant : un programme avec des fonctions typées, décrites dans calc.wit. Wasmtime appelle sa fonction add avec les nombres 2 et 3, et elle affiche 5.

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Lancer deux composants réunis en un seul

doubler.wat a besoin d'une fonction add qu'il n'a pas. app.wat le relie à calc.wat, si bien que doubler utilise le add de calc. Pour doubler 21, il affiche 42. Lancé seul, doubler serait refusé, car rien ne lui fournit add.

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Arrêter un programme qui ne finit jamais

spin.wat tourne en boucle pour toujours. Avec un budget de 100000 unités de carburant, il tourne jusqu'à l'avoir dépensé, puis Wasmtime l'arrête avec wasm trap: all fuel consumed by WebAssembly. Wasmtime, lui, continue.

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

Affichée ici, non exécutée. Appuyez sur Démarrer le labo pour la saisir dans le terminal de votre propre labo.

Une erreur fréquente

Attention

Beaucoup pensent qu'un programme WebAssembly peut lire tout ce que peut lire la personne qui le lance. Il ne peut utiliser que ce que Wasmtime lui donne, comme un dossier ou un réglage. Donne-lui le minimum dont il a besoin, car tout ce que tu accordes, il peut s'en servir.

Vérification finale

Astuce

Réponds sans revenir en arrière. 1. Quelle option donne un dossier à un programme ? 2. Quelles variables d'environnement un programme voit-il par défaut ? 3. Pourquoi doubler.wat a-t-il été refusé seul ? 4. Qu'est-ce qui arrête un programme qui ne finit jamais ? Réponses : --dir ; aucune ; rien ne lui fournissait add ; un budget de carburant ou une limite de temps.

Pour les enseignants

Astuce

Cette leçon est un petit exemple de leçon travaillée dans un lab : les étapes et les boutons Exécuter sont la leçon, et le lab est la copie de chaque élève. Le lab compte deux services, Wasmtime sans shell et un service Python qui écrit les fichiers, et rien ici ne se corrige tout seul : l'élève rend un court compte rendu d'une expérience, avec les commandes tapées et ce que Wasmtime a affiché. Points clés : 1. Un programme WebAssembly n'atteint que ce que le runtime lui accorde. 2. Un composant a des imports et des exports typés, et on peut en réunir deux. 3. Le carburant ou une limite de temps arrête un programme emballé. Erreur fréquente : croire que le programme lit tout ce que son utilisateur peut lire. Matériel : le lab et un navigateur. Conseil : montrez côte à côte les dossiers data et private avant le troisième Exécuter. Copiez-la dans votre propre module et modifiez-la, ou créez-en une de zéro avec le menu Lab du créateur de leçons.

À propos de ce labo et de sa source: Lab WebAssembly : Wasmtime, capacités WASI, composants WIT et limites des plugins

Vous enseignez à une classe ? Proposez ces leçons à vos élèves avec correction et un labo pour chaque élève.