• 목록
• 답변
• 글쓰기
• 게시판 리스트 옵션
  • 수정
  • 삭제

Základním pravidlem je oddělit shrnutí od podrobností. První řádek by měl být krátký, do padesáti znaků, a měl by odpovídat na otázku, co commit dělá. For more regarding tento článek visit our own website. Třeba „Oprava výpočtu DPH u faktur s měnou EUR". Tento řádek se zobrazuje v přehledech, logu i v e-mailech. Zbývající řádky oddělte prázdným řádkem a tam vysvětlete, proč jste změnu provedli, jaké měla důsledky a jak zařídit malou kuchynié alternativy jste zvažovali. Neopisujte, co je vidět úložné prostory v malém bytě diffu — to už tam je. Pište to, co z kódu nevyčtete.

Když řešíte automatizaci buildů a nasazování, často stojíte před volbou mezi klasickým CI/CD serverem a cloudovou službou typu GitHub Actions. Klíčový rozdíl spočívá v tom, že Actions nemáte kde instalovat a spravovat — běží přímo v prostředí GitHubu, takže odpadá starost s konfigurací runnerů, jejich aktualizací a zálohováním. Pro malé a střední týmy to znamená výrazně kratší cestu od commitu k produkci.

Čtvrtá situace: REST je lepší pro operace typu upload souborů a streaming. HTTP má pro to vyhrazené mechanismy, které GraphQL neumí nativně. Pokud posíláte velké binární soubory, videa nebo obrázky, REST endpoint s multipart/form-data je jednodušší a rychlejší řešení. GraphQL sice zvládá soubory přes specifikaci, ale je to krkolomné a zbytečně komplikované. V praxi se proto soubory posílají klasicky přes REST a zbytek API běží na GraphQL. Není ostuda kombinovat oba přístupy v jedné aplikaci.

Nakonec si ohlídejte i samotné spouštění. Chcete-li, aby workflow běžel i na pull requestech, zapište on: pull_request. Pro nasazení na produkci zase použijte on: push: branches: [main] a kombinujte to s ochranou větve — nikdo by neměl pushovat do main přímo, pokud to není nezbytné. Typická chyba je zapomenout na událost workflow_dispatch, která umožňuje spustit pipeline ručně z UI. Bez ní nemáte možnost si workflow otestovat bez reálného commitu.

Třetí situace: když máte složité, vnořené dotazy napříč více zdroji. Představte si, že potřebujete zobrazit detail článku, autora, komentáře a lajky. V REST byste museli volat čtyři endpointy a slepovat výsledky na klientovi. To způsobuje zpoždění a chyby. GraphQL řeší tento problém jediným dotazem, který vám vrátí kompletní strom dat. Nejvýraznější přínos oceníte u dashboardů, kde se kombinují data z různých služeb. Dejte si ale pozor na N+1 problém: GraphQL resolver se může spustit pro každý záznam zvlášť, což vede k mnoha databázovým dotazům. Vždy používejte batch loading, jinak skončíte s pomalým API.

Pro efektivní caching závislostí použijte built-in cache action. Například pro jazyk Python ukládáte pip cache, pro Node.js npm cache. Klíč cache by měl obsahovat hash lock souboru. Bez cache se byt v panelákuám každý build zdrží o desítky sekund až minut, zvlášť u větších projektů. Nezapomeňte ale cache invalidovat při změně verze interpretu — jinak budete používat staré balíčky.

Dobrá commit message by měla odpovídat na otázku „proč", ne „co". Pokud přidáváte nový parametr do funkce, vysvětlete, že bez něj nelze zpracovat požadavky s časovým pásmem uživatele. Pokud měníte logiku řazení, uveďte, že stávající řešení selhávalo u položek se stejným datem. Typickou chybou je opisovat změny typu „upravena funkce getData" nebo „fix bugs". Taková zpráva je k ničemu, protože nenese žádnou informaci o důvodu ani o souvislostech. Stejně tak se vyhněte emotikonům, vtipům a zkratkám, které jsou srozumitelné jen vám.

Výběr mezi REST API a GraphQL není otázkou módy, ale konkrétních potřeb. REST je starší, ale stále funkční přístup, který vystačí pro většinu klasických aplikací. GraphQL zase řeší problémy s přetíženými odpověďmi a častými round-tripy. Než se rozhodnete, projděte si pět konkrétních situací, kdy má smysl sáhnout po jednom nebo druhém řešení. Klíčové je nepodlehnout dojmu, že GraphQL je univerzálně lepší.

Důležité je správně nastavit i prostředí. Místo tvrdě zapsaných tajemství do YAML souboru používejte GitHub Secrets. V nastavení repozitáře si nadefinujete proměnné, které pak v workflow odkazujete jako secrets.NAZEV. Nikdy je nevypisujte do logů — běžně se to stane při debugování, ale pak je nutné logy smazat a tajemství otočit. Actions automaticky maskuje známé secrets, ale pokud je zkopírujete do jiné proměnné, ochrana selže.

Nakonec si uvědomte, že commit message je komunikace s budoucími čtenáři — včetně vašeho budoucího já. Než commit odešlete, přečtěte si ho nahlas. Když zní jako věta, kterou byste sami pochopili bez znalosti kódu, je pravděpodobně dobrá. Když je vágní, doplňte podrobnosti. Tato minuta navíc se vám mnohonásobně vrátí, až budete příště hledat, kde se stala chyba, nebo proč byla daná funkce napsaná zrovna takhle.