fireactions/readme.md

# fireactions

¡WIP!

una API para correr cosas aisladas en una VM [firecracker] que inicia rápido a partir de una imágen de contenedor OCI. inspirado en [Fly Machines] y otras cosas.

[notas y referencias sobre firecracker](https://nulo.ar/Firecracker.html) en mi sitio

[firecracker]: <https://github.com/firecracker-microvm/firecracker>
[Fly Machines]: <https://fly.io/docs/reference/machines/>

## setup

```sh
# build rootfs image (incl. agent)
(cd rootfs; pnpm install)
node rootfs/index.js
# run daemon
(cd server; pnpm install && pnpm start) &
# run VM
curl "localhost:8080/run?image=gitea.nulo.in/nulo/super-image:3.18"
```

## componentes

1. `server` es el servidor de api (JavaScript/TypeScript) que recibe pedidos, descarga imagenes OCI y inicia firecracker con los parametros apropiados.
1. `rootfs` es el código (JavaScript/TypeScript) que genera el rootfs con todo lo necesario para configurar la vm (red (WIP), mounts básicos, etc) y montar la imágen.
   1. `rootfs/init` es un programa (Rust) que hace las cosas básicas antes de y para montar la imágen OCI y hace chroot.
actualizar readme para reflejar código actual 2023-06-23 20:50:29 +00:00			`# fireactions`
baby 2023-05-22 14:44:31 +00:00
actualizar readme para reflejar código actual 2023-06-23 20:50:29 +00:00			`¡WIP!`

			`una API para correr cosas aisladas en una VM [firecracker] que inicia rápido a partir de una imágen de contenedor OCI. inspirado en [Fly Machines] y otras cosas.`

readme: agregar referencias en mi sitio 2023-08-26 20:44:09 +00:00			`[notas y referencias sobre firecracker](https://nulo.ar/Firecracker.html) en mi sitio`

actualizar readme para reflejar código actual 2023-06-23 20:50:29 +00:00			`[firecracker]: <https://github.com/firecracker-microvm/firecracker>`
			`[Fly Machines]: <https://fly.io/docs/reference/machines/>`

			`## setup`
documentar como crear y debuggear 2023-06-03 14:27:43 +00:00
			```sh
			`# build rootfs image (incl. agent)`
			`(cd rootfs; pnpm install)`
			`node rootfs/index.js`
actualizar readme para reflejar código actual 2023-06-23 20:50:29 +00:00			`# run daemon`
			`(cd server; pnpm install && pnpm start) &`
documentar como crear y debuggear 2023-06-03 14:27:43 +00:00			`# run VM`
actualizar readme para reflejar código actual 2023-06-23 20:50:29 +00:00			`curl "localhost:8080/run?image=gitea.nulo.in/nulo/super-image:3.18"`
documentar como crear y debuggear 2023-06-03 14:27:43 +00:00			```
actualizar readme para reflejar código actual 2023-06-23 20:50:29 +00:00
			`## componentes`

			1. `server` es el servidor de api (JavaScript/TypeScript) que recibe pedidos, descarga imagenes OCI y inicia firecracker con los parametros apropiados.
			1. `rootfs` es el código (JavaScript/TypeScript) que genera el rootfs con todo lo necesario para configurar la vm (red (WIP), mounts básicos, etc) y montar la imágen.
			1. `rootfs/init` es un programa (Rust) que hace las cosas básicas antes de y para montar la imágen OCI y hace chroot.