# Como o Skipbox funciona

> O que acontece entre um push e um trabalho concluído: o webhook, as verificações, um executor criado para um trabalho, a sua máquina dedicada ou uma VM nova, e o que acontece depois do trabalho.

O Skipbox roda os seus trabalhos do GitHub Actions em executores auto-hospedados que ele gerencia por você. O GitHub continua rodando os seus workflows, guardando os seus logs e mostrando os resultados. O Skipbox só fornece a máquina em que cada trabalho roda.

## Do push ao trabalho concluído

1. Um trabalho cujo `runs-on` pede um rótulo do Skipbox entra na fila do GitHub.
2. O GitHub avisa o Skipbox pelo webhook do app.
3. O Skipbox verifica o trabalho: a conta precisa de um plano ou do teste, com espaço para mais um trabalho daquele tamanho. O plano S roda até 8 trabalhos por vez, de 4 vCPU · 16 GB cada. Sempre ativo: trabalhos que rodam a qualquer momento, o mês inteiro, com minutos ilimitados. Plano S: 1, M: 2, L: 4. Burst: mais trabalhos rodam ao mesmo tempo em outras máquinas hospedadas pela Skipbox quando há uma livre, até 7 por vez. Cada plano inclui 10.000 minutos a cada mês do calendário. Um trabalho de burst começa em uma máquina nova com o cache do GitHub Actions; a máquina do seu plano mantém os caches quentes. Quando os minutos de burst de um mês acabam, o plano roda só seus trabalhos sempre ativos até o dia 1º, quando o burst volta. Veja [Concorrência e fila](https://docs.skipbox.dev/pt-br/concurrency).
4. O Skipbox pede ao GitHub o registro de um executor que aceita um único trabalho, com os rótulos do próprio trabalho.
5. O executor vai para a máquina dedicada da sua organização ou para uma VM nova (veja [Isolamento das VMs](https://docs.skipbox.dev/pt-br/isolation)). Ele pega um trabalho com esses rótulos, e o GitHub envia a ele o seu código, os secrets que o seu workflow passa e um token para o trabalho.
6. Quando o trabalho termina, a sua máquina dedicada apaga as credenciais do executor e as credenciais do git no checkout do trabalho e verifica a si mesma. Ela guarda os caches e, a partir de 13 de novembro de 2026, também o checkout e a saída de build dele (o `target/` do Cargo e o `.next/cache` do Next.js); uma VM nova é excluída com o disco. Um executor que ainda esteja registrado é removido.

## O que continua igual

- Os seus workflows, actions e logs continuam no GitHub. O Skipbox não guarda cópia do seu código nem dos seus logs. Ele só altera um workflow por meio de um pull request que você pede e aprova com merge (veja [Permissões do GitHub App](https://docs.skipbox.dev/pt-br/permissions)).
- Mover um trabalho é uma linha: o `runs-on` dele. Voltar é a mesma linha.
- Os trabalhos cujo `runs-on` você não muda continuam rodando nos executores do GitHub.

## Onde os trabalhos rodam

A sua máquina dedicada e as VMs novas rodam em um servidor que o Skipbox opera no Japão e em servidores da Hetzner Cloud na Finlândia e na Alemanha (UE). As VMs novas também rodam em servidores do Google Cloud no Canadá e na França, na Espanha e na Itália (UE). Veja [Rede e tráfego de saída](https://docs.skipbox.dev/pt-br/network).

## Um trabalho por vez

Uma VM roda um trabalho por vez. A sua máquina dedicada fica guardada para o próximo trabalho da sua organização, com os caches dela. O código de pessoas sem acesso de escrita (como pull requests de forks) nunca roda nela: ele ganha uma VM nova que lê os seus caches mas não pode alterá-los. Ative Limpar a cada trabalho para dar a cada trabalho uma VM nova. Um trabalho pode rodar por até 6 horas: veja [Limite de tempo do trabalho](https://docs.skipbox.dev/pt-br/job-time-limit). Como as VMs ficam separadas: [Isolamento das VMs](https://docs.skipbox.dev/pt-br/isolation).

Atualizado em 2026-11-20 · https://docs.skipbox.dev/pt-br/how-it-works
