Laboratorio de WebAssembly: Wasmtime, capacidades de WASI, componentes WIT y límites de plugins
Este laboratorio da a cada alumno un terminal con Wasmtime, el runtime de WebAssembly de la Bytecode Alliance, y programas y componentes pequeños escritos en el formato de texto de WebAssembly, lo bastante cortos para leerlos enteros: un primer programa WASI, uno que imprime un archivo solo desde una carpeta concedida, otro que lista solo las variables que se le dieron, un componente descrito por una interfaz WIT, dos componentes compuestos en uno, un componente construido para WASI 0.2 y otro para WASI 0.3, y dos plugins que se portan mal.
Wasmtime está fijado en la versión 50.0.1, así que todas las copias imprimen lo mismo, y en inglés. No es un laboratorio de ataque: cada copia no tiene salida a internet ni acceso a ningún otro alumno, y no se descarga nada en ella.
Qué aprenden los alumnos
Qué es WebAssembly fuera del navegador y para qué sirve: un archivo portable, un entorno aislado que no alcanza nada más que sus importaciones, y un archivo .wasm leído sección a sección, hasta sus tamaños en LEB128. Conceden una carpeta con --dir y ven cómo una ruta que sale de ella se rechaza con WASI error 63, y conceden una variable de entorno con --env. Leen un mundo WIT, llaman al add de un componente, ven rechazado un componente porque nadie aporta su importación y ejecutan dos componentes compuestos en uno, que imprime 42. Ejecutan un componente construido para WASI 0.2 y otro para WASI 0.3, y desactivan 0.3 para ver la diferencia. Por último, paran un plugin que nunca termina con un tiempo límite y con combustible, y limitan su memoria a 16 páginas. Sirve para cursos de sistemas, nube y seguridad; consulta en la unidad de tu propio organismo certificador la redacción exacta, aquí no se cita ninguna.
Ejecútalo en tu navegador
El laboratorio inicia dos servicios que comparten una carpeta. tools tiene Python y una shell, y la primera vez que arranca escribe los programas, los componentes y dos carpetas, data y private, sin descargar nada. wasm ejecuta Wasmtime y nada más, así que el terminal llega a él con docker exec wasm wasmtime, y a Python con docker exec tools. No hay página web.
- Abre la página Contenedor. Abre «Crear» en la barra y elige «Ejecutar un contenedor». Cualquiera puede abrir la página, y el laboratorio de Git y el de SQL se inician sin cuenta. Todos los demás laboratorios necesitan una cuenta gratuita: crea una, inicia sesión y pulsa «Iniciar».
- Busca el laboratorio. La tarjeta «Laboratorios de ejemplo» lista todos los ejemplos. Busca WebAssembly: Wasmtime, WASI y componentes.
- Pulsa «Iniciar». «Iniciar» lo ejecuta tal cual, con una sola pulsación. «Editar el archivo primero» abre el archivo compose para que lo cambies antes de iniciarlo.
- Ábrelo. En la página del laboratorio, pulsa «Abrir terminal» y escribe docker exec wasm wasmtime run hello.wat para ver Hello from WebAssembly. Después escribe docker exec wasm wasmtime run --dir data cat.wat notes.txt para ver cómo un programa lee un archivo de la única carpeta que se le concedió.
Qué pedir a los alumnos que entreguen
Un informe breve de un experimento propio, por ejemplo una carpeta que concedieron y una ruta a la que no pudieron llegar, una función que añadieron a un componente y volvieron a componer, o el mínimo de combustible y memoria que necesitó un plugin, con las órdenes que escribieron y lo que imprimió Wasmtime. Y una o dos frases, con sus propias palabras, sobre lo que encontraron. Nada se califica automáticamente: la frase muestra si se entendió. Para un trabajo más avanzado, pide que expliquen por qué un componente con una importación que falta se rechaza antes de que corra nada de su código.
Una lección básica sobre este laboratorio
WebAssembly Basics es una lección pequeña que se hace en este laboratorio. En ella el alumno ejecuta un primer programa, pide un archivo sin nada concedido y luego con una carpeta, concede una variable de entorno, llama a un componente, ejecuta dos componentes compuestos en uno y para con un presupuesto de combustible un programa que nunca termina.
Las cuentas personales gratuitas la tienen en el módulo Basics, que está en Inicio, y cada centro puede copiarla de la carpeta Basics de la Biblioteca. Es pequeña a propósito: muestra a un docente lo que es una lección que se hace en un laboratorio, y el laboratorio hace el resto. Cópiala en un módulo tuyo para cambiarla. El módulo universitario Componentes de WebAssembly y WASI se hace en el mismo laboratorio.
El código en GitHub
El archivo compose no tiene Dockerfile: ejecuta dos imágenes públicas, cada una con una cuenta sin privilegios y sin capacidades. Una es la oficial python:3.12.15-alpine, con 64 MB. La otra es nuestra propia imagen de Wasmtime 50.0.1, fijada por digest, con 128 MB: la Bytecode Alliance no publica ninguna imagen, así que el repositorio público mitsurutech/wasmtime-image construye una con sus archivos de versión, comprobados con SHA-256, sin tocar el programa wasmtime, para arm64 y amd64. Wasmtime tiene licencia Apache-2.0 con la excepción de LLVM, y su licencia va dentro de esa imagen. Los archivos se escriben a partir de un texto fijo en un volumen la primera vez, así que los cambios de un alumno sobreviven a una parada y un arranque. Los límites son honestos: en el laboratorio no hay compilador ni herramientas de componentes, así que cada módulo es texto escrito a mano, y ningún componente de aquí es async.
Ponlo como tarea
Indica en la tarea qué entregar.
- Crea el laboratorio. En tu módulo añade una tarea y elige la tarjeta «Laboratorio de contenedores», y después «En un repositorio de GitHub». Indica https://github.com/mitsurutech/lab-wasm-lab con la rama main. El archivo compose es el predeterminado, compose.yaml. Haz un fork del repositorio antes si quieres modificarlo, por ejemplo para añadir un componente propio u otra carpeta que conceder.
- Publica y pruébalo. «Publicar» fija el commit que te mostraron, así que un cambio posterior en el repositorio no altera un laboratorio que ya has asignado. Inicia primero tu propia copia.
- Asígnalo. Asígnalo como cualquier tarea, con una fecha de entrega si quieres, e indica en la tarea qué hacer y qué entregar.
- Califica lo entregado. Abre la copia de un alumno y el trabajo que ha entregado, califícalo y devuélvelo con un motivo si necesita más.
Prueba este laboratorio, y lo que cuesta
Con una cuenta personal gratuita puedes seguir las lecciones básicas de este laboratorio, con crédito gratuito suficiente cada mes para seguir la mayoría de las lecciones y sin tarjeta. Para una clase, un centro tiene gratis sus primeros 365 días, hasta 50 alumnos, y después paga por alumno y año, con todos los laboratorios incluidos y el profesorado gratis.
Preguntas frecuentes
- ¿Por qué el terminal usa docker exec wasm wasmtime?
- El terminal del laboratorio lleva algunos clientes, pero no Wasmtime. docker exec wasm ejecuta un comando dentro del servicio wasm del laboratorio, que tiene Wasmtime y no tiene shell, así que el comando es siempre wasmtime seguido de lo que quieres hacer. Para una shell, usa docker exec -it tools sh.
- ¿Por qué los programas están escritos en texto y no compilados desde Rust o C?
- Ninguna imagen fijada trae un compilador ni herramientas de componentes junto a Wasmtime, y un laboratorio no descarga nada al arrancar. Wasmtime lee directamente el formato de texto de WebAssembly, así que los programas y componentes se escriben en él a mano y se pueden leer enteros. Las lecciones explican cómo cargo-component, componentize-py y jco construyen el mismo tipo de componente desde un lenguaje.
- ¿El laboratorio ejecuta código async de WASI 0.3?
- Wasmtime 50 tiene WASI 0.3 activado por defecto, y el laboratorio ejecuta un componente que importa una interfaz de WASI 0.3. Ningún componente del laboratorio es async, porque escrito a mano no se puede leer; las funciones async y los streams se explican en las lecciones.
- ¿De dónde sale la imagen de Wasmtime?
- Del repositorio público mitsurutech/wasmtime-image, que cualquiera puede leer: descarga el archivo publicado por la Bytecode Alliance, comprueba su SHA-256 y copia wasmtime sin cambios. El laboratorio fija el resultado por digest, así que no puede cambiar sin que lo sepas. Se ejecuta con una cuenta sin privilegios, sin capacidades y sin salida a internet, como todos los servicios de los laboratorios.