Ciclo di build e deploy
Pipeline completa di build, dal push Git al sito online: clonazione, convalida, caricamento su R2, riconvalida ISR, monitoraggio e strategie di rollback.
Invia il push a GitHub. Jamdesk esegue la build e il deploy della documentazione in pochi minuti.
Gli screenshot mostrano l'interfaccia in inglese.
Ciclo di build
Trigger di build
| Trigger | Come funziona | Caso d'uso |
|---|---|---|
| Push Git | Il Webhook si attiva quando viene eseguito un push sul branch collegato | Sviluppo normale |
| Dashboard | Fai clic su "Rebuild" nelle impostazioni del progetto | Forza l'aggiornamento dopo modifiche alla configurazione |
Le build vengono accorpate. I commit eseguiti entro 10 secondi l'uno dall'altro confluiscono in un'unica build.
Cosa succede durante una build
Jamdesk clona il repository e convalida la sintassi di docs.json e MDX. Compila le pagine in HTML e crea un indice di ricerca. Esegue il deploy del risultato su Cloudflare R2. La maggior parte dei siti viene compilata in 30-90 secondi.
Consulta Come funziona Jamdesk per informazioni sulla pipeline completa e il diagramma dell'architettura.
Stato del deploy
La dashboard mostra uno di questi stati per ogni build:
| Stato | Significato |
|---|---|
| Building | Build in corso |
| Deployed | Online sul tuo dominio |
| Failed | Errore di build: controlla i log |
| Queued | In attesa del completamento della build precedente |
La sezione Build History elenca i deploy recenti e il relativo stato. Da qui puoi avviare una build manuale:
Ricostruzione manuale
Avvia una build senza eseguire il push di modifiche:
- Vai al tuo progetto nella dashboard
- Apri Settings
- Fai clic su Rebuild
Usa questa opzione per:
- Correggere una build bloccata
- Aggiornare dopo gli aggiornamenti della piattaforma
Log di build
- Vai a Deployments nel tuo progetto
- Fai clic su un deployment
- Consulta il log di build completo
Errori comuni nei log:
- Sintassi MDX non valida
- Immagini o risorse mancanti
- Link interni non funzionanti
- Errori di configurazione
Rollback
- Vai a Deployments
- Individua il deployment da ripristinare
- Fai clic su Rollback
La versione precedente torna online immediatamente. Nel frattempo viene avviata una nuova build.
Deploy dei branch
I deploy dei branch sono disponibili nei piani Pro.
Visualizza in anteprima le modifiche prima dell'unione:
- Esegui il push su un branch di funzionalità
- Jamdesk crea un'anteprima all'indirizzo
branch-name.your-project.jamdesk.app - Esamina le modifiche e unisci il branch quando è tutto pronto