Jamdesk Documentation logo

Fluxo de implantação

Saiba como o Jamdesk automatiza o deploy por push no GitHub ou pela CLI, com acompanhamento de status, rebuilds manuais, logs de build e rollbacks.

Faça push para a branch do GitHub conectada. Sua documentação fica online em poucos minutos.

Implantação via CLI

Faça o deploy pelo terminal sem fazer push no GitHub. Use para iterações rápidas, testes de alterações ou projetos que não estão conectados a um repositório.

jamdesk login     # First time only
jamdesk deploy

A CLI empacota e envia seus arquivos. Ela mostra o progresso do build em tempo real. Use --detach para colocar o build na fila e encerrar imediatamente.

Guia de deploy pela CLI

Passo a passo 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 com jamdesk dev.

2
Faça push para o GitHub

Faça commit e push para a branch conectada:

git add .
git commit -m "Update authentication docs"
git push
3
Deploy automático

O Jamdesk detecta seu push e gera a documentação. Em seguida, publica tudo na CDN. A maioria dos sites termina o build em 30 a 90 segundos.

Status da implantação

Verifique o status no dashboard, em Deployments:

StatusSignificado
BuildingBuild em andamento
DeployedPublicado no seu domínio
FailedErro de build - verifique os logs
QueuedAguardando o build anterior

Rebuild manual

Dispare um rebuild sem fazer push:

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

Use isso depois de atualizar variáveis de ambiente ou para corrigir um build travado.

Logs de build

Abra Deployments, clique em um deployment e leia os logs. Erros comuns:

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

Rollbacks

  1. Acesse Deployments
  2. Localize o deployment que deseja restaurar
  3. Clique em Rollback

A versão anterior volta ao ar imediatamente.

O que vem a seguir?

Deploy pela CLI

Faça o deploy pelo terminal sem fazer push no GitHub

Ciclo de vida de build e deploy

Processo de build detalhado, gatilhos e variáveis de ambiente

Domínios personalizados

Configure docs.seudominio.com

Visão geral da CLI

Ferramentas locais e comandos

Pré-visualização local

Visualize a documentação antes de fazer push