Spiegazioni degli errori di build con l’AI
Quando una build non riesce, i log possono essere lunghi e difficili da consultare. Deplomo può usare l’AI per riassumere l’errore e suggerire come procedere. Puoi chiedere una spiegazione dalla vista Deployments o Builds di una build non riuscita. Se la spiegazione non è disponibile, consulta il log completo.
Su cosa si basa la spiegazione
La spiegazione usa l’output dei log della build non riuscita. Può aiutarti a individuare una fase della build che si è interrotta, un errore del compilatore o del package manager, un’incompatibilità tra versioni runtime o un problema di configurazione. Non esamina né modifica il repository.
Apri la build non riuscita
Nel pannello del servizio, apri Deployments o Builds e seleziona una build con stato failed.
Chiedi una spiegazione
Seleziona Spiegazione dell’errore. Deplomo restituisce una breve spiegazione e, quando riesce a individuarlo, suggerisce un passo successivo.
Verifica il suggerimento
Confrontalo con il repository e le impostazioni del servizio: file lock, directory radice, Dockerfile, comando di build e variabili disponibili durante la build. Consideralo un aiuto alla diagnosi e verifica la causa nel log completo prima di modificare il progetto.
Applica una correzione e ripeti il deploy
Modifica il codice o le impostazioni, poi avvia una nuova build oppure seleziona Redeploy. Confronta il risultato con quello della build non riuscita.
La spiegazione usa una parte limitata dei log della build non riuscita. Prima dell’analisi vengono oscurati i pattern riconosciuti come segreti, ma questo controllo non garantisce di rilevare ogni dato sensibile. Evita di includere credenziali e altri segreti nell’output della build.
Errori di build comuni
Questi esempi possono aiutarti a decidere cosa controllare nei log. Se riesce a individuarlo, la spiegazione può suggerirti come procedere.
| Errore | Esempio nei log | Cosa controllare |
|---|---|---|
| Conflitto tra dipendenze | ERESOLVE unable to resolve dependency tree | Controlla le versioni dei pacchetti e i requisiti delle peer dependency. |
| Pacchetto di build mancante | fatal error: Python.h: No such file or directory | Verifica che il pacchetto di sistema o gli header necessari siano disponibili nell’ambiente di build. |
| Memoria insufficiente durante la build | JavaScript heap out of memory | Controlla l’uso della memoria e le risorse necessarie per la build. |
| Percorso del file errato | Cannot find module '@/components/...' | Controlla il percorso e le maiuscole nel nome del file: Linux distingue tra maiuscole e minuscole. |
| Configurazione della porta | Application failed to respond on PORT | Verifica che l’applicazione legga PORT e ascolti su 0.0.0.0. |
Casi da approfondire
Conflitti tra TypeScript e versioni dei framework
Se la build di un framework si interrompe per errori di tipo, cerca nel log il primo messaggio del compilatore pertinente. Controlla il file e la riga indicati, oltre alle versioni del framework, del compilatore e dei pacchetti correlati.
Variabili necessarie durante la build
Alcuni framework frontend richiedono variabili d’ambiente durante la build. Una variabile impostata solo per il runtime non è disponibile in quella fase. Cerca nel log il nome della variabile mancante e impostala come variabile di build se l’applicazione ne ha bisogno.
Spiegazioni dell’AI e analisi manuale dei log
Una spiegazione dell’AI può aiutarti a concentrarti sulla parte rilevante di un log lungo. Per verificare il messaggio preciso e decidere cosa modificare, consulta il log completo. Prima di applicare comandi o modificare dipendenze, verifica i suggerimenti in base al progetto e alla documentazione dei pacchetti.
Errori di build ed errori runtime
La spiegazione dell’AI riguarda le build non riuscite; non diagnostica gli arresti anomali durante il runtime.
Se la build riesce ma l’applicazione si arresta dopo l’avvio, consulta Runtime Logs e verifica lo stato del processo, la porta di ascolto, le variabili d’ambiente, le connessioni agli add-on e l’uso della memoria. Per altre indicazioni, consulta la guida alla risoluzione dei problemi.