Dlaczego spójność wersji trzeba sprawdzać po wdrożeniu
Po aktualizacji systemu zespół wdrożeniowy musi potwierdzić dwie rzeczy: że każdy host ma punkt końcowy zapisu dziennika urządzeń i że aplikacja na zegarkach jest w tej samej wersji co backend. Funkcja zapisu dziennika działa tylko na hostach, na których wdrożono backend z tym punktem końcowym. Niewdrożony host zwraca 404 i pozostaje ślepy: zegarki wysyłają partie, a serwer ich nie przyjmuje.
Takiego stanu nie widać na mapie ani w pozycjach pracowników, bo heartbeat działa niezależnie od dziennika. Dlatego bez świadomej kontroli rozbieżność może pozostać niezauważona do pierwszego incydentu, w którym brakuje zapisu zdarzeń.
Krok 1: kontrola punktu końcowego dziennika na każdym hoście
Dla każdego hosta w sieci wdrożeniowej wykonaj próbne wywołanie punktu końcowego dziennika testowym urządzeniem lub kontem testowym. Oczekiwana odpowiedź to potwierdzenie przyjęcia partii. Odpowiedź 404 oznacza, że host nie ma wdrożonego backendu z tą funkcją. Odpowiedź 400 oznacza, że host punkt zna, ale odrzuca partię z powodu błędnego wpisu, bo serwer unieważnia całą partię z kodem 400, gdy choć jeden wpis jest błędny.
Wynik zapisz w tabeli: host, odpowiedź, data i osoba. W przykładowej sieci pięciu hostów wynik 4 z 5 poprawnych oznacza jeden host do natychmiastowej naprawy. Przykład jest ilustracyjny i nie opisuje konkretnej instalacji.
Przykładowa kontrola 5 hostów
Krok 2: wersja aplikacji na urządzeniach
Wersja aplikacji bywa zapisana w kilku miejscach i może się rozjechać. Za prawdę przyjmuje się wersję z manifestu paczki raportowaną przez system zarządzania urządzeniami. Nie opieraj kontroli na numerze widocznym w ustawieniach ani w opisie wdrożenia, jeśli różni się od raportu systemu zarządzania.
Wyeksportuj z systemu zarządzania urządzeniami listę zegarków z wersją i porównaj z wersją docelową. Urządzenia ze starszą wersją trzeba zaktualizować, a te, które nie raportują, sprawdzić fizycznie. Zapisz liczbę urządzeń zgodnych i niezgodnych.
Krok 3: weryfikacja skutku, czyli dziennik z urządzenia
Po sprawdzeniu hostów i wersji zrób próbę końcową. Wywołaj na zegarku zdarzenie testowe i poczekaj na wysyłkę partii: dziennik jest wysyłany co trzeci cykl heartbeatu, czyli przy interwale 26 s około co 78 s. Po czasie dłuższym niż 78 s wpis powinien być widoczny na serwerze z dwoma czasami: urządzenia i odbioru.
Przy porównaniu czasów pamiętaj o strefach. Czas urządzenia bywa w UTC, a część tabel trzyma czas lokalny, więc różnica o 2 godziny to przesunięcie strefy, nie opóźnienie. Zapis dziennika jest bezpieczny dla powtórzeń dzięki unikalności pary użytkownik i identyfikator wpisu, więc próbę można powtórzyć bez ryzyka duplikatów.
Kryteria zamknięcia wdrożenia
Wdrożenie uznaje się za spójne, gdy: wszystkie hosty odpowiadają poprawnie na punkt końcowy dziennika, wszystkie zegarki raportują wersję docelową, a próba końcowa dała wpis na serwerze. Wynik należy zapisać w protokole odbioru, aby w razie sporu było wiadomo, kiedy i kto potwierdził stan.
Okno kolejki na urządzeniu to około 2 godziny, więc po aktualizacji hosta, który był ślepy, zegarki mogą mieć już wypartych starszych wpisów. Nie licz na uzupełnienie historii wsteczną wysyłką: to okno, nie archiwum.
Lista kontrolna
Materiał wideo
Często zadawane pytania
Co oznacza odpowiedź 404 na dziennik?
Host nie ma wdrożonego backendu z tym punktem końcowym i pozostaje ślepy dla zapisu dziennika.
Skąd brać wersję aplikacji?
Z manifestu paczki raportowanego przez system zarządzania urządzeniami, bo inne zapisy mogą się rozjechać.
Po jakim czasie powinien pojawić się wpis testowy?
Po ok. 78 s przy interwale 26 s, bo dziennik jest wysyłany co trzeci heartbeat.
Czy można powtórzyć próbę?
Tak. Unikalność pary użytkownik i identyfikator wpisu zapobiega duplikatom.
Zaplanujmy odbiór wdrożenia
Przygotujemy protokół kontroli hostów i wersji dopasowany do Waszej sieci.
Porozmawiajmy