Přeskočit na obsah

A606 — Validační pipeline

Jeden vstupní bod, tři režimy, kroky jako data. Co běží kdy a proč je pořadí kroků samo o sobě pravidlo.

A606Inženýrství 11 minVývojářMaintainer

Po téhle lekci

  • Vyberete správný režim pipeline podle toho, co potřebujete.
  • Vysvětlíte, proč jsou kroky data a ne kód.
  • Zdůvodníte, proč některé kontroly běží až po sestavení.

Celý build má jeden vstupní bod a tři režimy:

RežimK čemuCo vynechává
npm run buildkanonická bránanic
npm run devvývojová smyčkatesty, linty, kontroly po sestavení
npm run checkrychlé ověřenínegeneruje a nesestavuje

Kroky jsou seznam v datech, ne poskládaný kód. Přidat kontrolu znamená dopsat řádek do seznamu — a protože je ten seznam čitelný, jde na první pohled zjistit, co se doopravdy pouští. Samostatná kontrola navíc hlídá, aby se definice v repozitáři nerozešla s tím, co spouští CI.

Tři fáze

Před sestavením — validace kanonických dat, generátory, autorizace, navigace, linty, katalogy, exporty. Tady spadne většina chyb.

Sestavení — generátor webu vyrobí public/.

Po sestavení — kontroly, které jdou udělat jen nad hotovým HTML: odkazy a kotvy, strukturovaná data, metadata, úplnost stránek tvrzení a zdrojů, responzivita tabulek, integrita exportů.

Zámek

Režim brány drží zámek po celou dobu běhu, aby se dvě souběžná sestavení nervala o generované soubory. Vývojový režim se nezamyká — server běží hodiny a zámek by blokoval všechno ostatní.

Ověř si, že to sedí

Přidáváte novou kontrolu. Kam do pořadí ji zařadit a co ještě musíte doplnit?

Zobrazit odpověď

Zařazení se řídí tím, co kontroluje:

  • kanonická data → před generátory, hned k ostatním validacím,
  • generovaný výstup → hned za generátor, který ho vyrábí,
  • vydané HTML → do fáze po sestavení.

A pak jsou tři věci, na které se zapomíná:

  1. Vlastní npm skript, aby šla kontrola spustit i samostatně. Bez toho se ladí jen přes celý build.
  2. Záznam v katalogu příkazů. Nový příkaz bez záznamu build shodí — proto dokumentace příkazů nemůže zaostat.
  3. Rozhodnutí, jestli patří i do check, tedy do rychlého režimu bez sestavení. Pokud nepotřebuje generované soubory, nejspíš ano.

A ověřte, že kontrola selže, když má selhat. Kontrola, která nikdy nespadla, obvykle nic nekontroluje.

Kanonické znění pojmů

Lekce pojem vysvětluje. Závazná definice je tady — když se rozejdou, platí tahle stránka.