Build, Deploy e analisi

Esegui il push su GitHub (oppure esegui jamdesk deploy), Jamdesk crea il sito e le modifiche diventano subito disponibili. Questo è il ciclo. Le pagine di questa sezione ne illustrano ogni parte: la CLI che userai ogni giorno, cosa succede durante un build, da dove viene servito il sito e le analisi che Jamdesk raccoglie su ogni pagina senza script aggiuntivi.

Il build non riesce? Risoluzione dei problemi di build collega i messaggi di errore comuni alle relative cause e soluzioni.

CLI

La CLI open source consente di visualizzare in anteprima la documentazione localmente, convalidare la configurazione, verificare la presenza di link non funzionanti ed eseguire il deploy.

Panoramica CLI

Installa la CLI e scopri i comandi principali

Autenticazione

Accesso, archiviazione dei token e gestione delle sessioni

Deploy dalla CLI

Come jamdesk deploy prepara, carica ed esegue il build della documentazione

Correggere i link non funzionanti

jamdesk fix risolve i link interni non funzionanti mostrando prima un'anteprima delle modifiche

Flusso di build

Flusso di deploy

Push su GitHub, deploy dalla CLI, monitoraggio dello stato e nuovi build manuali

Attivazione dei build

Automaticamente al push, manualmente dal dashboard, oltre a debounce e code

Monitoraggio dei build

Avanzamento in tempo reale, fasi del build e log strutturati

Correggere con l'AI

Esamina e applica le correzioni suggerite dall'AI dal dashboard del build

Conversione automatica delle immagini

Conversione da PNG e JPG a WebP durante il build

Esportazione PDF

Esporta l'intero sito come un singolo PDF

Hosting e domini

Il sito è disponibile inizialmente all'indirizzo yourproject.jamdesk.app. Quando sei pronto, pubblicalo sul tuo dominio oppure sul percorso /docs del sito esistente.

Panoramica del deploy

Sottodominio, dominio personalizzato o sottopercorso: confronta le opzioni di hosting

Ciclo di Build e Deploy

L'intera pipeline dal push su git al sito online

Domini personalizzati

Configura il DNS per pubblicare la documentazione sul tuo dominio con SSL

Solo dominio personalizzato

Impedisci al sottodominio Jamdesk di rispondere direttamente

Sottodomini Jamdesk

Regole di denominazione e modifica del sottodominio predefinito

Hosting su sottopercorso

Pubblica il sito su yoursite.com/docs invece di usare un sottodominio separato

Guide della piattaforma

Configurazioni testate per inoltrare /docs tramite l'infrastruttura esistente.

AWS Route 53 e CloudFront

Configurazione della distribuzione e dell'origine

Cloudflare Workers

Configurazione dei Worker e routing del traffico verso /docs

Reverse proxy

nginx, Apache, Caddy, Traefik o HAProxy

Vercel

Una riscrittura vercel.json con il marker jd_proxy

Analisi e monitoraggio

Panoramica delle analisi

Visualizzazioni delle pagine, fonti di traffico e query di ricerca senza script esterni

Analisi del progetto

Comportamento dei visitatori sul sito, con attenzione alla privacy

Analisi delle ricerche

Cosa cercano i lettori e le lacune nei contenuti che queste ricerche rivelano

App mobile

Stato dei build e analisi in mobilità, con notifiche push