Risoluzione dei problemi

Analizza gli errori dall’esterno verso l’interno: stato di account e progetto, ultima operazione, build, processo, rete e infine dipendenze.

Il deploy del servizio non riesce

1. In Builds apri stato e log dell’ultima build.
2. Se usi un Dockerfile, controlla percorso e contesto di build; il Dockerfile ha priorità sul rilevamento automatico.
3. Verifica che il comando non termini con un codice diverso da zero e che le dipendenze private abbiano le credenziali necessarie.
4. In un monorepo controlla la directory radice e i watch paths.
5. Distingui le variabili build-time da quelle runtime: le variabili runtime non sono presenti durante la build.

Il servizio è in esecuzione ma non è raggiungibile

• L’applicazione deve ascoltare su 0.0.0.0 e sulla porta indicata da PORT, non solo su localhost.
• Il tipo di esposizione deve essere HTTP e la porta interna deve coincidere con quella effettiva del processo.
• Controlla i log per crash, timeout o errori di connessione al database.
• Prova prima l’URL predefinito per separare i problemi DNS da quelli applicativi.

TCP e domini

• Per TCP, usa l’endpoint e la porta esterna indicati nel pannello; la porta interna non è raggiungibile da Internet.
• Per il DNS, controlla la delega con dig NS example.com +short e il record A con dig A example.com.

I dati sono scomparsi dopo un deploy

Il filesystem del container può cambiare quando viene sostituita una release. I dati devono risiedere in un volume o in un add-on. Se un volume era collegato, verifica il percorso di montaggio e l’ambiente corretto; evita ulteriori scritture finché non hai chiarito la situazione.

Informazioni necessarie per l’assistenza

Annota l’ora dell’errore e il fuso orario, gli identificativi del progetto e della risorsa, l’ultima azione, il risultato atteso e i log senza segreti.