Co je migrace a proč bývá riskantní
Migrace je skript, který mění strukturu databáze: přidá sloupec, vytvoří tabulku, změní index. Nová verze aplikace předpokládá, že migrace proběhly, takže jejich přerušení uprostřed nechá systém ve stavu, kdy software nesouhlasí s databází. Nejvíce jsou ohroženy instalace s dlouhou historií verzí, protože prošly mnoha změnami a mohou se od sebe lišit drobnostmi.
Výrobce proto s migracemi zachází jako s produkčním kódem a ověřuje je na kopiích skutečných instalací. Administrátor pak má navíc několik kroků před spuštěním.
Pravidla psaní migrací na straně výrobce
Přijali jsme čtyři pravidla. Migrace nepoužívají ORM uvnitř skriptu, protože mapování objektů závisí na aktuálním kódu, a ne na historickém stavu databáze. Každá instrukce má ochranu pro instalace s různou historií, takže se nepředpokládá, že sloupec nebo index už existuje, nebo ještě neexistuje. Výjimky se zachytávají úzce, aby se skutečná chyba neztratila v obecném zachycení. A konečně zákaz přeskakování migrací: přeskočená migrace zůstane čekající navěky a při každé další aktualizaci se vrací jako problém.
Úloha CI spustí celý řetězec migrací na prázdné databázi při každé změně a vyžaduje, aby databáze odpovídala kódu. To ověřuje cestu od nuly, ale nenahrazuje zkoušku na kopii databáze s dlouhou historií.
- bez ORM uvnitř migrace
- ochrana každé instrukce pro instalace s různou historií
- úzké zachytávání výjimek
- zákaz přeskakování migrací
Rozsah doby migrace na produkčních kopiích
Zkouška na kopiích produkce: časy, které známe
Migrace jsme ověřili na produkčních kopiích šesti instalací s během kódu nové větve. Každá skončila úspěchem a doba provedení se pohybovala od několika do několika desítek sekund, přesně v rozmezí 3 až 32 s. Jde o časy pro konkrétní migrace a konkrétní velikosti databází, takže při jiné změně mohou být jiné.
Praktický závěr: do servisního okna přidej rezervu mnohonásobně větší než nejdelší naměřený čas a na vlastní instalaci změř čas na kopii na předprodukci.
Co zkontrolovat před spuštěním na produkci
Pořadí kroků je důležitější než samotné příkazy. Začni kopií, potom předprodukce, potom okno na produkci.
- Aktuální záloha databáze a úložiště souborů těsně před oknem.
- Kopie obnovena na předprodukci a ověřena.
- Migrace spuštěny na předprodukci s novou verzí kódu, čas zapsán.
- Volné místo na disku větší než velikost největší tabulky.
- Seznam čekajících migrací porovnán se seznamem z kopie, bez přeskočených.
- Plán návratu: kopie po ruce a osoba, která ji obnoví.
Pasti, které jsme v praxi viděli
První: řetězec migrací selhávající na sedmé migraci čerstvé databáze. Projevil se až při pokusu o start od nuly, proto jsme do CI přidali úlohu, která to hlídá při každé změně. Druhá: předpoklad, že všechny instalace vypadají stejně, což selže u dlouhé historie verzí. Třetí: spouštění těžkých úloh ve stejnou dobu jako migrace, protože soupeří o paměť a disk.
Pro srovnání: start čistého prostředí od prázdné databáze až po funkční přihlášení trval v testu přibližně 8 minut, hlavně kvůli 380 migracím, ale jde o čas pro instalaci bez historie a bez dat, nikoli pro produkci.
Videomateriál
Často kladené otázky
Jak dlouho trvají migrace při aktualizaci?
Na produkčních kopiích šesti instalací od 3 do 32 sekund. Na vlastní instalaci změř čas na předprodukci, protože závisí na velikosti databáze.
Lze přeskočit migraci, která selže?
Ne. Přeskočená migrace zůstane čekající navěky. Je třeba zjistit příčinu, opravit ji a migraci spustit znovu.
Proč zkouška na předprodukci, když CI migrace kontroluje?
CI kontroluje cestu od prázdné databáze, kdežto předprodukce ukáže stav instalace s dlouhou historií a skutečnou velikost dat.
Projde aktualizaci instalace s předchozí verzí?
Migrace mají ochranu pro instalace s různou historií, ale rozhodne zkouška na kopii konkrétní instalace.
Zdroje
Naplánujme aktualizaci spolu s IT
Společně určíme pořadí: záloha, zkouška migrací na předprodukci a okno na produkci s plánem návratu.
Pojďme si promluvit