Jamdesk Documentation logo

Visão geral de build, deploy e análise

Como os docs vão do git push até o site no ar: a CLI, o pipeline de build, a hospedagem e os domínios personalizados, e as análises que acompanham cada página.

Faça push para o GitHub (ou execute jamdesk deploy). O Jamdesk gera o build do site. As alterações entram no ar. Esta seção aborda a CLI, o que acontece durante um build, de onde o seu site é servido e as análises que o Jamdesk coleta em cada página sem scripts extras.

Build falhando? Solução de problemas de build relaciona as mensagens de erro mais comuns às causas e correções.

CLI

A CLI de código aberto visualiza os docs localmente, valida a configuração, verifica links quebrados e faz o deploy.

Visão geral da CLI

Instale a CLI e conheça os comandos principais

Autenticação

Faça login, armazenamento de tokens e gerenciamento de sessão

Deploy pela CLI

Como jamdesk deploy empacota, envia e gera o build dos seus docs

Corrigir links quebrados

jamdesk fix resolve links internos quebrados, mostrando as alterações antes

Fluxo de build

Fluxo de deploy

Pushes do GitHub, deploys pela CLI, acompanhamento de status e rebuilds manuais

Disparando builds

Automático a cada push, manual pelo dashboard, além de debounce e filas

Monitorando builds

Progresso em tempo real, fases do build e logs estruturados

Corrigir com IA

Revise e aplique correções sugeridas por IA pelo dashboard de build

Conversão automática de imagens

Conversão de PNG e JPG para WebP durante o build

Exportação em PDF

Exporte o site inteiro como um único PDF

Hospedagem e domínios

Seu site começa em yourproject.jamdesk.app. Você pode servi-lo a partir do seu próprio domínio ou de um caminho /docs no seu site existente.

Visão geral de deploy

Subdomínio, domínio personalizado ou subcaminho: compare as opções de hospedagem

Ciclo de build e deploy

O pipeline completo do git push até o site no ar

Domínios personalizados

Configuração de DNS para servir os docs pelo seu próprio domínio com SSL

Somente domínio personalizado

Impeça que o subdomínio do Jamdesk responda diretamente

Subdomínios do Jamdesk

Regras de nomenclatura e como alterar seu subdomínio padrão

Hospedagem em subcaminho

Hospede em seusite.com/docs em vez de um subdomínio separado

Guias da plataforma

Configurações testadas para fazer proxy de /docs pela sua infraestrutura existente.

AWS Route 53 e CloudFront

Configuração de distribuição e de origem

Cloudflare Workers

Configuração do worker e roteamento do tráfego de /docs

Reverse proxy

nginx, Apache, Caddy, Traefik ou HAProxy

Vercel

Uma regra de rewrite em vercel.json com o marcador jd_proxy

Analytics e monitoramento

Visão geral de análises

Visualizações de página, fontes de tráfego e buscas, sem scripts externos

Análises do projeto

Comportamento dos visitantes do seu site, com foco em privacidade

Análises de busca

O que os leitores buscam e as lacunas de conteúdo que isso revela

App móvel

Status de build e análises em qualquer lugar, com notificações push