# A fatura e os limites de cache do Blacksmith: como ele cobra, o que o cache guarda e quando um preço fixo sai mais barato

> O Blacksmith cobra cada minuto conforme o tamanho do executor, com 3.000 minutos grátis de 2 vCPU por mês, e cobra US$ 0,50 por GB por mês pelos caches de camadas Docker e pelos sticky disks. Como estimar a sua fatura, como reduzi-la e a conta de quando $39 fixos por mês saem mais baratos.

O Blacksmith cobra por minuto, conforme o tamanho do executor. Os 3.000 minutos grátis por mês dele são minutos de 2 vCPU, então um executor de 4 vCPU os gasta duas vezes mais rápido. Os caches de camadas Docker e os sticky disks são cobrados à parte, a US$ 0,50 por GB por mês. E cada trabalho paralelo cobra os próprios minutos. Essas três coisas explicam a maioria das faturas que assustam. O cache do Actions dele é grátis, até 25 GB por repositório por semana, com as entradas removidas depois de 7 dias sem uso.

O Skipbox tem preço por máquina, não por minuto: $39 por mês por 4 vCPU, com minutos ilimitados. A máquina é própria da sua conta e guarda as camadas do Docker e os caches de pacotes no disco entre os trabalhos, sem cobrança por GB. Troque uma linha, `runs-on: skipbox`. Acima de cerca de 6.400 minutos por mês em 4 vCPU, ele sai mais barato que o Blacksmith.

- Blacksmith 4 vCPU, 20.000 minutos por mês: $148 antes do armazenamento. Skipbox S: $39
- Nenhuma cobrança por GB: as camadas do Docker e os caches de pacotes ficam no disco da sua máquina
- A fatura é a mesma, quaisquer que sejam os seus minutos; cada plano que você adiciona roda mais trabalhos ao mesmo tempo

**GitHub Actions a preço fixo, minutos ilimitados** O Skipbox roda os seus trabalhos do GitHub Actions na sua própria máquina dedicada: $39 por mês, não importa quantos minutos você rode. As camadas Docker e o cache de dependências ficam entre os trabalhos, então o próximo trabalho começa na hora.

Um executor de 4 vCPU, 20.000 minutos por mês: GitHub $222 → Skipbox $39. Você economiza $183 todo mês.

A mudança é uma linha: `runs-on: skipbox`.

[Começar meu teste grátis de 7 dias](https://app.skipbox.dev/sign-in?ref=g-blacksmith-bill-and-cache-limits-pt-br)

## Como o Blacksmith cobra

Segundo a [página de preços](https://www.blacksmith.sh/pricing) do Blacksmith e a documentação dos [tipos de instância](https://docs.blacksmith.sh/blacksmith-runners/overview), as duas lidas em 13 de novembro de 2026:

| Executor | Por minuto |
|---|---|
| Ubuntu x64, 2 vCPU | US$ 0,004 |
| Ubuntu x64, 4 vCPU | US$ 0,008 |
| Ubuntu x64, 8 vCPU | US$ 0,016 |
| Ubuntu x64, 16 vCPU | US$ 0,032 |
| Ubuntu x64, 32 vCPU | US$ 0,064 |

- **Minutos grátis:** 3000 minutos de x64 com 2vCPU grátis por mês por organização. Um executor maior os gasta na proporção: um trabalho de 10 minutos em um executor de 4vCPU consome o equivalente a 20 minutos de 2vCPU. Então os minutos grátis valem US$ 12 em qualquer tamanho, e rendem 1.500 minutos em 4 vCPU.
- **Armazenamento extra:** o cache de camadas Docker e os sticky disks custam +US$ 0,50 por GB por mês. A CLI dele lê o armazenamento do registro de cobrança por hora, então um cache é cobrado pelas horas em que existe. Os IPs estáticos custam +US$ 100 por IP por mês.
- **Grátis:** o cache do Actions (sem custo adicional, diz o Blacksmith) e o cache de contêineres do Docker (imagens baixadas; o armazenamento usado por ele não é cobrado).

## Por que a fatura vem maior que o previsto

- **Os minutos grátis encolhem com o executor.** 3.000 parece o mês de uma equipe pequena. Em 4 vCPU são 1.500 minutos; em 8 vCPU, 750.
- **O armazenamento é cobrado à parte.** Cada `cache-key` do Docker ganha o próprio sticky disk ([builds Docker](https://docs.blacksmith.sh/blacksmith-caching/docker-builds)), e cada sticky disk é cobrado por GB. Dez imagens com 20 GB de cache de camadas cada são 200 GB, US$ 100 por mês, antes de um único minuto.
- **Cada trabalho paralelo cobra.** Um shard de 32 vias são 32 executores cobrando ao mesmo tempo, e a fatura não tem teto: cada shard, cada perna de matriz, cada nova execução e cada push de agente são minutos.
- **O alerta é um e-mail.** As [configurações](https://docs.blacksmith.sh/introduction/settings) do Blacksmith descrevem os Spending Alerts: se o gasto passar do limite, o Blacksmith envia um alerta por e-mail. A documentação não descreve nenhuma interrupção.

## Estime a sua própria fatura

A fatura do mês, por tamanho de executor e no total:

```text
fatura = Σ (minutos × tarifa daquele tamanho) − $12 (os minutos grátis) + GB-meses de armazenamento × $0.50
```

A CLI do Blacksmith dá cada parte ([relatório de uso e custo](https://docs.blacksmith.sh/blacksmith-cli/usage)):

```bash
blacksmith usage --since 30d --breakdown-by runner_type,repo   # billable minutes and estimated cost
blacksmith usage storage --since 30d --breakdown-by repo,type   # GB, GB-hours and storage cost
```

A página **Usage & Billing** do painel mostra a mesma divisão. Para um executor de 4 vCPU, só os minutos:

| Minutos por mês (4 vCPU) | Blacksmith, antes do armazenamento | Skipbox S |
|---|---|---|
| 10.000 | $68 | $39 |
| 20.000 | $148 | $39 |
| 30.000 | $228 | $39 |
| Sempre ocupado | $333,60 | $39 |

A [calculadora da página inicial](https://skipbox.dev/?vs=blacksmith&ref=g-blacksmith-bill-and-cache-limits-pt-br#cost) compara os dois com os seus próprios minutos e tamanho.

## Os limites de cache do Blacksmith

Segundo a documentação do [cache do Actions](https://docs.blacksmith.sh/blacksmith-caching/dependencies-actions), dos [builds Docker](https://docs.blacksmith.sh/blacksmith-caching/docker-builds) e dos [sticky disks](https://docs.blacksmith.sh/blacksmith-caching/dependencies-sticky-disks), lida em 13 de novembro de 2026:

| Cache | Tamanho | Remoção | Custo |
|---|---|---|---|
| Cache do Actions (`actions/cache`, `setup-*`) | 25 GB por repositório por semana | As entradas usadas há mais tempo, acessadas pela última vez há mais de 7 dias | Grátis |
| Cache de camadas Docker (`useblacksmith/setup-docker-builder`) | Sem teto na documentação | O disco de uma cache-key depois de 7 dias sem build; o BuildKit descarta as camadas sem uso há 8 dias | US$ 0,50 por GB por mês |
| Sticky disks (`useblacksmith/stickydisk`) | Até 5 por trabalho | Depois de 7 dias sem nenhum trabalho montá-lo | US$ 0,50 por GB por mês |

Por que os caches ainda erram no Blacksmith:

- **Alguns caches não o usam.** O `sccache` do Rust e a opção de cache do GitHub Actions no `docker/build-push-action` continuam indo para o backend do GitHub, que guarda 10 GB por repositório.
- **As entradas ficam restritas ao branch delas** por padrão, como no GitHub. Um branch não lê as entradas de um branch irmão. Uma configuração no painel desliga isso.
- **Os trabalhos pouco frequentes perdem os caches.** Um workflow que roda menos de uma vez por semana encontra as entradas e os discos removidos e começa a frio.
- **Imagens sem relação em uma mesma cache-key removem umas às outras.** A documentação do Blacksmith diz que isso pode ser mais lento do que não usar cache nenhum; dê a cada Dockerfile a sua própria chave.

## Como reduzir uma fatura do Blacksmith

O maior corte é parar de pagar por minuto: acima do ponto de equilíbrio da próxima seção, uma máquina de preço fixo sai mais barata e a fatura para de se mexer. No próprio Blacksmith:

1. **Cancele as execuções superadas.** `concurrency` com `cancel-in-progress: true`, com a chave no pull request, para de pagar pelas execuções que um push novo substituiu.
2. **Exclua o armazenamento parado.** Liste os sticky disks com `blacksmith stickydisk list` ou em **Storage → Sticky Disks**, e exclua o que nenhum trabalho usa.
3. **Uma cache-key por Dockerfile,** para os caches não removerem uns aos outros e custarem um rebuild.

## Quando um preço fixo sai mais barato

O Skipbox cobra uma máquina por mês. O Blacksmith cobra um minuto. Onde as linhas se cruzam, a partir do preço de cada um:

```text
minutos de equilíbrio = (preço fixo + $12 dos minutos grátis) ÷ tarifa por minuto do Blacksmith
```

| Plano do Skipbox | Por mês | Contra o Blacksmith | Sai mais barato que o Blacksmith acima de |
|---|---|---|---|
| S, 4 vCPU | $39 | 4 vCPU a US$ 0,008 | cerca de 6.400 minutos por mês |
| M, 8 vCPU | $79 | 8 vCPU a US$ 0,016 | cerca de 5.700 minutos por mês |
| L, 16 vCPU | $149 | 16 vCPU a US$ 0,032 | cerca de 5.100 minutos por mês |

O armazenamento baixa essa linha: cada 10 GB de cache de camadas Docker no Blacksmith acrescentam US$ 5 por mês, e no Skipbox eles ficam no disco da máquina (80 GB no S).

Acima do ponto de equilíbrio, o preço fixo é o mais barato, e a fatura para de se mexer. Os planos se somam: tenha um S para cada trabalho de 4 vCPU que você quer rodando ao mesmo tempo.

## Mudar é uma linha

```yaml
jobs:
  build:
    runs-on: skipbox # was blacksmith-4vcpu-ubuntu-2404
    steps:
      - uses: actions/checkout@v4
      - uses: docker/setup-buildx-action@v4 # was useblacksmith/setup-docker-builder
      - uses: docker/build-push-action@v7 # was useblacksmith/build-push-action
        with:
          push: true
          tags: user/app:latest
```

1. Entre no Skipbox com o GitHub.
2. Instale o app do Skipbox no GitHub e escolha os repositórios, públicos ou privados.
3. Troque o `runs-on` e faça push.

Os trabalhos de 8 vCPU vão para `skipbox-8x16`, os de 16 vCPU para `skipbox-16x32`. O `actions/cache` e os `setup-*` continuam funcionando como estão. O que o `useblacksmith/stickydisk` guardava, como o `~/.npm` ou o `node_modules`, simplesmente continua no disco desde o último trabalho. O [guia de cache de camadas Docker](https://skipbox.dev/pt-br/guides/docker-layer-cache-github-actions) tem os detalhes, e a página de [alternativas ao Blacksmith](https://skipbox.dev/pt-br/compare/blacksmith-alternatives) compara os serviços lado a lado.

## Segurança

- A sua máquina roda só os trabalhos da sua conta, nunca os de outra empresa.
- Depois de cada trabalho, as credenciais, os processos e os contêineres do executor são apagados. Limpar a cada trabalho dá a cada trabalho uma máquina nova.
- O código de pessoas sem acesso de escrita (como pull requests de forks) roda em uma VM nova que lê os seus caches mas não pode alterá-los.

Os detalhes estão em [isolamento dos trabalhos](https://docs.skipbox.dev/pt-br/isolation).

## Teste em um trabalho do Blacksmith

O teste não pede cartão e dura 7 dias ou 3.000 minutos de trabalhos. Mova um trabalho do Blacksmith para `runs-on: skipbox`, rode-o duas vezes e compare a segunda execução e a fatura do mês com o relatório de uso do Blacksmith.

## Perguntas frequentes

### Mudamos para o Blacksmith para ter um CI mais rápido, mas a fatura mensal veio bem maior do que esperávamos. Por quê?

Normalmente por três coisas. Os 3.000 minutos grátis são minutos de 2 vCPU, então rendem 1.500 minutos em um executor de 4 vCPU e 750 em um de 8 vCPU. O cache de camadas Docker e os sticky disks são cobrados pelo armazenamento, US$ 0,50 por GB por mês, além dos minutos. E cada suíte dividida em shards, cada build em matriz e cada push de agente cobra os próprios minutos. Rode blacksmith usage --since 30d --breakdown-by runner_type,repo e blacksmith usage storage para ver qual é.

### Como o Blacksmith cobra?

Por minuto, conforme o tamanho do executor. A página de preços dele (lida em 13 de novembro de 2026) lista o Ubuntu x64 a US$ 0,004 por minuto com 2 vCPU, US$ 0,008 com 4, US$ 0,016 com 8, US$ 0,032 com 16 e US$ 0,064 com 32, com 3.000 minutos grátis por mês por organização, contados como minutos de 2 vCPU. O cache de camadas Docker e os sticky disks custam US$ 0,50 por GB por mês, e os IPs estáticos US$ 100 por IP por mês. O cache do Actions dele não custa nada a mais.

### Quais são os limites de cache do Blacksmith?

O cache do Actions dele dá 25 GB de armazenamento grátis por repositório por semana e remove as entradas acessadas pela última vez há mais de 7 dias. As entradas ficam restritas ao branch delas por padrão. O sccache do Rust e o cache do GitHub Actions do docker/build-push-action continuam indo para o backend do GitHub. Os caches de camadas Docker e os sticky disks não têm teto de tamanho na documentação, mas são cobrados por GB e excluídos depois de 7 dias sem uso.

### O cache do Blacksmith não é grande o bastante e ainda vemos erros de cache. O que podemos fazer?

Rode os trabalhos em uma máquina que guarda o disco. No Skipbox, as camadas do Docker e os caches de pacotes ficam na máquina dedicada da sua conta entre os trabalhos, sem cobrança por GB, e o próximo trabalho começa com eles já lá.

### Quando um preço fixo sai mais barato que o Blacksmith?

Quando os seus minutos mensais passam do ponto de equilíbrio. O plano S do Skipbox (4 vCPU) custa $39 por mês; o executor de 4 vCPU do Blacksmith chega a esse valor com cerca de 6.400 minutos por mês, antes de qualquer armazenamento. O M contra 8 vCPU se equilibra em cerca de 5.700 minutos, o L contra 16 vCPU em cerca de 5.100. Os planos se somam: tenha um para cada trabalho que você quer rodando ao mesmo tempo.

### Posso definir um teto rígido de gastos no Blacksmith?

A documentação de configurações dele descreve os Spending Alerts: você define um limite mensal e o Blacksmith envia um e-mail para o endereço principal da conta quando o gasto passa dele. A documentação descreve um e-mail, não uma interrupção. Um preço que não se mexe exige um plano com preço por máquina: no Skipbox, a fatura é o preço dos seus planos, quaisquer que sejam os seus minutos, e cada plano que você adiciona roda mais trabalhos ao mesmo tempo.

### Como mover um trabalho do Blacksmith para o Skipbox?

Instale o app do Skipbox no GitHub, troque o runs-on de um rótulo como blacksmith-4vcpu-ubuntu-2404 para skipbox e faça push. Os steps que usam as actions do próprio Blacksmith (useblacksmith/setup-docker-builder, build-push-action, stickydisk) voltam para o docker/setup-buildx-action e o docker/build-push-action como eles são; a sua máquina guarda as camadas entre os trabalhos.

Atualizado em 2026-11-19 · https://skipbox.dev/pt-br/guides/blacksmith-bill-and-cache-limits
