~/studies/work 2026-11-18 · published 2026-11-21

heya playground: lo que se ejecutó en una estación de trabajo

heya gestiona escritorios Linux persistentes en una flota de hosts. Esta es la lista de lo que realmente se ejecutó en una estación de trabajo: un pod bajo k3s, suites de conformance por port, una máquina movida entre hosts y un bootstrap de host que solo tiene golden tests.

Qué es heya, técnicamente

heya es el engine de computadoras y VMs. En términos técnicos gestiona escritorios Linux persistentes: una máquina tiene un volumen home, un ciclo de vida con una regla de idle y un wake, una pantalla que se puede transmitir y una ubicación en un host. Un runtime port la inicia, un volume port guarda sus archivos, un archive port los respalda y un scheduler elige el host.

El archivo más útil que tengo es el documento de estado, que califica cada ítem de la especificación como Run, Built o Not built. Este post mantiene esa disciplina: cada afirmación dice qué se ejecutó y dónde. Todo corrió en una estación de trabajo Linux. Nada corrió en un host alquilado.

Un pod bajo un kubelet real

El primer spike, ejecutado el 2026-11-17, emulaba el pod con contenedores Docker simples. El mismo día, k3s v1.37.2 corrió en un contenedor Docker privilegiado, un nodo, y el pod de cinco contenedores con `hostUsers: false` arrancó bajo un kubelet. La mayoría de las filas son n = 1.

PasoVeredictoObservación
K1 pod startse sostiene5 de 5 contenedores Running en un mismo user namespace
K2 browser sandboxse sostiene, con una trampael perfil por defecto del runtime dio No usable sandbox; un perfil derivado del default del container runtime funcionó
K4 memory limitsdifiere en algunos puntostodo el contenedor del escritorio se mata al llegar a su límite de memoria; un solo límite de pid para el pod
K7 network policyse sostiene una vez sincronizada, difiere al iniciola primera solicitud de un pod nuevo a un pod prohibido pasó en 3 de 3 ejecuciones
K9 start timemedido2.52 a 2.55 s desde el apply hasta el primer banner de pantalla, n = 5, imagen en caché

K7 es la fila que no habría adivinado. Una regla de denegación que se aplica un momento después de que arranca el pod no es una valla desde el primer paquete.

Suites de conformance por port

Cada port tiene un paquete de suite cuya función Run recibe un fixture, de modo que los mismos casos corren contra cada adapter que pueda ejecutarse en esta máquina. Un skip usa la misma condición que los tests reales del propio adapter.

  • Runtime: memory, Docker en el daemon local, Kubernetes en k3s.
  • VolumeStore: memory, cuotas de proyecto XFS dentro de un contenedor privilegiado, Kubernetes en k3s con local-path. En k3s la suite afirma capability_unavailable para el uso y el uso del pool.
  • VolumeArchive: memory, y kopia 0.23.1 sobre un repositorio en sistema de archivos con un round trip real de archivos.
  • HostProvider, Scheduler, HostTelemetry, TokenSigner, Sink, Store y Outbox: adapters en memoria o en proceso, más Postgres para el store y un fixture con estado para la API del provider.

El documento de estado dice suites para diez ports, pero su propia matriz muestra nueve suites: el port de exportación de telemetría no tiene ninguna, solo tests de sus adapters. Un adapter LVM de thin-pool también está cubierto por una suite, en un contenedor privilegiado con los módulos del kernel cargados.

No ejecutado, y se dice: el adapter del provider contra la API real, los adapters de archivo restic, ZFS y btrfs porque no están construidos, y el container runtime bajo user namespaces o gVisor porque este daemon no tiene ninguno.

Mover una máquina entre hosts

Un test, TestMoveBetweenTwoHostsKeepsTheHome, ejecuta un movimiento en Docker con kopia: detener la máquina, exportar su directorio de forma incremental, importar en el destino, verificar, cambiar el host, conservar el origen durante un período configurado. Un fallo deja la máquina detenida en el origen. El hostname no es función del host, así que un home movido se abre con el mismo nombre.

La pérdida de un host y la restauración desde backup se ejecutan solo contra fakes. Lo que no se ejecutó: un home de 10 GB a una tasa de restauración real y un destino a través de internet. El lock del perfil propio del navegador no se ejercitó.

Bootstrap del host: con golden tests, nunca ejecutado

Un paquete de bootstrap genera el user data de cloud-init para un host servidor o agente: paquetes, un volume store de archivo loop XFS con cuotas de proyecto, rangos de ids subordinados, un drop-in de configuración del kubelet, los flags de k3s, un perfil seccomp, ajustes de audit, manifiestos para un node reader y un device plugin TUN, un timer diario de backup y un script de check.

Se prueba con golden files para un servidor y un agente, y con valores calculados para los umbrales de recolección de imágenes del kubelet según el tamaño del disco: 600 GB da 98 y 96 por ciento y una reserva de 55 Gi, 1200 da 99 y 98 y 59 Gi. Las piezas que pueden correr en k3s corrieron allí: el archivo seccomp, el device plugin y la política de admisión. El script generado en sí no se ha ejecutado en un host Debian. El plan de medición para dimensionar también está completamente sin ejecutar.

Los golden tests prueban que la salida no cambió. No prueban que funcione. Hasta que corra en un host real, trata el bootstrap como no verificado.