Postup
- Najděte první chybu, ne poslední. Pipeline se zastaví na prvním selhání, ale výpis bývá dlouhý.
- Zjistěte krok. Každý běh je označený jménem kroku.
- Spusťte ten krok samostatně. Kratší smyčka, čitelnější výpis.
- Přečtěte hlášku doslova. Validátory tady píšou, co je špatně a často i jak to opravit.
- Opravte příčinu, ne symptom.
Katalog častých pádů
| Hláška | Skutečná příčina |
|---|---|
| Text tvrzení neodpovídá řádku tabulky | změna udělaná jen na jednom ze dvou míst |
| Stav neodpovídá zdrojům | dvojice zdrojů se neliší rodinou i vydavatelem |
| Neznámý typ stránky | nový record_type bez záznamu v konfiguraci metadat |
| Příkaz bez záznamu v katalogu | nový npm skript bez doprovodného záznamu |
| Rozbitá kotva | odkaz na id, které ve vydaném HTML není |
| Neznámý typ entity | typ bez popisku, nebo popisek bez použití |
| Chybí generovaný soubor | pouštíte generátor mimo pipeline, bez předchozích kroků |
| Přetečení zásobníku | cyklický import v šablonách |
Když je zeleno lokálně a červeno v CI
Pusťte lokálně přesně ten příkaz, který selhal. Když projde, je rozdíl v prostředí: verze nástrojů, citlivost na velikost písmen v cestách, časový limit, nebo odvozený soubor, který u vás zbyl z předchozího běhu a v čerstvém klonu neexistuje. Ověř si, že to sedí Build spadne na kontrole kotev: odkaz míří na `id`, které ve vydaném HTML není. Kde hledat? Ve třech místech, v tomhle pořadí: Co neudělat: smazat odkaz, aby brána zmlkla. Rozbitý odkaz je příznakem toho, že se rozešly dvě části obsahu — a ta druhá část je pořád rozešlá, jen o ní nikdo nebude vědět. Tahle kontrola existuje proto, že běžný kontrolor odkazů ručně psané Zobrazit odpověď Skrýt odpověď
id neověřuje. Je to jediná věc, která takový rozpad chytí.