Sestavení, nasazení, doména a logy

Poslední lekce technického minima. Je o tom, co se stane s tvým kódem cestou k uživateli.

Dev versus produkce

Tvůj projekt běží ve dvou různých režimech a to je důvod, proč občas „u mě to fungovalo“.

$npm run build

Co je build

Build (sestavení) je krok, ve kterém se ze zdrojového kódu vyrobí to, co se skutečně servíruje.

Build je zároveň nejčastější místo, kde se to zastaví. Typické příčiny:

1. Chyba v typech

   TypeScript kontroluje, že se datové typy shodují. Ve vývoji tě jen upozorní, při buildu to zastaví.

2. Chybějící proměnná prostředí

   Kód ji potřebuje a na hostingu není nastavená.

3. Kód, který nemůže běžet na serveru

   Něco sahá na window nebo document, které existují jen v prohlížeči.

4. Jiná verze Node.js

   Hosting používá jinou verzi než tvůj počítač a něco se chová jinak.

Sestavení projektu selhalo. Tady je celý výstup:

---
[VLOŽ CELÝ LOG, VČETNĚ ŘÁDKŮ NAD CHYBOU]
---

1. Napiš mi vlastními slovy, co je příčina.
2. Oprav to.
3. Spusť build znovu a ověř, že projde.
4. Řekni mi, jak se téhle chybě příště vyhnout.

Doména a DNS

Doména je adresa, kterou si lidé pamatují – mujweb.cz. DNS je systém, který ji převede na adresu skutečného serveru.

Prakticky potřebuješ vědět tohle:

1. Doménu si kupuješ u registrátora

   Roční poplatek. Doména je tvoje, dokud ji platíš.

2. U registrátora nastavíš záznamy

   Hosting ti přesně řekne, co tam napsat. Většinou jeden nebo dva řádky.

3. Změna se projeví se zpožděním

   Od minut po hodiny. Když to hned nefunguje, je to obvykle tohle. Počkej, než začneš něco měnit.

4. Certifikát se vyřídí sám

   Zámeček v prohlížeči (HTTPS) dnešní hostingy zařídí automaticky.

Logy

Log je záznam toho, co se dělo. Když něco nefunguje v produkci, logy jsou první místo, kam se díváš.

Kde je hledat:

1. Konzole prohlížeče

   Chyby na straně uživatele. F12 → Console.

2. Záložka Network v prohlížeči

   Které požadavky odešly a co odpověděly. Tady najdeš ty stavové kódy z lekce o API.

3. Logy hostingu

   Chyby na serveru. Každý hosting je má v administraci – hledej „Logs“ nebo „Functions“.

4. Log sestavení

   Když selhalo nasazení. Je u konkrétního pokusu o nasazení.

Rozhodovací strom, když něco nefunguje v produkci

1. Funguje to lokálně?

   Když ne, problém není v nasazení. Řeš to u sebe.

2. Prošel build?

   Když ne, čti log sestavení. Odpověď tam bude.

3. Je v konzoli prohlížeče chyba?

   Když ano, problém je ve frontendu.

4. Vrací nějaký požadavek 500?

   Když ano, problém je na serveru. Podívej se do logů hostingu.

5. Vrací 401 nebo 403?

   Přihlášení nebo oprávnění. Často chybějící proměnná prostředí.

6. Nic z toho?

   Zkontroluj, jestli je nasazená verze skutečně ta nová. Občas se jen díváš na starou uloženou v mezipaměti.