GitHub Actions

GitHub Actions spúšťa workflow nad udalosťami repozitára. Oprávnenia tokenu a kontext spúšťacej udalosti ovplyvňujú, čo môže úloha zmeniť.

Rozhodnutia pri návrhu

Prístup k produkčnému prostrediu oddelíme od spracovania cudzích zmien. Pre vydanie treba zaznamenať presnú revíziu kódu a všetkých externých akcií.

Príklad z pracovného postupu

Zmena dokumentácie môže spustiť rovnaký workflow ako zmena programu, ale nepotrebuje právo na nasadenie. Pri skúške skontrolujeme oprávnenie jednotlivých úloh a to, ktoré prostredie môže použiť konkrétny typ udalosti.

Ako výsledok overiť

Prejdeme neúspešný test, opakovaný beh a nasadenie rovnakého artefaktu s doložiteľným pôvodom.

Identita artefaktu a rozhodnutie o vydaní

Schválenie má patriť konkrétnemu výsledku zostavenia, nie pohyblivému názvu vetvy. Ak sa medzi testom a nasadením artefakt zostaví znova s odlišnou závislosťou, už nemusí ísť o overenú verziu.

Záznam vydania preto spája zdrojovú revíziu, identitu balíka, výsledky povinných kontrol a cieľové prostredie. Pri plánovanom návrate skontrolujeme aj kompatibilitu databázovej schémy a zachovanie používateľských údajov.

Pôvodný odborný zdroj – GitHub Actions

Značka vydania má patriť tomu istému obsahu ako zverejnený balík

Vývojár môže označiť opravu verziou, zatiaľ čo vedľajšia vetva už obsahuje ďalšie zmeny. Ak zostavenie po udelení značky číta najnovšiu pracovnú vetvu, vznikne balík s obsahom, ktorý nebol predmetom označenia. Číslo verzie v rozhraní pritom môže vyzerať správne.

Proces vydania preto zaznamená presnú revíziu, identitu výsledku a väzbu na používanú značku. Pri skúške sa po označení pridá ďalšia odlišná úprava. Do staršieho vydania sa nesmie dostať a informácia o zostavení musí umožniť rozdiel spätne vysvetliť.

Otázky z praxe

Aké oprávnenia potrebuje kontrola navrhovanej zmeny?

Testy cudzieho návrhu obvykle potrebujú prečítať kód a vytvoriť výsledok kontroly. Sprístupnenie produkčného účtu by zásadne zmenilo dôsledky spusteného kódu. Pred prijatím preskúmame, ktoré udalosti workflow spúšťajú, aké práva má token a ktoré údaje prijímajú jednotlivé použité akcie.

Ako uchovať presnú podobu externej akcie pri vydaní?

Do záznamu vydania uložíme konkrétnu revíziu externej akcie, pretože čitateľné označenie verzie môže neskôr odkazovať na iný stav. Pri plánovanej aktualizácii skontrolujeme zmenu a prejdeme rovnaké skúšobné zostavenie. Výsledok spojíme s revíziou vlastného projektu a s identitou výsledného balíka.

Ako zistiť, kam až došlo nasadenie po prerušení workflow?

Vonkajší systém môže prijať požiadavku skôr, než workflow stihne zapísať výsledok. Pre nasadenie preto uchováme dohľadateľnú identitu a pri opakovaní si overíme stav cieľovej služby. Kritickým krokom je kontrola verzie, ktorá skutočne prijíma používateľské požiadavky, vrátane prípadne nedokončenej výmeny.

Potrebujete poradiť?

Opíšte nám, čo potrebujete vyriešiť. Odpovedáme e-mailom.

O čo máte záujem?

Martin Michalka vám pošle návrh e-mailom. Opíšte jednu úlohu, ktorú vo firme robíte opakovane.

Ako vás máme kontaktovať?