Proč po nasazení kontrolovat shodu verzí
Po aktualizaci systému musí implementační tým potvrdit dvě věci: že každý server má koncový bod pro zápis deníku zařízení a že aplikace v hodinkách je ve stejné verzi jako backend. Funkce zápisu deníku funguje jen na serverech, kde je nasazen backend s tímto koncovým bodem. Nenasazený server vrací 404 a zůstává slepý: hodinky odesílají dávky, ale server je nepřijme.
Tento stav není vidět na mapě ani v pozicích zaměstnanců, protože heartbeat funguje nezávisle na deníku. Bez vědomé kontroly tak může nesoulad zůstat nepovšimnut až do prvního incidentu, kdy chybí záznam událostí.
Krok 1: kontrola koncového bodu deníku na každém serveru
Pro každý server v implementační síti proveď zkušební volání koncového bodu deníku zkušebním zařízením nebo zkušebním účtem. Očekávaná odpověď je potvrzení přijetí dávky. Odpověď 404 znamená, že server nemá nasazený backend s touto funkcí. Odpověď 400 znamená, že server bod zná, ale dávku odmítá kvůli chybnému záznamu, protože server celou dávku s kódem 400 zneplatní, pokud je jediný záznam chybný.
Výsledek zapiš do tabulky: server, odpověď, datum a osoba. V ukázkové síti pěti serverů znamená výsledek 4 správné z 5 jeden server k okamžité opravě. Příklad je ilustrační a nepopisuje konkrétní instalaci.
Ukázková kontrola 5 serverů
Krok 2: verze aplikace na zařízeních
Verze aplikace bývá uložena na několika místech a může se rozejít. Za pravdivou se považuje verze z manifestu balíčku, kterou hlásí systém správy zařízení. Kontrolu nezakládej na čísle viditelném v nastavení nebo v popisu nasazení, pokud se liší od hlášení systému správy.
Z systému správy zařízení vyexportuj seznam hodinek s verzí a porovnej ho s cílovou verzí. Zařízení se starší verzí je třeba aktualizovat a ta, která nehlásí, zkontrolovat fyzicky. Zapiš počet vyhovujících a nevyhovujících zařízení.
Krok 3: ověření účinku, tedy záznam z hodinek
Po kontrole serverů a verzí proveď závěrečný test. Vyvolej na hodinkách zkušební událost a počkej na odeslání dávky: deník se odesílá každý třetí cyklus heartbeatu, tedy při intervalu 26 s přibližně každých 78 s. Po době delší než 78 s by se záznam měl objevit na serveru se dvěma časy: zařízení a přijetí.
Při porovnání časů pamatuj na pásma. Čas zařízení bývá v UTC, část tabulek drží místní čas, takže rozdíl o 2 hodiny je posun pásma, ne zpoždění. Zápis deníku je bezpečný vůči opakování díky jedinečnosti dvojice uživatel a identifikátor záznamu, takže test lze zopakovat bez rizika duplicit.
Kritéria uzavření nasazení
Nasazení se považuje za shodné, když všechny servery správně odpovídají na koncový bod deníku, všechny hodinky hlásí cílovou verzi a závěrečný test dal záznam na serveru. Výsledek se zapíše do předávacího protokolu, aby bylo v případě sporu jasné, kdy a kdo stav potvrdil.
Okno fronty v zařízení je asi 2 hodiny, takže po aktualizaci serveru, který byl slepý, mohou mít hodinky již vytlačené starší záznamy. Nespoléhej na doplnění historie zpětným odesláním: je to okno, ne archiv.
Kontrolní seznam
Videomateriál
Často kladené otázky
Co znamená odpověď 404 na deník?
Server nemá nasazený backend s tímto koncovým bodem a zůstává slepý pro zápis deníku.
Odkud brát verzi aplikace?
Z manifestu balíčku hlášeného systémem správy zařízení, protože jiné zápisy se mohou rozejít.
Po jaké době by se měl objevit zkušební záznam?
Po přibližně 78 s při intervalu 26 s, protože deník se odesílá každý třetí heartbeat.
Lze test zopakovat?
Ano. Jedinečnost dvojice uživatel a identifikátor záznamu zabraňuje duplicitám.
Naplánujme převzetí nasazení
Připravíme protokol kontroly serverů a verzí přizpůsobený vaší síti.
Pojďme si promluvit