Proč číslo verze nestačí
Závody obvykle zapíší číslo verze z hlavičky aplikace a na tom skončí. Takové číslo bývá marketingové nebo souhrnné a jedna verze může zahrnovat desítky změn nasazených postupně. Když se po aktualizaci objeví problém, nezáleží na tom, která to je verze, ale po které změně to začalo.
Proto se vyplatí domluvit s dodavatelem identifikátor, který jednoznačně ukazuje na změnu. V popisovaném systému je verze vydání v hlášeních chyb zkrácený hash commitu nasazeného obrazu, shodný se značkou obrazu v registru. Z jediné řady znaků lze zjistit, jaká změna běží na instanci.
Etapa 1: potvrzení verze po nasazení
Prvním krokem po aktualizaci je přečtení verze z běžící instance a porovnání s verzí, kterou dodavatel ohlásil v oznámení o okně. Shoda znamená, že se nasadil právě tento obraz, a ne předchozí. Neshoda je signál, aby se nepokračovalo dalšími kroky.
Zapište přečtenou verzi do protokolu okna. Až se za měsíc někdo zeptá, s jakou verzí jste pracovali během incidentu, odpověď bude v dokumentu, a ne v něčí paměti.
Rozsah sady prohlížečových testů
Etapa 2: krátký test kritických scénářů
Úplná sada prohlížečových testů trvá zhruba 2 až 2,5 hodiny, proto se po vydání používá krátký seznam. Opíráme jej o rozsah, který testy E2E odtwarzají: přihlášení, administrátorský panel, plánování prací, povolení k práci, hlášení, dokumentace, mapy a analytika. Z tohoto seznamu vyberte scénáře, na kterých závisí bezpečnost změny.
Sada obsahuje 242 testů v 31 souborech a spouští skutečný prohlížeč na skutečném backendu. Test se automaticky ukončí chybou, když se v prohlížeči objeví nezachycená výjimka JavaScriptu nebo odpověď serveru 5xx, takže tichá chyba po aktualizaci neprojde nepozorovaně.
Úskalí: chyba, kterou jednotkové testy nevidí
Po opravě nahlášené chyby se vyplatí spustit prohlížečové testy, protože zachytí chybu viditelnou pro uživatele, kterou jednotkové testy neodhalí, neboť běží na atrapě API. Oprava, která opraví jednu funkci a rozbije tok práce, se ukáže až v testu na skutečném backendu.
Etapa 3: monitoring chyb po vydání
Během prvních hodin po vydání sledujte hlášení chyb rozdělená podle verze vydání. Pokud se nový druh chyby objeví jen u hash nové změny, je příčina známá: je to tato změna. Díky propojení chyby s verzí tým rozhoduje o opravě nebo návratu bez zdlouhavého vyšetřování.
Pamatujte na limity: limit událostí je 21 za hodinu na druh chyby, takže nový druh chyby s vysokou frekvencí uvidíte jako omezený počet událostí, ale s plnou informací o druhu. Alarmy bezpečnosti práce se výpadkem mezipaměti neztlumí: při poruše alarm zazvoní a log problém zaznamená.
Důkaz a uvolnění operátora
Protokol po vydání obsahuje: přečtenou verzi vydání, čas, výsledek krátkého testu kritických scénářů, odkaz na výsledek posledního úplného běhu a jméno osoby, která změnu uvolnila k práci. Je to jedna stránka, kterou může interní auditor porovnat s předchozími okny.
Operátor se vrací k práci až po uvolnění. Je to jednoduché pravidlo, ale jeho absence bývá typickým zdrojem problémů: změna se vrátí do systému, který neprošel kontrolou, a první chybu nahlásí uživatel z haly. Test po vydání existuje proto, aby první chybu nahlásil tým závodu nebo dodavatel.
- přečtení verze z instance a porovnání s oznámením o okně
- krátký test kritických scénářů na skutečném prohlížeči
- tvrdá chyba při výjimce JavaScriptu a odpovědi 5xx
- sledování hlášení chyb rozdělených podle verze vydání
- protokol s verzí, časem, výsledkem a osobou, která uvolnila směnu
Videomateriál
Často kladené otázky
Proč je hash commitu lepší než číslo verze?
Ukazuje přesně jednu změnu a je shodný se značkou obrazu v registru. Každou chybu v hlášeních lze spojit s konkrétní změnou.
Musí se po vydání spustit všechny testy?
Ne. Úplná sada trvá zhruba 2 až 2,5 hodiny. Po vydání stačí krátký seznam kritických scénářů a výsledek posledního úplného běhu slouží jako doplnění.
Co když se verze po nasazení liší od oznámené?
Nepokračujte dalšími kroky. Rozdíl znamená, že se nasadil jiný obraz, než bylo dohodnuto, a před uvolněním operátora je třeba to s dodavatelem vyjasnit.
Domluvme se na protokolu po vydání
Připravíme s vámi jednostránkový protokol: verze, krátký test, osoba uvolňující směnu. Domluvte si schůzku se zespolem InnerWeb.
Pojďme si promluvit