Debugger AI di Cloud Noce
Il debugger AI trasforma il log di una build fallita in una spiegazione comprensibile e in azioni suggerite. È disponibile dalla pagina della build fallita e tramite l’API di spiegazione della build. Se il servizio AI non è disponibile, il log originale rimane la fonte principale per la diagnosi.
Che cosa analizza?
Il debugger analizza l’errore registrato per quella build: fase fallita, messaggi del gestore di pacchetti o del compilatore, comando, framework rilevato e indizi nel log. Serve a individuare più rapidamente la causa, senza applicare automaticamente modifiche al repository.
Apri la build fallita
Dalla scheda Deployments/Builds seleziona l’ultima build con stato failed e controlla prima la fine del log e il primo errore effettivo.
Richiedi una spiegazione all’AI
Usa Explain. La spiegazione include la causa probabile e alcuni controlli o correzioni suggeriti.
Confronta il suggerimento con il sorgente
Controlla nel repository versione del runtime, lockfile, directory radice, Dockerfile, comando di build e variabili build-time. Il suggerimento dell’AI potrebbe non tenere conto di tutta l’architettura applicativa.
Applica una modifica piccola e reversibile
Crea un commit con la correzione ed esegui il deploy, poi confronta la nuova build con la precedente. Non inserire segreti in prompt, commit o log.
Errori comuni
- Dipendenza o versione del runtime incompatibile;
- lockfile obsoleto o pacchetto privato senza credenziali;
- directory radice o contesto di build errati in un monorepo;
- variabile necessaria alla build definita soltanto come runtime;
- output di build o comando di avvio errati;
- Dockerfile che tenta di copiare un file necessario fuori dal contesto.
Quando la build riesce ma il runtime non funziona
Il debugger AI è dedicato agli errori di build. Per i crash durante l’esecuzione, controlla Logs, stato del processo, porta, variabili, connessione dell’Add-on e memoria e consulta la guida alla risoluzione dei problemi.