Orbit
Visualizzazione dei registri di compilazione
Every Orbit deployment keeps its complete build log, plus a structured breakdown of what the build did and how long each phase took. This guide covers where to find the log, how to read the…
Visualizzazione del Log per la Distribuzione Più Recente
Apri il progetto in Orbit. Il pannello Latest build nella scheda Overview mostra il log della distribuzione più recente. Se una build è in corso in questo momento, il log viene trasmesso in diretta, riga per riga, man mano che l'agente di build la produce.
Fai clic su Full details per aprire la pagina completa dei dettagli della distribuzione.
Visualizzazione dei Log per una Distribuzione Specifica
- Apri il tuo progetto in Orbit.
- Apri la scheda Deployments.
- Fai clic su qualsiasi distribuzione per aprire la sua pagina di dettagli.
- Il log di build completo è su quella pagina.
L'elenco Recent deployments nella scheda Overview ha un link View logs in ogni riga che porta allo stesso posto. Le distribuzioni di anteprima hanno lo stesso link nella sezione Preview deployments.
Fasi di Build
La pagina dei dettagli divide la build in fasi denominate con una durata per ciascuna:
| Fase | Cosa accade |
|---|---|
| Clone | Recupero del repository al commit distribuito |
| Cache restore | Estrazione della cache memorizzata node_modules, nei piani con cache di build |
| Install | Esecuzione del comando di installazione |
| Cache save | Ripacchettamento node_modules per la build successiva |
| Build | Esecuzione del comando di build |
| Upload | Pacchettamento della directory di output e archiviazione dell'artefatto |
| Done | L'artefatto è di fronte al traffico |
Questo è il modo più veloce per rispondere a "perché quella build era lenta". Una lunga fase Install con un badge Cold build significa che la cache è stata mancata. Una lunga fase Build significa che la tua stessa build è diventata più lenta.
Metadati di Build
Le carte sopra il log mostrano i fatti sulla distribuzione:
| Carta | Cosa mostra |
|---|---|
| Status | Queued, Building, Deploying, Succeeded, Failed, Cancelled, Rolled back o Awaiting approval |
| Commit | Il commit che questa distribuzione ha costruito, con collegamento al provider |
| Branch | Il ramo git da cui proviene |
| Author | Chi ha effettuato il push del commit |
| Build time | Tempo totale di wall-clock, con una valutazione Fast, Normal o Slow rispetto alla tua storia |
| Artifact | Dimensione dell'output pacchettato, con un link di download |
| Framework | Il framework che Orbit ha rilevato |
| Package manager | npm, yarn o pnpm, rilevato dal tuo lockfile |
| Build cache | Cache hit o Cold build |
| Build host | Quale host di build lo ha eseguito |
| Queue position | Il tuo posto in coda, mentre la distribuzione è ancora in coda |
| Pull request | Il numero PR, per una distribuzione di anteprima |
| Health score | Un punteggio su 100 con le detrazioni elencate |
Analisi che Orbit Esegue sul Log
La pagina dei dettagli non è solo un dump di testo. Orbit analizza il log e mette in evidenza ciò che conta.
- Build timeline con durate per fase.
- Slow build detected quando una build è notevolmente più lenta della tua mediana, con la percentuale e il tuo tempo tipico dalle ultime 10 build.
- TypeScript errors, estratti e conteggiati, quando la build non è riuscita nel controllo del tipo.
- Build analysis per le build di Next.js: dimensioni per-route, first-load JS, e conteggi di route statiche, dinamiche e ISR.
- Bundle regression avvisi quando il first-load JS di una route cresce più del 20% rispetto alla distribuzione precedente, o il bundle JS condiviso cresce.
- npm audit risultati analizzati direttamente dall'output di installazione, riepilogati per gravità.
- Security headers audit con punteggio su 60 punti.
- Smoke test risultati, se hai configurato percorsi di smoke test.
- Performance budgets superati, se hai impostato budget.
- Build optimization advisor, che elenca cambiamenti concreti con un risparmio di dimensioni stimato, classificato per impatto.
- Real user metrics, i Core Web Vitals p75 registrati mentre quella distribuzione era live.
Quali Variabili di Ambiente la Build Ha Effettivamente Visto
La pagina dei dettagli elenca le chiavi delle variabili di ambiente che sono state iniettate al momento della build, e le confronta con la tua configurazione attuale: aggiunte, modificate, rimosse, invariate. Le chiavi teal provengono da un override specifico dell'ambiente, quelle grigie dal livello del progetto.
I valori non vengono mai archiviati e mai mostrati. Passando il mouse su una chiave ti viene fornito un fingerprint SHA-256, che è sufficiente per confermare che due ambienti hanno lo stesso valore senza rivelarla.
Questo diff è il modo più veloce per rispondere a "il mio cambio di variabile di ambiente è effettivamente entrato nella build". Se la distribuzione è precedente al cambio, Orbit lo dice con un avviso Environment variables updated since this deployment e ti ricorda che il cambio non avrà effetto fino a quando non ridistribuisci.
Confronto di Due Distribuzioni
Fai clic su Compare su una distribuzione per confrontarla con la precedente: tempo di build, dimensione dell'artefatto, stato della cache, framework e il diff dell'artefatto a livello di file. Questo è l'itinerario più veloce per "cosa è effettivamente cambiato" quando una distribuzione si comporta diversamente da quella precedente.
Quando una Build Fallisce
La carta dello stato diventa Failed e il log mostra dove si è fermata. Sopra il log, Orbit aggiunge un riepilogo degli errori categorizzato con una correzione suggerita. Le categorie riconosciute includono memoria insufficiente, errore di compilazione, errore di test, errore di lint, errore di installazione, errore di rete e timeout, e Orbit corrisponde a modelli specifici come un modulo mancante, un conflitto di dipendenza peer di ERESOLVE, un codice di errore TypeScript, un disco di build pieno, un pacchetto 404 e un lockfile non aggiornato.
C'è anche un pulsante Get AI diagnosis, che legge le ultime 120 righe del log insieme al framework rilevato e alla categoria di errore e restituisce una spiegazione in linguaggio semplice.
La diagnosi AI è etichettata con AI-generated, verify before acting per una ragione. È molto brava a indirizzarti verso la riga giusta del log, e non è autorevole per il tuo codebase. Leggi la riga del log a cui si riferisce prima di cambiare qualcosa.
Riprovare una Build Non Riuscita
Nella pagina dei dettagli della distribuzione, fai clic su Retry build per eseguire nuovamente lo stesso commit senza effettuare il push di uno nuovo. Questo risolve gli errori transitori come un errore di rete durante l'installazione.
Se sospetti una dipendenza cache stantia, usa More retry options, quindi Retry with cleared cache, che elimina la cache di build prima di riprovare.
Le indicazioni complete errore per errore si trovano in Risoluzione dei problemi di Build Non Riuscite.
Annullamento di una Build in Corso
Fai clic su Cancel mentre una build è in corso.
L'annullamento termina immediatamente la macchina di build e non può essere annullato. La distribuzione viene registrata come Cancelled, e la distribuzione precedentemente live continua a servire il traffico, quindi l'annullamento non porta mai il tuo sito offline. Nota che l'effettuazione del push di un nuovo commit allo stesso ramo mentre una build è in corso annulla automaticamente la build in volo, quindi una distribuzione annullata seguita da una in corso è normale.
Download dell'Artefatto
Ogni distribuzione di successo mantiene il suo output pacchettato. Fai clic su Download sulla carta Artifact per estrarre il bundle esatto che è stato servito. C'è anche un browser degli artefatti per ispezionare i contenuti senza scaricare l'intera cosa.
Per quanto tempo gli artefatti vengono mantenuti è impostato in Settings, sotto Artifact retention: il numero di artefatti di successo da conservare per ambiente, da 10 a 500, con un valore predefinito di 50. Gli artefatti più vecchi vengono eliminati quotidianamente. L'artefatto della distribuzione attualmente live viene sempre mantenuto, indipendentemente dall'impostazione.
La conservazione degli artefatti è ciò che rende possibile il rollback. Impostarla troppo bassa riduce quanto indietro puoi tornare a una distribuzione non riuscita senza una ricostruzione. Se distribuisci molte volte al giorno, aumentala piuttosto che diminuirla.