Primeiros passos
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
- Um trabalho cujo
runs-onpede um rótulo do Skipbox entra na fila do GitHub. - O GitHub avisa o Skipbox pelo webhook do app.
- 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.
- O Skipbox pede ao GitHub o registro de um executor que aceita um único trabalho, com os rótulos do próprio trabalho.
- O executor vai para a máquina dedicada da sua organização ou para uma VM nova (veja Isolamento das VMs). 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.
- 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/cachedo 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).
- Mover um trabalho é uma linha: o
runs-ondele. Voltar é a mesma linha. - Os trabalhos cujo
runs-onvocê 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.
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. Como as VMs ficam separadas: Isolamento das VMs.
Atualizado em 20 de novembro de 2026