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

heya playground: o que rodou em uma estação de trabalho

heya gerencia desktops Linux persistentes em uma frota de hosts. Esta é a lista do que foi realmente executado em uma estação de trabalho: um pod sob k3s, suítes de conformance por port, uma máquina movida entre hosts e um bootstrap de host que só tem golden tests.

O que é o heya, tecnicamente

heya é o engine de computadores e VMs. Em termos técnicos ele gerencia desktops Linux persistentes: uma máquina tem um volume home, um ciclo de vida com uma regra de idle e um wake, uma tela que pode ser transmitida e uma posição em um host. Um runtime port a inicia, um volume port guarda seus arquivos, um archive port faz backup deles e um scheduler escolhe o host.

O arquivo mais útil que tenho é o documento de status, que classifica cada item da especificação como Run, Built ou Not built. Este post mantém essa disciplina: cada afirmação diz o que foi executado e onde. Tudo rodou em uma estação de trabalho Linux. Nada rodou em um host alugado.

Um pod sob um kubelet real

O primeiro spike, rodado em 2026-11-17, emulava o pod com containers Docker simples. No mesmo dia, o k3s v1.37.2 rodou em um container Docker privilegiado, um nó, e o pod de cinco containers com `hostUsers: false` subiu sob um kubelet. A maioria das linhas é n = 1.

PassoVeredictoObservação
K1 pod startse sustenta5 de 5 containers Running em um mesmo user namespace
K2 browser sandboxse sustenta, com uma armadilhao perfil padrão do runtime deu No usable sandbox; um perfil derivado do padrão do container runtime funcionou
K4 memory limitsdifere em alguns pontoso container inteiro do desktop é morto ao atingir o limite de memória; um único limite de pid para o pod
K7 network policyse sustenta depois de sincronizada, difere no inícioa primeira requisição de um pod novo para um pod proibido passou em 3 de 3 execuções
K9 start timemedido2.52 a 2.55 s do apply até o primeiro banner de tela, n = 5, imagem em cache

K7 é a linha que eu não teria adivinhado. Uma regra de negação que se aplica um instante depois de o pod subir não é uma cerca desde o primeiro pacote.

Suítes de conformance por port

Cada port tem um pacote de suíte cuja função Run recebe um fixture, de modo que os mesmos casos rodam contra todo adapter que possa rodar nesta máquina. Um skip usa a mesma condição dos testes reais do próprio adapter.

  • Runtime: memory, Docker no daemon local, Kubernetes no k3s.
  • VolumeStore: memory, cotas de projeto XFS dentro de um container privilegiado, Kubernetes no k3s com local-path. No k3s a suíte afirma capability_unavailable para uso e uso do pool.
  • VolumeArchive: memory, e kopia 0.23.1 sobre um repositório em sistema de arquivos com um round trip real de arquivos.
  • HostProvider, Scheduler, HostTelemetry, TokenSigner, Sink, Store e Outbox: adapters em memória ou em processo, mais Postgres para o store e um fixture com estado para a API do provider.

O documento de status diz suítes para dez ports, mas a própria matriz mostra nove suítes: o port de exportação de telemetria não tem nenhuma, só testes dos seus adapters. Um adapter LVM de thin-pool também é coberto por uma suíte, em um container privilegiado com os módulos do kernel carregados.

Não rodado, e dito: o adapter do provider contra a API real, os adapters de arquivamento restic, ZFS e btrfs porque não foram construídos, e o container runtime sob user namespaces ou gVisor porque este daemon não tem nenhum.

Mover uma máquina entre hosts

Um teste, TestMoveBetweenTwoHostsKeepsTheHome, roda uma movimentação no Docker com kopia: parar a máquina, exportar o diretório de forma incremental, importar no destino, verificar, trocar o host, manter a origem por um período configurado. Uma falha deixa a máquina parada na origem. O hostname não é função do host, então um home movido abre com o mesmo nome.

Perda de host e restauração a partir de backup rodam só contra fakes. O que não foi rodado: um home de 10 GB a uma taxa real de restauração e um destino pela internet. O lock do perfil do próprio navegador não foi exercitado.

Bootstrap do host: com golden tests, nunca executado

Um pacote de bootstrap gera o user data do cloud-init para um host servidor ou agente: pacotes, um volume store de arquivo loop XFS com cotas de projeto, faixas de ids subordinados, um drop-in de configuração do kubelet, as flags do k3s, um perfil seccomp, configurações de audit, manifestos para um node reader e um device plugin TUN, um timer diário de backup e um script de check.

Ele é testado por golden files para um servidor e um agente, e por valores calculados para os limites de coleta de imagens do kubelet conforme o tamanho do disco: 600 GB dá 98 e 96 por cento e uma reserva de 55 Gi, 1200 dá 99 e 98 e 59 Gi. As peças que podem rodar no k3s rodaram lá: o arquivo seccomp, o device plugin e a política de admissão. O script gerado em si não foi rodado em um host Debian. O plano de medição para dimensionamento também está inteiramente sem rodar.

Golden tests provam que a saída não mudou. Não provam que funciona. Até rodar em um host real, trate o bootstrap como não verificado.