První unit test napíšeš za hodinu, když začneš od jedné funkce

Z Mazovia


Typická chyba začátečníka je snaha otypovat všechno ručně a všude. Začněte u dat: rozhraní pro to, co přichází z API, pro stav aplikace, pro parametry funkcí. Když máte typy dat, typy funkcí vyplynou samy. Naopak any používejte jen jako dočasnou záchrannou brzdu a vždy si k němu napište komentář, proč tam je. any vypne kontrolu a šíří se dál, aniž byste si toho všimli.

Poslední věc, kterou většina podcení: licence musí odpovídat tomu, co skutečně prodáváte. Pokud nabízíte hosting nebo službu nad otevřeným kódem, If you beloved this article and Wiki.Die-Karte-Bitte.De you would like to collect more info concerning corps.Humaniste.info kindly visit our web site. copyleft vás neomezuje, protože kód needistribuujete. Pokud ale dodáváte zákazníkům binárky nebo zdrojáky, podmínky se uplatní. Rozhodněte se podle modelu šíření, ne podle toho, co je zrovna populární, a výsledek si nechte zkontrolovat někým, kdo licence skutečně čte.

Typická chyba je kombinace licencí, které nejdou dohromady. Když do projektu přidáte kód pod silným copyleftem a zbytek držíte permisivně, výsledek se chová podle přísnější licence. To může nechtěně „nakazit" celý projekt. Před sloučením cizího kódu si vždy ověřte, pod jakou licencí byl zveřejněn a zda jeho podmínky nejsou v rozporu s licencí vašeho projektu. Pozor také na soubory bez licenční hlavičky: nepřítomnost licence neznamená volné užití, naopak znamená, že nemáte žádná práva.

Typická chyba je míchat obojí do jednoho souboru. Vývojář přidá do application.properties hodnotu pro produkci, protože to bylo rychlé, a příští commit ji přepíše. Řešení: v kódu nechte jen klíče bez hodnot nebo s bezpečnými výchozími hodnotami a všechny ostré hodnoty vkládejte až při nasazení. Další častá chyba je verzování tajemství v gitu s odůvodněním, že repozitář je přece privátní. Privátní repozitář není trezor a historie commitů se nedá vzít zpět.

Prvním krokem je ujasnit, co je kód a co konfigurace. Kód je to, co se vyvíjí, testuje a nasazuje jako artefakt. Konfigurace je to, co se mění podle prostředí: připojovací řetězce, adresy služeb, limity, zapínání featur. Do repozitáře s kódem patří výchozí hodnoty a šablony, ne ostré hodnoty pro produkci. Pokud se do gitu commitují reálné klíče a hesla, dřív nebo později je najde někdo, kdo je hledat nemá.

Pipeline se vyplatí udržovat jako součást kódu. Když se změní způsob buildu, upravte workflow ve stejném commitu. Jinak se stane, že lokální build funguje a pipeline selhává kvůli zastaralému kroku. Pravidelně kontrolujte logy neúspěšných běhů a opravujte příčiny, ne následky. Rozdíl mezi ručním nasazením a pipeline není v tom, že pipeline je modernější, ale v tom, že chyby odhalíte dřív a opakujete je méně často.

Pro nasazení mějte samostatný workflow spouštěný pouze na větvi main nebo na tagu. Tím zabráníte tomu, aby se do produkce dostal neotestovaný kód z rozpracované větve. U nasazení na server přes SSH si dejte pozor na to, že klíč musí být uložený jako tajná hodnota a že cílový server musí mít odpovídající oprávnění. Častou chybou je také zapomenutý krok ověření, že nasazení skutečně proběhlo — přidejte jednoduchý zdravotní test, který po nasazení zkontroluje, že aplikace odpovídá.

Volba licence není formalita, kterou lze odložit na konec projektu. Rozhoduje o tom, kdo může váš kód použít, jak jej smí upravovat a zda z něj může postavit uzavřený produkt. Permisivní licence a copyleft představují dva protilehlé póly a většina chyb vzniká tím, že autor zvolí jeden extrém, aniž by zvážil, jak chce projekt dál rozvíjet. Než cokoli zveřejníte, položte si otázku, co od projektu očekáváte za rok nebo dva: firemní adopci, zapojení komunity, nebo obojí.

Začněte souborem v adresáři .github/workflows, například build.yml. V něm definujete, kdy se má workflow spustit (on: push na větev main nebo pull_request), na jakém prostředí poběží (runs-on: ubuntu-latest) a jaké kroky se mají provést. Typický postup je checkout repozitáře, nastavení verze jazyka, instalace závislostí, build a testy. Teprve po úspěšných testech přidáte krok nasazení. Klíčové je, že každý krok běží v izolovaném prostředí a výsledek je reprodukovatelný.

Kde se pipeline nejčastěji rozbíjí Největší chybou je ukládání přístupových údajů přímo do YAML souboru. Klíče a tokeny patří do tajných hodnot repozitáře a v workflow se odkazují přes kontext secrets. Pozor ale na to, že tajné hodnoty se ve skriptech spouštěných z pull requestu z cizího repozitáře neposkytují — pokud je potřebujete, oddělte build a nasazení do různých workflow nebo použijte podmínky. Další častý problém je příliš široká matice verzí: testování na deseti kombinacích jazyka a operačního systému zbytečně prodlužuje běh a spotřebovává limity.