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
- In Builds apri stato e log dell’ultima build.
- Se usi un Dockerfile, controlla percorso e contesto di build; il Dockerfile ha priorità sul rilevamento automatico.
- Verifica che il comando non termini con un codice diverso da zero e che le dipendenze private abbiano le credenziali necessarie.
- In un monorepo controlla la directory radice e i watch paths.
- 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.0e sulla porta indicata daPORT, non solo sulocalhost. - 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, domini e server cloud
- Per TCP usa endpoint e porta esterna indicati nel pannello; la porta interna non è quella da usare su Internet.
- Per il DNS verifica la delega con
dig NS example.com +shorte il record condig A example.com. - Se SSH non funziona, verifica che il server sia acceso e che l’IP sia corretto. Usa VNC per controllare
sshd, firewall, disco e rete. - Se alla creazione è stata selezionata una chiave SSH, l’accesso tramite password potrebbe essere intenzionalmente disabilitato.
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
Prepara ora dell’errore con fuso orario, identificativi di progetto e risorsa, ultima azione, risultato atteso e log privi di segreti.
Non inserire nei ticket password, token, chiavi private, cookie o stringhe di connessione complete.