docker compose baixa todas as imagens em cada trabalho do GitHub Actions: como parar de baixar as mesmas imagens
O docker compose up baixa todas as imagens em cada trabalho do GitHub Actions porque cada trabalho em um executor hospedado pelo GitHub começa em uma VM nova. Postgres, Redis, o broker de mensagens, as imagens dos seus próprios serviços: nenhuma delas está no disco, então o Compose baixa e descompacta todas antes do primeiro teste. O jeito de parar de baixar as mesmas imagens é rodar o trabalho em uma máquina que ainda as tem.
O Skipbox é essa máquina. Os seus trabalhos rodam na máquina dedicada da sua conta, que guarda as imagens, as camadas e o cache de build do Docker entre os trabalhos. O docker compose up encontra o que baixou da última vez e sobe os contêineres. Troque uma linha, runs-on: skipbox, por $39 fixos por mês com minutos ilimitados.
Por que cada trabalho baixa tudo
- Uma VM nova por trabalho. A referência de executores do GitHub, lida em 14 de novembro de 2026, diz que cada executor hospedado pelo GitHub é uma máquina virtual (VM) nova hospedada pelo GitHub. Nada do que o último trabalho baixou está nela.
- O Compose baixa o que falta. O
pull_policypadrão émissing: o Compose só baixa a imagem se ela não estiver no cache da plataforma. Em uma VM nova, todas as imagens estão faltando. - Baixar é download e descompactação. Cada camada é baixada, descompactada e gravada no disco da VM. O
ubuntu-latestde um repositório privado tem 2 CPUs e 14 GB de SSD para isso.
Então o tempo antes do seu primeiro teste é o tamanho do seu arquivo compose, pago inteiro a cada push.
O que dá para fazer em um executor hospedado pelo GitHub
As opções mudam o download de lugar; nenhuma o elimina.
| Opção | O que cada trabalho ainda faz | Limite |
|---|---|---|
docker save + actions/cache + docker load | Baixa o arquivo e depois carrega cada imagem no Docker | Conta nos 10 GB por repositório do GitHub, divididos com todos os outros caches |
Imagens menores (-alpine, -slim) | Baixa todas, mais rápido | Só até onde cada imagem tem uma variante pequena |
| Menos serviços por trabalho | Baixa menos imagens | Os testes que precisam da pilha completa ainda baixam tudo |
Cada uma é um jeito de fazer uma máquina esquecida esquecer menos. O download só desaparece quando a máquina se lembra.
O Skipbox guarda as imagens na sua máquina
Cada plano vem com a máquina dedicada da sua conta, mantida entre os trabalhos:
- As imagens ficam no disco. O
docker compose upencontra as imagens que baixou da última vez e vai direto para a subida dos contêineres. - Só as mudanças são baixadas. O
docker compose pullbusca as camadas que mudaram e reutiliza o resto. - As imagens dos seus próprios serviços são construídas a partir do cache. O
docker compose buildreutiliza as camadas do último build, semcache-fromnemcache-to. - Um começo limpo a cada trabalho. Depois de cada trabalho, o Skipbox remove todos os contêineres e apaga o login no registro (
~/.docker/config.json). O próximo trabalho sobe os serviços do zero, a partir das imagens que já estão no disco. - Espaço para elas. O disco tem 80 GB no S, contra 14 GB no executor do GitHub. Nada é apagado até o disco estar quase cheio depois de um trabalho; aí saem primeiro as imagens órfãs (dangling), depois o cache de build usado há mais tempo.
O workflow não muda além do runs-on:
jobs:
integration:
runs-on: skipbox # was ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: docker compose up -d --wait
- run: npm ci && npm run test:integration
Se você salvava as imagens com o actions/cache e o docker load, apague esses steps. O primeiro trabalho no Skipbox baixa cada imagem uma vez. O segundo as encontra na máquina.
Um trabalho escolhe o tamanho pelo rótulo:
| Rótulo | Máquina | Disco | Plano |
|---|---|---|---|
skipbox | 4 vCPU · 16 GB | 80 GB | S, $39 por mês |
skipbox-8x16 | 8 vCPU · 16 GB | 160 GB | M, $79 por mês |
skipbox-16x32 | 16 vCPU · 32 GB | 320 GB | L, $149 por mês |
Os mesmos minutos, a preço fixo
Os testes de integração são os trabalhos longos, então são eles que fazem uma fatura por minuto crescer. No Skipbox, os minutos são ilimitados:
| Minutos por mês (4 vCPU) | GitHub | Skipbox S | Você economiza por mês |
|---|---|---|---|
| 10.000 | $102 | $39 | $63 |
| 20.000 | $222 | $39 | $183 |
| 30.000 | $342 | $39 | $303 |
Os valores do GitHub são depois do uso incluído no GitHub Team. Os seus próprios minutos vão na calculadora da página inicial.
Mudar é uma linha
- Entre no Skipbox com o GitHub.
- Instale o app do Skipbox no GitHub e escolha os repositórios.
- Troque o
runs-ondo trabalho de testes de integração e faça push.
Também cria imagens no mesmo workflow? O guia de cache de camadas Docker no GitHub Actions cobre o docker build e o buildx.
Segurança
- A máquina é só da sua conta. Nenhum trabalho de outra empresa roda nela.
- Depois de cada trabalho, as credenciais, os processos e os contêineres do executor são apagados, e também o
~/.docker/config.json, então um login no registro não passa para o próximo trabalho. Limpar a cada trabalho dá, em vez disso, uma máquina nova a cada trabalho. - O código de pessoas sem acesso de escrita (como pull requests de forks) roda em uma máquina nova, descartável, nunca na sua.
Os detalhes estão em como os trabalhos são isolados.
Teste nos seus testes de integração
O teste é grátis por 7 dias ou 3.000 minutos de trabalhos, o que vier primeiro, e não pede cartão. Mova o trabalho para runs-on: skipbox, rode-o duas vezes e coloque o docker compose up da segunda execução ao lado do do GitHub.
Perguntas frequentes
Os nossos testes de integração com docker compose no GitHub Actions passam a maior parte do tempo baixando imagens. Como evitar baixar as mesmas imagens em cada trabalho?
Rode o trabalho em uma máquina que guarda o disco. Um executor hospedado pelo GitHub é uma VM nova a cada trabalho, então nenhuma imagem sobrevive e o compose baixa todas de novo. No Skipbox, o trabalho roda na máquina dedicada da sua conta, que guarda as imagens do Docker entre os trabalhos: o docker compose up encontra as imagens que baixou da última vez e sobe os contêineres. A mudança é uma linha, runs-on: skipbox, por $39 fixos por mês com minutos ilimitados.
Por que o docker compose baixa as imagens de novo em cada trabalho do GitHub Actions?
Porque o Compose baixa uma imagem quando ela não está na máquina, e em um executor hospedado pelo GitHub ela nunca está. A referência de executores do GitHub diz que cada executor hospedado pelo GitHub é uma máquina virtual nova; nada do que o último trabalho baixou está nela. O pull_policy padrão do Compose, missing, pularia o download se a imagem estivesse lá.
Posso guardar as imagens do docker compose com o actions/cache?
Pode, e isso só muda o download de lugar. O docker save grava as imagens em um arquivo tar, o actions/cache o guarda, e o próximo trabalho o restaura e roda docker load. Cada trabalho ainda baixa o arquivo inteiro e o carrega no Docker, e o arquivo conta nos 10 GB de cache por repositório do GitHub, divididos com os seus caches de dependências. Em uma máquina que guarda o disco, não há nada para salvar nem carregar.
O Skipbox guarda as imagens Docker entre os trabalhos?
Sim. Cada plano vem com a máquina dedicada da sua conta, mantida entre os trabalhos, e ela guarda no disco as imagens, as camadas e o cache de build do Docker: 80 GB no S, 160 GB no M e 320 GB no L. Depois de cada trabalho, os contêineres são removidos e o login no registro é apagado; as imagens ficam.
O que acontece quando uma imagem do meu arquivo compose muda?
Só as camadas que mudaram são baixadas. Acrescente docker compose pull antes do docker compose up quando quiser que cada trabalho consulte o registro: o Docker busca as camadas novas e reutiliza as que já estão no disco da máquina. As imagens que você mesmo cria com docker compose build reutilizam as camadas do último build do mesmo jeito.
Quanto custa testar?
Nada. O teste dura 7 dias ou 3.000 minutos de trabalhos, o que vier primeiro, sem cartão. Mova o seu trabalho de testes de integração para runs-on: skipbox, rode-o duas vezes e compare o docker compose up da segunda execução com o do GitHub.
Atualizado em 19 de novembro de 2026