Jamdesk Documentation logo

Flusso di distribuzione

Scopri come Jamdesk automatizza il deploy tramite push su GitHub o CLI, con monitoraggio dello stato, ricostruzioni manuali, log di build e rollback.

Esegui il push sul branch GitHub collegato. La documentazione sarà online in pochi minuti.

Deployment tramite CLI

Esegui il deploy dal terminale senza fare push su GitHub. Utile per iterazioni rapide, test di modifiche o progetti non collegati a un repository.

jamdesk login     # First time only
jamdesk deploy

La CLI impacchetta e carica i tuoi file. Mostra l'avanzamento della build in tempo reale. Usa --detach per mettere in coda la build e uscire immediatamente.

Guida al deploy da CLI

Panoramica completa della pipeline, fasi di build, riferimento errori e risoluzione dei problemi

Il flusso di lavoro

1
Apporta modifiche in locale

Modifica i tuoi file MDX e visualizza l'anteprima con jamdesk dev.

2
Esegui il push su GitHub

Esegui il commit e il push sul branch collegato:

git add .
git commit -m "Update authentication docs"
git push
3
Deploy automatico

Jamdesk rileva il push e costruisce la documentazione. La pubblica sulla CDN. La maggior parte dei siti viene costruita in 30-90 secondi.

Stato del deployment

Controlla lo stato nella dashboard, sotto Deployments:

StatoSignificato
BuildingBuild in corso
DeployedOnline sul tuo dominio
FailedErrore di build - controlla i log
QueuedIn attesa della build precedente

Ricostruzione manuale

Avvia una ricostruzione senza fare push:

  1. Vai su Settings nel tuo progetto
  2. Fai clic su Rebuild

Usalo dopo aver aggiornato le variabili d'ambiente o per sbloccare una build bloccata.

Log di build

Apri Deployments, fai clic su un deployment e leggi i log. Errori comuni:

  • Sintassi MDX non valida
  • Immagini mancanti
  • Link interni non funzionanti
  • Errori di configurazione

Rollback

  1. Vai su Deployments
  2. Trova il deployment da ripristinare
  3. Fai clic su Rollback

La versione precedente va online immediatamente.

Cosa fare ora?

Deploy da CLI

Esegui il deploy dal terminale senza fare push su GitHub

Ciclo di vita di build e deploy

Processo di build dettagliato, trigger e variabili d'ambiente

Domini personalizzati

Configura docs.yourdomain.com

Panoramica CLI

Strumenti locali e comandi

Anteprima locale

Visualizza in anteprima la documentazione prima del push