Diagnostika selhání

Začněte přesným stavem, fází a sanitizovaným build výstupem. Před opakováním vždy změňte něco relevantního.

Instalace závislostí

• package manager odpovídá lockfilu;
• manifest a lockfile jsou synchronní;
• runtime verze je deklarovaná;
• private registry credentials jsou nakonfigurované jako secret;
• nativní systémové balíčky jsou zachycené v Dockerfile;
• base directory monorepa zpřístupňuje workspace soubory.

Build

• kanonický build lokálně projde;
• existují povinné build-time proměnné;
• public a server-only hodnoty nejsou zaměněné;
• base a publish directory odpovídají skutečnému výstupu;
• generovaný kód, migrace a assety jsou přítomné.

Start

• start proces existuje, běží v popředí a naslouchá na 0.0.0.0;
• runtimePort odpovídá listeneru;
• runtime secrets existují;
• migrace dokončí bezpečně;
• proces neočekává trvalá data v dočasném filesystemu.

Databáze a storage

Ověřte kompatibilitu enginu a driveru, shodné umístění a použití spravovaného attachmentu. U lokálního svazku musí existovat alespoň jeden úspěšný deployment, stejná lokalita a platná absolutní cílová cesta, nikdy /.

Doména a HTTPS

Rozlište přesnou fázi: TXT pending/failed, ověřeno ale nepřipojeno, neviditelný CNAME, routing pending/error nebo certifikát pending/error. Ověření vlastnictví není důkazem funkčního směrování.

Bezpečný retry

Zaznamenejte deployment ID, chybu, diagnostikovanou příčinu, provedenou změnu a validaci. Potom spusťte jeden deployment a sledujte ho do terminálního stavu. Stejnou nezměněnou chybu neopakujte ve smyčce.