¿Te resulta más fácil leer con fondo crema, un tono de color, más contraste o un texto más grande? Elige tus colores y tu texto una sola vez, para todas las páginas.

Lección gratuita

Fundamentos de WebAssembly

La lección completa es gratis e interactiva. Léela aquí, o pulsa Iniciar laboratorio para practicarla de verdad en un laboratorio en vivo, sin cuenta.

Laboratorio de contenedores10 min de lectura7 comandos

Un programa que solo toca lo que tú le das

WebAssembly es un formato binario pequeño para programas que funciona en cualquier máquina con un runtime. Fuera del navegador ejecuta plugins y herramientas en un entorno aislado: el programa no llega a ningún archivo, ajuste ni red salvo que se le diga al runtime que se lo entregue. Este laboratorio usa Wasmtime, el runtime de la Bytecode Alliance.

Al terminar esta lección

Nota

Puedo ejecutar un programa de WebAssembly con Wasmtime y concederle solo lo que necesita.

Palabras clave

  • WebAssembly: un formato binario portable para programas.
  • Runtime: el programa que ejecuta WebAssembly, aquí Wasmtime.
  • WASI: la forma estándar en que un programa de WebAssembly pide archivos y ajustes.
  • Capacidad: una cosa concreta que se le ha dado a un programa, como una carpeta.
  • Componente: un programa de WebAssembly con importaciones y exportaciones tipadas.
  • Combustible: un presupuesto de trabajo que para el programa cuando se acaba.

Para empezar: lo que ya sabes

Nota

Responde mentalmente. 1. ¿Un programa hecho para un portátil funciona sin cambios en un móvil? 2. ¿Para qué sirve el permiso de una carpeta? 3. ¿Por qué no ejecutarías en tu ordenador un programa de un desconocido? Respuestas: normalmente no, se hizo para un tipo de procesador; para decir quién puede leer o cambiar archivos; podría leer o borrar tus archivos.

Antes de empezar

Nota

Pulsa Iniciar el laboratorio en la barra de arriba de la lección y espera a que diga que está en marcha. Hay dos servicios. wasm ejecuta Wasmtime y no tiene shell, así que cada Ejecución es docker exec wasm wasmtime .... tools tiene Python y una shell, y los dos ven la misma carpeta. Cada botón Ejecutar de abajo escribe su comando en el terminal de tu laboratorio, uno detrás de otro en la misma sesión. Para verlos o escribir los tuyos, pulsa Abrir el terminal en la barra. Lo que imprime el laboratorio sale en inglés.

Ejecuta un primer programa

hello.wat es un programa de WebAssembly escrito en formato de texto, que Wasmtime lee directamente. Pide a WASI una sola cosa, una forma de escribir texto, e imprime Hello from WebAssembly.

Comando
docker exec wasm wasmtime run hello.wat

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Pide un archivo sin nada concedido

cat.wat imprime un archivo. Aquí no se concedió ninguna carpeta, así que no tiene dónde buscar e imprime cannot open notes.txt: WASI error 8. El archivo está ahí mismo, en la carpeta data, pero al programa no se le dio esa carpeta.

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Concede una carpeta

La opción --dir data entrega al programa la carpeta data y nada más. Ahora imprime la lista de la compra: Shopping for Saturday, bread, milk, eggs. Una ruta que sale de la carpeta, como ../private/key.txt, seguiría rechazada.

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Concede un ajuste

env.wat lista sus variables de entorno. Wasmtime no pasa ninguna si no se le pide, así que una contraseña guardada en los ajustes del anfitrión sigue siendo privada. Con --env CITY=Leeds imprime CITY=Leeds y nada más.

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Comprueba

Consejo

¿Por qué falló cat.wat la primera vez si notes.txt existe? Respuesta: no se concedió ninguna carpeta, así que el programa no tenía forma de llegar a ningún archivo.

Llama a un componente por su nombre

calc.wat es un componente: un programa con funciones tipadas, descritas en calc.wit. Wasmtime llama a su add con los números 2 y 3 e imprime 5.

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Ejecuta dos componentes unidos en uno

doubler.wat necesita una función add que no tiene. app.wat lo une con calc.wat, así que doubler usa el add de calc. Si le pides duplicar 21, imprime 42. Ejecutado solo, doubler se rechazaría porque nadie le da add.

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Para un programa que nunca termina

spin.wat repite un bucle para siempre. Con un presupuesto de 100000 unidades de combustible, corre hasta gastarlo, y Wasmtime lo para con wasm trap: all fuel consumed by WebAssembly. Wasmtime sigue funcionando.

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

Se muestra aquí y no se ejecuta. Pulsa Iniciar laboratorio para escribirlo en el terminal de tu propio laboratorio.

Un error frecuente

Advertencia

Mucha gente cree que un programa de WebAssembly puede leer todo lo que lee la persona que lo ejecuta. Solo puede usar lo que Wasmtime le entrega, como una carpeta o un ajuste. Dale lo mínimo que necesite, porque todo lo que le concedas lo puede usar.

Comprobación final

Consejo

Responde sin volver atrás. 1. ¿Qué opción entrega una carpeta a un programa? 2. ¿Qué variables de entorno ve un programa por defecto? 3. ¿Por qué se rechazó doubler.wat ejecutado solo? 4. ¿Qué para un programa que nunca termina? Respuestas: --dir; ninguna; nadie le daba add; un presupuesto de combustible o un tiempo límite.

Para los docentes

Consejo

Esta lección es un pequeño ejemplo de una lección practicada en un laboratorio: los pasos y los botones Ejecutar son la lección, y el laboratorio es la copia propia de cada alumno. El laboratorio son dos servicios, Wasmtime sin shell y un servicio de Python que escribe los archivos, y nada de lo que hay aquí se corrige solo: el alumno entrega un informe breve de un experimento propio con las órdenes y lo que imprimió Wasmtime. Ideas clave: 1. Un programa de WebAssembly solo alcanza lo que el runtime le concede. 2. Un componente tiene importaciones y exportaciones tipadas, y dos se pueden unir. 3. El combustible o un tiempo límite paran un programa desbocado. Error frecuente: creer que el programa lee todo lo que lee su usuario. Los mensajes del laboratorio salen en inglés. Material: el laboratorio y un navegador. Consejo: enseñe las carpetas data y private una al lado de otra antes de la tercera Ejecución. Cópiela en su propio módulo y modifíquela, o cree una desde cero con el menú Laboratorio del constructor de lecciones.

Sobre este laboratorio y su código: Laboratorio de WebAssembly: Wasmtime, capacidades de WASI, componentes WIT y límites de plugins

¿Enseñas a una clase? Asigna estas lecciones a tus estudiantes con calificación y un laboratorio para cada uno.