InnerWeb
Přejít na obsah

Migrace databáze při aktualizaci systému: poznámky k nasazení

Aktualizace systému není jen nový obraz kontejneru, ale také migrace databáze, které mění strukturu dat. U instalace s dlouhou historií verzí musí každá migrace zvládnout stav, v jakém se daná instalace skutečně nachází. Níže je kontrolní seznam pro administrátora: co ověřit před spuštěním, jak počítat čas okna a jaká pravidla výrobce uplatňuje.

6
instalací, na jejichž kopiích byly migrace ověřeny
Zdroj: karta
3 až 32 s
rozsah doby provedení migrací na těchto kopiích
Zdroj: karta
380
migrací v řetězci při startu od prázdné databáze
Zdroj: karta

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

Rozsah doby migrace na produkčních kopiíchSloupcový graf: nejkratší migrace 3 sekundy, nejdelší 32 sekund na kopiích šesti instalací.010203040sekundNejkratší: 3 sekund3 sekundNejkratšíNejdelší: 32 sekund32 sekundNejdelší
Zdroj: Karta: zkouška na kopiích produkce šesti instalací (3 až 32 s)

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