Jak Nastavit CI/CD Pipeline S GitHub Actions: Difference between revisions

From IT-Core
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 1: Line 1:
Typické chyby, které vás stojí čas i výkon Největší výkonnostní pastí je zbytečné kopírování objektů při každé akci. Redux vyžaduje neměnnost, ale to neznamená, že musíte deep-clone celý stav. Pokud měníte pouze jednu vlastnost, použijte spread operátor na úrovni, kterou měníte. Vyhněte se také ukládání celých polí objektů do stavu, pokud je potřebujete jen přečíst. Místo toho si je nechte v paměti a do Reduxu ukládejte pouze identifikátory. Při mapování stavu do props vybírejte jen to, co komponenta potřebuje, a používejte selektory, které se zapojí do memoizace.<br><br>Automatizace nasazení je jednou z prvních věcí, které byste měli ve svém projektu zavést, pokud chcete ušetřit čas a předejít chybám. GitHub Actions nabízí integrované řešení přímo v repozitáři, takže nemusíte provozovat žádný externí server. Pro menší týmy i středně velké projekty je to obvykle nejpraktičtější volba, protože konfigurace je deklarativní a veškerá historie běhů zůstává přehledně na jednom místě.<br><br>Častou chybou bývá, že vývojáři spoléhají pouze na příkaz console.log a vypisují si desítky hlášek do konzole. To je sice rychlé, ale z dlouhodobého hlediska nepřehledné a často vám unikne kontext, ve kterém k chybě došlo. Místo toho si osvojte používání podmíněných breakpointů kliknete pravým tlačítkem na číslo řádku, zvolíte Add conditional breakpoint a zadáte podmínku, která musí být splněna, aby se provádění zastavilo. Ušetříte tím spoustu času, pokud se chyba projevuje jen při určité hodnotě proměnné (například když je pole prázdné nebo když je uživatel přihlášený).<br><br>Prvním krokem k efektivnímu použití je správné členění store. Rozdělte si Redux store na menší slice, každý s vlastními reducery a akcemí. Například oddělte data uživatele, obsah košíku a stav notifikací. Tím zajistíte lepší čitelnost a snazší testování. Vyhněte se obřím reducertům, které řeší všechno. Místo toho použijte funkci combineReducers a každý slice nechte žít samostatně. Tím se vyhnete častému problému, kdy jedna chyba v jednom místě rozbije celou aplikaci.<br><br>Další užitečnou funkcí je sledování hodnot výrazů v reálném čase. V panelu Watch můžete přidat jakýkoliv výraz (například users.length nebo document.title) a vidět, jak se mění při průchodu kódem. To je efektivnější než vpisovat console.log do každé větve. Pozor si dejte na to, že u asynchronních funkcí se hodnoty zobrazují v okamžiku zastavení, takže pokud potřebujete vidět stav po dokončení nějaké operace, budete muset nastavit breakpoint až za ní.<br><br>Při testování chybových stavů postupujte stejně, ale mock funkce necháte vyhodit výjimku. Ověřte, že je dispatchována akce pro chybu, a že stav aplikace zůstává konzistentní. Častou chybou je testovat pouze šťastnou cestu. Přitom ošetření chyb je v Reduxu kritické, protože uživatel musí vidět, že něco selhalo, a aplikace se nesmí zhroutit. Dále si dejte pozor na to, abyste nemockovali příliš mnoho. Pokud mockujete i samotný dispatch, ztrácíte kontrolu nad tím, co testujete.<br><br>Při výběru IDE pro Python nejde o to, které je nejlepší, ale které nejlépe sedne vašemu stylu práce. Začněte tím, že si ujasníte, co od nástroje skutečně potřebujete. Pokud píšete skripty pro automatizaci nebo analýzu dat, často stačí lehký editor s integrovaným terminálem. Pokud vyvíjíte větší aplikace s frameworky, oceníte pokročilé ladění, správu virtuálních prostředí a integraci s verzovacími systémy. Nenechte se zlákat množstvím funkcí – klíčové je, aby nástroj zrychloval vaši práci, ne ji komplikoval.<br><br>Nakonec se rozhodněte podle toho, co jste si ověřili v praxi. Ideální je, když si vyberete jeden hlavní nástroj a jeden záložní pro rychlé úpravy. Vyhnete se tak situaci, kdy budete muset kvůli jednomu skriptu otevírat těžké prostředí. Pamatujte, že žádné IDE nenahradí znalost příkazů a syntaxe jazyka – je to jen nástroj, který vám má usnadnit práci, ne za vás myslet.<br><br>Refaktorování kódu je nedílnou součástí vývoje, ale často ho vnímáme jako zdlouhavou a nudnou činnost. Mnoho vývojářů stále ručně přejmenovává proměnné, přesouvá metody nebo mění signatury funkcí, přitom moderní vývojová prostředí nabízejí celou řadu vestavěných nástrojů, které tyto operace výrazně urychlí a hlavně eliminují chyby vzniklé při ručním zásahu. Stačí se naučit pár klávesových zkratek a pochopit, co všechno IDE umí.<br><br>Pozor také na to, jak IDE spravuje virtuální prostředí. Dobrý nástroj by měl umožnit vytvořit nové prostředí jedním kliknutím a automaticky ho aktivovat při spuštění projektu. Pokud tuto funkci nemá, snadno se stane, že balíčky instalujete do globálního prostředí a po čase narazíte na konflikty verzí. To je jeden z nejčastějších zdrojů frustrace, přitom se mu dá snadno předejít právě správným výběrem.
Při psaní příkazů se vyhněte tvrdě zakódovaným tajemstvím, jako jsou API klíče nebo hesla. GitHub Actions umožňuje ukládat je do sekce Secrets v nastavení repozitáře a v souboru je pak odkazujete přes $ secrets.NAZEV . Tím se hodnoty nezobrazí v logu a můžete je měnit bez úpravy kódu. Klíčové je také správně nastavit oprávnění tokenu – pokud potřebujete nasadit na produkci, vytvořte si osobní přístupový token s minimálními právy a uložte ho jako secret, nikdy nepoužívejte výchozí GITHUB_TOKEN pro akce s vyššími oprávněními.<br><br>Na závěr si osvojte jednu užitečnou návyk: pište si ke každému projektu soubor .dockerignore. Do něj vložte složky jako node_modules nebo .git, aby se při buildu nekopírovaly zbytečné soubory. Nejenže to zrychlí build, ale také zabrání tomu, aby se do obrazu dostaly citlivé údaje z vašeho lokálního prostředí. Docker není kouzlo, ale když se naučíte jeho základní principy, ušetří vám hodiny práce při nasazování aplikací. Vyzkoušejte si to na malém projektu vytvořte si vlastní obraz, spusťte ho a postupně přidávejte další funkce, jako jsou svazky nebo síťová propojení mezi kontejnery. Za pár dní zjistíte, že bez kontejnerů už nechcete pracovat.<br><br>Typickou chybou je spoléhat na skutečné API volání nebo na globální store. Takový test je pomalý a náchylný na selhání z důvodu síťových výpadků. Další častou chybou je zapomenout na asynchronní povahu thunku – test skončí dřív, než thunk stihne dokončit. Řešením je použít async/await nebo zpětné volání, které počká na dokončení. V neposlední řadě se vyvarujte testování reducerů přes store – to je integrační test, který nepotřebujete pro pokrytí čisté logiky.<br><br>Jak si vytvořit první kontejner a nespálit se Základním stavebním kamenem je soubor Dockerfile. Ten popisuje, jak se má výsledný obraz vytvořit. Začněte jednoduchým příkladem: vezměte oficiální obraz jazyka Python, nakopírujte do něj svůj skript a nastavte příkaz, který se má spustit. Důležité je dodržet pořadí instrukcí. Pokud totiž změníte pouze kód aplikace, Docker využije cache a build proběhne rychle. Pokud ale nejprve zkopírujete celý projekt a teprve poté instalujete závislosti, každá změna v kódu způsobí, že se závislosti instalují znovu, což je pomalé a frustrující.<br><br>Jakmile máte Docker v provozu, začněte s jednoduchým projektem. Vytvořte složku, do ní vložte soubor s názvem Dockerfile a do něj napište následující řádky: FROM node:20-alpine, WORKDIR /app, COPY . ., RUN npm install a CMD ["node", "server.js"]. Tento Dockerfile říká Dockeru, aby použil oficiální obraz Node.js, nastavil pracovní složku, zkopíroval soubory, nainstaloval závislosti a spustil server. Poté v terminálu spusťte docker build -t moje-aplikace . (tečka na konci je důležitá – označuje aktuální složku). Po úspěšném buildu spustíte kontejner příkazem docker run -p 3000:3000 moje-aplikace. Parametr -p mapuje port z kontejneru na váš počítač, takže aplikaci otevřete v prohlížeči na adrese localhost:3000.<br><br>Když se řekne Docker, mnoho začátečníků si představí složitý nástroj pro správce sítí. Opak je pravdou – Docker je v podstatě způsob, jak zabalit aplikaci i všechny její závislosti do jednoho přenosného balíčku, kterému se říká kontejner. Místo instalace deseti různých verzí knihoven do systému si vytvoříte obraz, který obsahuje přesně to, co vaše aplikace potřebuje. Tento obraz pak můžete spustit kdekoli, kde je nainstalovaný Docker – na notebooku, serveru i v cloudu. Pro začátek stačí pochopit tři základní pojmy: obraz, kontejner a Dockerfile.<br><br>Základní workflow začíná souborem ve složce .github/workflows. Název souboru si zvolte podle účelu, například ci.yml. Na začátku definujete události, které pipeline spouští – nejčastěji push do větve main a pull requesty. Dále specifikujete Runner, tedy prostředí, na kterém se úlohy vykonávají. Pro JavaScript a Python stačí obvykle ubuntu-latest, ale pokud potřebujete Windows nebo macOS, GitHub nabízí i tyto varianty. Vždy je vhodné pinout verzi runneru, abyste předešli nečekaným změnám ve výchozím prostředí.<br><br>Co se týče praktických rad, vždy si ověřte, že obraz, který stahujete, je oficiální a aktualizovaný. Na veřejných registrech najdete tisíce obrazů, ale ne všechny jsou udržované. Spolehněte se na ty, které mají jasný popis a jsou spravované přímo dodavatelem technologie. Dále se vyhněte používání tagu latest pro produkci. I když se to zdá pohodlné, takový obraz se může ze dne na den změnit a vaše aplikace pak přestane fungovat z ničeho nic. Raději používejte konkrétní verze, i když to znamená občasné manuální aktualizace.

Revision as of 02:30, 22 August 2026

Při psaní příkazů se vyhněte tvrdě zakódovaným tajemstvím, jako jsou API klíče nebo hesla. GitHub Actions umožňuje ukládat je do sekce Secrets v nastavení repozitáře a v souboru je pak odkazujete přes $ secrets.NAZEV . Tím se hodnoty nezobrazí v logu a můžete je měnit bez úpravy kódu. Klíčové je také správně nastavit oprávnění tokenu – pokud potřebujete nasadit na produkci, vytvořte si osobní přístupový token s minimálními právy a uložte ho jako secret, nikdy nepoužívejte výchozí GITHUB_TOKEN pro akce s vyššími oprávněními.

Na závěr si osvojte jednu užitečnou návyk: pište si ke každému projektu soubor .dockerignore. Do něj vložte složky jako node_modules nebo .git, aby se při buildu nekopírovaly zbytečné soubory. Nejenže to zrychlí build, ale také zabrání tomu, aby se do obrazu dostaly citlivé údaje z vašeho lokálního prostředí. Docker není kouzlo, ale když se naučíte jeho základní principy, ušetří vám hodiny práce při nasazování aplikací. Vyzkoušejte si to na malém projektu – vytvořte si vlastní obraz, spusťte ho a postupně přidávejte další funkce, jako jsou svazky nebo síťová propojení mezi kontejnery. Za pár dní zjistíte, že bez kontejnerů už nechcete pracovat.

Typickou chybou je spoléhat na skutečné API volání nebo na globální store. Takový test je pomalý a náchylný na selhání z důvodu síťových výpadků. Další častou chybou je zapomenout na asynchronní povahu thunku – test skončí dřív, než thunk stihne dokončit. Řešením je použít async/await nebo zpětné volání, které počká na dokončení. V neposlední řadě se vyvarujte testování reducerů přes store – to je integrační test, který nepotřebujete pro pokrytí čisté logiky.

Jak si vytvořit první kontejner a nespálit se Základním stavebním kamenem je soubor Dockerfile. Ten popisuje, jak se má výsledný obraz vytvořit. Začněte jednoduchým příkladem: vezměte oficiální obraz jazyka Python, nakopírujte do něj svůj skript a nastavte příkaz, který se má spustit. Důležité je dodržet pořadí instrukcí. Pokud totiž změníte pouze kód aplikace, Docker využije cache a build proběhne rychle. Pokud ale nejprve zkopírujete celý projekt a teprve poté instalujete závislosti, každá změna v kódu způsobí, že se závislosti instalují znovu, což je pomalé a frustrující.

Jakmile máte Docker v provozu, začněte s jednoduchým projektem. Vytvořte složku, do ní vložte soubor s názvem Dockerfile a do něj napište následující řádky: FROM node:20-alpine, WORKDIR /app, COPY . ., RUN npm install a CMD ["node", "server.js"]. Tento Dockerfile říká Dockeru, aby použil oficiální obraz Node.js, nastavil pracovní složku, zkopíroval soubory, nainstaloval závislosti a spustil server. Poté v terminálu spusťte docker build -t moje-aplikace . (tečka na konci je důležitá – označuje aktuální složku). Po úspěšném buildu spustíte kontejner příkazem docker run -p 3000:3000 moje-aplikace. Parametr -p mapuje port z kontejneru na váš počítač, takže aplikaci otevřete v prohlížeči na adrese localhost:3000.

Když se řekne Docker, mnoho začátečníků si představí složitý nástroj pro správce sítí. Opak je pravdou – Docker je v podstatě způsob, jak zabalit aplikaci i všechny její závislosti do jednoho přenosného balíčku, kterému se říká kontejner. Místo instalace deseti různých verzí knihoven do systému si vytvoříte obraz, který obsahuje přesně to, co vaše aplikace potřebuje. Tento obraz pak můžete spustit kdekoli, kde je nainstalovaný Docker – na notebooku, serveru i v cloudu. Pro začátek stačí pochopit tři základní pojmy: obraz, kontejner a Dockerfile.

Základní workflow začíná souborem ve složce .github/workflows. Název souboru si zvolte podle účelu, například ci.yml. Na začátku definujete události, které pipeline spouští – nejčastěji push do větve main a pull requesty. Dále specifikujete Runner, tedy prostředí, na kterém se úlohy vykonávají. Pro JavaScript a Python stačí obvykle ubuntu-latest, ale pokud potřebujete Windows nebo macOS, GitHub nabízí i tyto varianty. Vždy je vhodné pinout verzi runneru, abyste předešli nečekaným změnám ve výchozím prostředí.

Co se týče praktických rad, vždy si ověřte, že obraz, který stahujete, je oficiální a aktualizovaný. Na veřejných registrech najdete tisíce obrazů, ale ne všechny jsou udržované. Spolehněte se na ty, které mají jasný popis a jsou spravované přímo dodavatelem technologie. Dále se vyhněte používání tagu latest pro produkci. I když se to zdá pohodlné, takový obraz se může ze dne na den změnit a vaše aplikace pak přestane fungovat z ničeho nic. Raději používejte konkrétní verze, i když to znamená občasné manuální aktualizace.