InnerWeb
Przejdź do treści

Migracje bazy przy aktualizacji systemu: uwagi wdrożeniowe

Aktualizacja systemu to nie tylko nowy obraz kontenera, ale też migracje bazy, które zmieniają strukturę danych. Na instalacji o długiej historii wersji każda migracja musi poradzić sobie ze stanem, jaki dana instalacja faktycznie ma. Poniżej lista kontrolna dla administratora: co sprawdzić przed uruchomieniem, jak liczyć czas okna i jakie reguły stosuje producent.

6
instalacji, na których kopiach sprawdzono migracje
Źródło: karta
3–32 s
zakres czasu wykonania migracji na tych kopiach
Źródło: karta
380
migracji w łańcuchu przy starcie od pustej bazy
Źródło: karta

Czym jest migracja i dlaczego bywa ryzykowna

Migracja to skrypt zmieniający strukturę bazy: dodaje kolumnę, tworzy tabelę, zmienia indeks. Nowa wersja aplikacji zakłada, że migracje zostały wykonane, więc ich przerwanie w połowie zostawia system w stanie, w którym oprogramowanie nie zgadza się z bazą. Najbardziej narażone są instalacje o długiej historii wersji, bo przeszły wiele zmian i mogą różnić się od siebie drobiazgami.

Dlatego producent traktuje migracje jak kod produkcyjny i sprawdza je na kopiach rzeczywistych instalacji, a administrator ma dodatkowe kroki przed uruchomieniem.

Reguły pisania migracji po stronie producenta

Przyjęliśmy cztery reguły. Migracje nie używają ORM wewnątrz skryptu, bo mapowanie obiektów zależy od aktualnego kodu, a nie od historycznego stanu bazy. Każda instrukcja ma osłonę dla instalacji o różnej historii, żeby nie zakładać, że kolumna lub indeks już istnieje albo jeszcze nie. Wyjątki są łapane wąsko, aby prawdziwy błąd nie zniknął w ogólnym przechwyceniu. Wreszcie zakaz pomijania migracji: pominięta migracja zostaje oczekująca na zawsze i przy każdej kolejnej aktualizacji wraca jako problem.

Zadanie CI uruchamia cały łańcuch migracji na pustej bazie przy każdej zmianie i wymaga, by baza była zgodna z kodem. To sprawdza ścieżkę od zera, ale nie zastępuje próby na kopii bazy o długiej historii.

  • bez ORM wewnątrz migracji
  • osłona każdej instrukcji dla instalacji o różnej historii
  • wąskie łapanie wyjątków
  • zakaz pomijania migracji

Zakres czasu migracji na kopiach produkcyjnych

Zakres czasu migracji na kopiach produkcyjnychWykres słupkowy: najkrótsza migracja 3 sekundy, najdłuższa 32 sekundy na kopiach sześciu instalacji.010203040sekundNajkrótszy: 3 sekund3 sekundNajkrótszyNajdłuższy: 32 sekund32 sekundNajdłuższy
Źródło: Karta: próba na kopiach produkcyjnych sześciu instalacji (3–32 s)

Próba na kopiach produkcyjnych: czasy, które znamy

Migracje sprawdzono na kopiach produkcyjnych sześciu instalacji z uruchomionym kodem nowej gałęzi. Każda zakończyła się powodzeniem, a czas wykonania wahał się od kilku do kilkudziesięciu sekund, dokładnie w zakresie 3–32 s. Są to czasy dla konkretnych migracji i konkretnych rozmiarów baz, więc przy innej zmianie mogą być inne.

Wniosek praktyczny: do okna serwisowego dodaj zapas wielokrotnie większy niż najdłuższy zmierzony czas, a na własnej instalacji zmierz czas na kopii na preprodukcji.

Co sprawdzić przed uruchomieniem na produkcji

Kolejność działań jest ważniejsza niż same komendy. Zacznij od kopii, potem preprodukcja, potem okno na produkcji.

  • Aktualna kopia bazy i magazynu plików wykonana tuż przed oknem.
  • Kopia przywrócona na preprodukcji i sprawdzona.
  • Migracje uruchomione na preprodukcji z nową wersją kodu, czas zapisany.
  • Wolne miejsce na dysku większe niż rozmiar największej tabeli.
  • Lista oczekujących migracji porównana z listą z kopii, bez pominiętych.
  • Plan wycofania: kopia pod ręką i osoba, która ją odtwarza.

Pułapki, które widzieliśmy w praktyce

Pierwsza: łańcuch migracji pękający na siódmej migracji świeżej bazy. Ujawnił się dopiero przy próbie startu od zera, więc dodaliśmy do CI zadanie, które pilnuje tego przy każdej zmianie. Druga: założenie, że wszystkie instalacje wyglądają tak samo, co zawodzi przy długiej historii wersji. Trzecia: uruchamianie ciężkich zadań w tym samym czasie, co migracje, bo konkurują o pamięć i dysk.

Dla porównania start czystego środowiska od pustej bazy do działającego logowania trwał w teście około 8 minut, głównie przez wykonanie 380 migracji, ale to czas dla instalacji bez historii i danych, nie dla produkcji.

Materiał wideo

Często zadawane pytania

Ile trwają migracje przy aktualizacji?

Na kopiach produkcyjnych sześciu instalacji od 3 do 32 sekund. Na własnej instalacji zmierz czas na preprodukcji, bo zależy od rozmiaru bazy.

Czy można pominąć migrację, która się nie udaje?

Nie. Pominięta migracja zostaje oczekująca na zawsze. Należy ustalić przyczynę, naprawić ją i uruchomić migrację ponownie.

Po co próba na preprodukcji, skoro CI sprawdza migracje?

CI sprawdza ścieżkę od pustej bazy, a preprodukcja stan instalacji o długiej historii i prawdziwy rozmiar danych.

Czy instalacja o starszej wersji przejdzie aktualizację?

Migracje mają osłony dla instalacji o różnej historii, ale decyduje próba na kopii konkretnej instalacji.

Źródła

Zaplanujmy aktualizację razem z IT

Wspólnie ustalimy kolejność: kopia, próba migracji na preprodukcji i okno na produkcji z planem wycofania.

Porozmawiajmy