Skip to Content
Risoluzione dei problemi

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, 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 +short e il record con dig 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.