Prostředí a proměnné

„Mně to funguje“ je nejstarší věta v oboru. Skoro vždycky za ní stojí rozdíl mezi prostředími.

Co je prostředí

Sada podmínek, ve kterých aplikace běží: která databáze, které klíče, která adresa, který režim.

1. Lokální

   Tvůj počítač. Vývojový režim, testovací data, klíče v .env.local.

2. Náhledové

   Dočasná adresa pro rozpracovanou změnu. Nemusíš mít, ale hodí se.

3. Produkční

   Ostrá verze. Skuteční uživatelé, skutečná data, ostré klíče.

Proměnné prostředí

Základy jsou v lekci z modulu 6. Tady jde o to, jak je spravovat, když jsou prostředí tři.

.env.example je most mezi tím. Obsahuje jména proměnných bez hodnot, je v Gitu a slouží jako seznam toho, co je potřeba nastavit.

Zkontroluj mi proměnné prostředí v tomhle projektu:

1. Vypiš všechny proměnné, které kód skutečně používá.
2. Porovnej to s .env.example – co chybí, co je navíc?
3. Které z nich jsou veřejné (jdou do prohlížeče) a které tajné?
4. Je mezi veřejnými něco, co tajné být má?
5. Co se stane, když některá chybí – spadne to hned, nebo až
 při konkrétní akci?

Bod 5 je pro mě nejdůležitější. Chci vědět, které chybějící proměnné
poznám hned a které až za týden od uživatele.

Nejčastější rozdíly

1. Chybějící proměnná

   Číslo jedna. .env.local se nikam nenahrává.

2. Vývojový versus produkční build

   Produkční build je přísnější. Spusť npm run build lokálně – většina rozdílů se ukáže hned.

3. Velikost písmen v názvech souborů

   Tvůj systém může být lhostejný, server ne. Import ./Tlacitko u souboru tlacitko.tsx projde u tebe a spadne naostro.

4. Odkazy na localhost

   Zbylá adresa http://localhost:3000 v kódu.

5. Jiná verze prostředí

   Služba používá jinou verzi Node.js. Dá se nastavit – a mělo by se.

Projdi projekt a najdi věci, které se můžou chovat jinak naostro než u mě:

1. Odkazy na localhost nebo lokální cesty v kódu.
2. Importy, kde nesouhlasí velikost písmen s názvem souboru.
3. Věci, které fungují jen ve vývojovém režimu.
4. Chybějící nastavení verze prostředí (Node.js apod.).
5. Cokoliv, co spoléhá na soubor, který se nenahrává.

U každého nálezu napiš, jak se to projeví.

Pojistka na začátek

Nejlepší návyk v celém modulu: než něco nasadíš, spusť produkční build lokálně.

$npm run build

Trvá to minutu a odchytí většinu chyb ještě doma, kde se opravují rychleji.