# Fila de build

Quando há outros builds em andamento, o seu deploy aparece como **Na fila** e começa assim que chegar a vez. Quando o servidor de build está sem espaço, o deploy **não espera**: ele falha na hora, com uma mensagem clara, e você refaz o deploy depois.

## Como a fila funciona

Cada deploy passa por **Na fila**, **Publicando** e **No ar**. A plataforma limita quantos builds rodam ao mesmo tempo, e por padrão cada time roda **um build por vez**. Os outros ficam esperando.

A ordem é justa entre times: a plataforma alterna entre os times que têm deploys esperando, então um time com muitos deploys não bloqueia os demais. Dentro do mesmo time, a ordem é a de chegada.

Na aba **Deploys** do projeto, a linha da versão mostra o selo **Na fila**. Na aba **Métricas**, o cartão **Espera na fila (média)** mostra quanto tempo os deploys costumam esperar.

Um deploy **Na fila** pode ser cancelado. Se o servidor foi reiniciado e o deploy já não está na fila ativa, o cancelamento responde `409 not_cancelable`; nesse caso espere ou dispare de novo.

## Fila cheia

Há um limite de deploys esperando, por time e no total. Passar dele recusa o novo deploy:

| Resposta | Mensagem | O que fazer |
|---|---|---|
| `429 team_queue_full` | Muitos builds enfileirados para o seu time; aguarde um instante. | Espere 5 segundos (cabeçalho `Retry-After`) e tente de novo. |
| `503 queue_full` | A fila de deploys está cheia. Tente novamente em instantes. | A plataforma está saturada; tente de novo em alguns minutos. |
| `team_app_limit` (deploy falha) | traz "N de M" apps em execução | O time já roda o máximo de apps permitido. Pare ou remova um app. Veja [Limites e cotas](/operacao/limites-e-cotas/). |

## Servidor de build sem espaço

Se o espaço de build da plataforma acaba ou fica indisponível, o deploy **não fica aguardando espaço**. A API responde `503` (`unavailable`) e o deploy aparece na lista como **Falhou**, com um destes códigos:

| Código | Mensagem mostrada | Significa |
|---|---|---|
| `build_disk_full` | O espaço de build está cheio. Não é um problema do seu repositório; avise o suporte. | Sem espaço livre no servidor de build. |
| `build_storage_unavailable` | Não conseguimos preparar o armazenamento do build agora. A equipe já foi avisada; tente de novo em alguns minutos. | O armazenamento de build não está utilizável. A equipe é avisada automaticamente. |
| `build_storage_error` | Falha interna de armazenamento ao preparar o build. Não é um problema do seu repositório; tente de novo em alguns minutos. Se persistir, avise o suporte com o id do deploy. | Falha de armazenamento inesperada. |

Nenhum desses é erro do seu código. O que fazer:

1. Espere alguns minutos.
2. Refaça o deploy: publique de novo pelo Git ou envie o arquivo outra vez. Em versões vindas do Git, o botão **Redeploy** na aba **Deploys** também serve; um upload que falhou não guarda o arquivo, então envie-o de novo.
3. Se repetir, avise o suporte informando o **id do deploy** (aparece na versão que falhou).

A versão anterior continua no ar enquanto o novo deploy falha. Não é preciso apagar nada do seu lado.

## Se algo der errado

| Sintoma | O que fazer |
|---|---|
| Deploy parado em **Na fila** por muito tempo | Outro build do seu time ainda roda. Espere ou cancele o que não precisa. |
| `429 rate_limited` ao disparar | Você passou do limite de deploys por hora: [Limites e cotas](/operacao/limites-e-cotas/). |
| `build_disk_full` repetido | Avise o suporte com o id do deploy. |

## Próximos passos

- [Deploys e status](/operacao/deploys-e-status/)
- [Problemas comuns](/erros/problemas-comuns/)
- [Logs, métricas e tráfego](/operacao/observabilidade/)
