Jamdesk Documentation logo

Fluxo de implantação

Aprenda como o Jamdesk automatiza a implantação por pushes do GitHub ou CLI, acompanha o status e gerencia rebuilds, logs de build e rollbacks.

O Jamdesk gerencia a implantação automaticamente. Faça push para sua branch conectada do GitHub e sua documentação ficará disponível em minutos.

Implantação via CLI

Você também pode fazer a implantação diretamente pelo terminal, sem enviar alterações para o GitHub. Isso é útil para iterações rápidas, testar alterações ou trabalhar em projetos que não estão conectados a um repositório.

jamdesk login     # First time only
jamdesk deploy

A CLI empacota seus arquivos, faz o upload e mostra o progresso do build em tempo real. Use --detach para colocar o build na fila e sair imediatamente.

Guia de implantação via CLI

Guia completo do pipeline, fases do build, referência de erros e solução de problemas

O fluxo

1
Faça alterações localmente

Edite seus arquivos MDX e visualize o resultado com jamdesk dev.

2
Faça push para o GitHub

Faça commit e push para sua branch conectada:

git add .
git commit -m "Update authentication docs"
git push
3
Implantação automática

O Jamdesk detecta seu push, cria o build da sua documentação e faz a implantação na CDN. A maioria dos sites conclui o build em 30 a 90 segundos.

Status da implantação

Verifique o status no dashboard, em Deployments:

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

Rebuild manual

Inicie um rebuild sem fazer push:

  1. Acesse Settings no seu projeto
  2. Clique em Rebuild

Use esta opção ao atualizar variáveis de ambiente ou corrigir builds travados.

Logs de build

Quando os builds falharem, acesse Deployments → clique em uma implantação → visualize os logs. Problemas comuns:

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

Rollbacks

Reverta para uma versão anterior:

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

A versão anterior ficará disponível imediatamente.

O que vem a seguir?

Implantação via CLI

Faça a implantação pelo terminal sem enviar alterações para o GitHub

Ciclo de build e implantação

Processo detalhado do build, acionadores e variáveis de ambiente

Domínios personalizados

Configure docs.yourdomain.com

Visão geral da CLI

Ferramentas e comandos locais

Visualização local

Visualize a documentação antes de fazer push