Jamdesk Documentation logo

Ciclo de build e deploy

Conheça o pipeline de build completo, do git push ao site no ar: clone, validação, envio ao R2, revalidação de ISR, monitoramento e reversões.

Envie para o GitHub. O Jamdesk compila e publica sua documentação em poucos minutos.

As capturas de tela mostram a interface em inglês.

Ciclo de build

Gatilhos de build

GatilhoComo funcionaCaso de uso
Git PushO Webhook é acionado quando há um push para a branch conectadaDesenvolvimento normal
DashboardClique em "Rebuild" nas configurações do projetoForçar atualização após mudanças na configuração

Os builds são agrupados. Commits feitos em um intervalo de até 10 segundos são incluídos no mesmo build.

O que acontece durante um build

O Jamdesk clona seu repositório e valida o docs.json e a sintaxe MDX. Ele compila as páginas em HTML com um índice de busca e publica o resultado no Cloudflare R2. A maioria dos sites é compilada em 30 a 90 segundos.

Consulte Como o Jamdesk funciona para ver o pipeline completo e o diagrama de arquitetura.

Status da implantação

O dashboard mostra um destes status para cada build:

StatusSignificado
BuildingBuild em andamento
DeployedDisponível no seu domínio
FailedErro no build — verifique os logs
QueuedAguardando o build anterior

A seção Build History lista as implantações recentes e seus status. Inicie um build manual por ali:

Histórico de builds com implantações recentes, indicadores de status Successful, informações de commit e botão Rebuild

Iniciar um build manualmente

Inicie um build sem enviar alterações:

  1. Acesse seu projeto no dashboard
  2. Abra Settings
  3. Clique em Rebuild

Use esta opção para:

  • Corrigir um build travado
  • Atualizar após mudanças na plataforma

Logs do build

  1. Acesse Deployments no seu projeto
  2. Clique em uma implantação
  3. Leia o log completo do build

Erros comuns nos logs:

  • Sintaxe MDX inválida
  • Imagens ou recursos ausentes
  • Links internos quebrados
  • Erros de configuração

Reversões

  1. Acesse Deployments
  2. Encontre a implantação que deseja restaurar
  3. Clique em Rollback

A versão anterior entra no ar imediatamente. Um novo build é iniciado ao mesmo tempo.

Implantações de branches

As implantações de branches estão disponíveis nos planos Pro.

Confira as alterações antes de fazer o merge:

  1. Envie as alterações para uma branch de recurso
  2. O Jamdesk cria uma prévia em branch-name.your-project.jamdesk.app
  3. Revise e faça o merge quando estiver tudo pronto

Próximos passos

Visão geral da implantação

Escolha entre hospedagem em subdomínio, domínio personalizado ou subcaminho

Hospedagem em subcaminho

Hospede a documentação em example.com/docs