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
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