Ciclo de Build e Deploy
O pipeline completo de build do git push ao site online: clonagem, validação, upload para R2, revalidação de ISR, monitoramento e estratégias de rollback.
O Jamdesk gerencia automaticamente todo o ciclo de build e deploy. Faça push para o GitHub e sua documentação ficará online em poucos minutos.
As capturas de tela mostram a interface em inglês.
Ciclo de Build
Gatilhos de Build
| Gatilho | Como funciona | Caso de uso |
|---|---|---|
| Git Push | O Webhook é acionado quando há um push para a branch conectada | Desenvolvimento normal |
| Dashboard | Clique em "Rebuild" nas configurações do projeto | Forçar atualização após alterações de configuração |
Os builds são agrupados. Vários commits feitos em até 10 segundos são combinados em um único build.
O que acontece durante um Build
O Jamdesk clona seu repositório, valida a sintaxe de docs.json e MDX, compila tudo para HTML otimizado com indexação de pesquisa e, em seguida, faz o deploy no Cloudflare R2. A maioria dos sites é compilada em 30–90 segundos.
Para ver a descrição completa do pipeline com um diagrama de arquitetura, consulte Como o Jamdesk funciona.
Status do Deploy
Verifique o status do build no dashboard:
| Status | Significado |
|---|---|
| Building | Build em andamento |
| Deployed | Disponível no seu domínio |
| Failed | Erro no build — verifique os logs |
| Queued | Aguardando o build anterior |
A seção Build History mostra os deploys recentes, com o status e a opção de acionar builds manuais:
Rebuild manual
Acione um rebuild sem fazer push de alterações:
- Acesse seu projeto no dashboard
- Abra Settings
- Clique em Rebuild
Use esta opção quando:
- Atualizar variáveis de ambiente
- Corrigir um build travado
- Atualizar após alterações na plataforma
Variáveis de ambiente
Defina as variáveis usadas durante o build em Settings → Environment:
ANALYTICS_ID=G-XXXXXXXXXX
API_BASE_URL=https://api.example.comAs variáveis ficam disponíveis durante o processo de build e podem ser referenciadas nos arquivos docs.json ou MDX.
Logs de Build
Consulte logs detalhados do build para depuração:
- Acesse Deployments no seu projeto
- Clique em um deploy específico
- Consulte o log completo do build
Problemas comuns aparecem nos logs:
- Sintaxe MDX inválida
- Imagens ou assets ausentes
- Links internos quebrados
- Erros de configuração
Rollbacks
Reverta para uma versão anterior:
- Acesse Deployments
- Encontre o deploy que deseja restaurar
- Clique em Rollback
A versão anterior ficará online imediatamente enquanto um novo build é iniciado.
Deploys de Branch
Os deploys de branch estão disponíveis nos planos Pro.
Visualize as alterações antes de fazer o merge:
- Faça push para uma branch de recurso
- O Jamdesk cria uma prévia em
branch-name.your-project.jamdesk.app - Revise e faça o merge quando estiver tudo pronto