Så separerar du databasmigreringar från appstart vid utrullning av containrar

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Det är enklare att förhindra dubbla databasmigreringar när schemaändringar körs som ett enda uttryckligt driftsättningssteg i stället för vid starten av varje programcontainer.

Den förebyggande lösningen är att ge migreringarna en enda ansvarig, en uppsättning autentiseringsuppgifter och en enda signal om slutförande innan nya repliker börjar hantera trafik. Låt webb- och arbetarcontainrar startas om utan att få behörighet att ändra schemat, låt utrullningen vänta på att ett migreringsjobb lyckas och utforma schemaändringarna så att den gamla och den nya programversionen tillfälligt kan samexistera. Då försvinner kapplöpningsvillkoret, i stället för att man bara hoppas att varje replik först upptäcker samma migreringshistorik.

Ta bort migreringskommandon från programmets normala start

Granska avbildningens startpunkt, Compose-kommandot, arbetarens kommando, hälsokontrollen och driftsättningsskriptet efter automatiska migreringsanrop. Programmet ska kunna startas om utan att ändra schemat, såvida inte omstarten är det avsiktligt valda migreringssteget.

En driftsättningsartikel från Octopus hävdar att migreringar behöver en separat livscykel i stället för att kopplas till varje mikrotjänstprocess start.

Ha migreringsbinären tillgänglig där den behövs, men anropa den inte både från webbens startpunkt och från ett andra jobb. En tydlig ansvarig är enklare att granska än flera startvägar som alla förlitar sig på ramverkets låsning.

Kör ett migreringsjobb före driftsättning

Skapa ett engångsjobb som använder samma migreringsfiler som versionen och avslutas med lyckat resultat först när måldatabasen har nått det förväntade schematillståndet. Låt utrullningen av programmet vara beroende av resultatet.

En aktuell utrullningsguide visar hur ett jobb körs före utrullningen i stället för att låta varje replik konkurrera vid start.

Skala inte migreringsuppgiften på samma sätt som apptjänsten. Jobbet ska ha en enda exekveringsansvarig per måldatabas, en begränsad tidsgräns, loggar och ett tydligt feltillstånd som blockerar den nya appversionen.

Spärra programstart tills migreringen har lyckats

Låt nya webb- och arbetarcontainrar vänta tills migreringssteget rapporterar att det har lyckats, men låt inte varje väntande container köra migreringen igen. Beroendet gäller resultatet, inte att schemabytet ska köras på nytt.

Andrew Locks driftsättningsmönster låter program-poddar vänta på migreringen, samtidigt som migreringslogiken förblir centraliserad.

I en liten hemmaservermiljö kan samma princip tillämpas med en dedikerad Compose-tjänst och ett kontrollerat driftsättningsskript. Håll lösningen tillräckligt enkel för att en misslyckad migrering tydligt ska stoppa utrullningen.

Använd bakåtkompatibla schemaändringar medan versionerna överlappar

Vid rullande driftsättningar kan äldre och nyare appversioner tillfälligt använda samma databas. Undvik migreringar som tar bort eller byter namn på ett fält innan den äldre versionen har slutat använda det.

En ny guide för migrering utan avbrott rekommenderar att expandera innan du kontraherar, så att additiva schemaändringar genomförs före destruktiv rensning.

Dela upp stora ändringar i faserna expandera, fylla i befintliga data, växla och rensa vid behov. Migreringsjobbet ska inte skapa ett schema som bara den nya containern förstår medan äldre instanser fortfarande hanterar förfrågningar.

Håll migreringsuppgifter borta från appinstanserna

Använd om möjligt ett databaskonto med behörighet att ändra schemat endast för det engångskörda migreringssteget. Vanliga appcontainrar bör behålla de mer begränsade läs- och skrivbehörigheter som krävs för appdata.

En artikel om driftsättning med Liquibase beskriver att databasändringar hör hemma i automatiseringen, med kontrollerad och upprepningsbar tillämpning av ändringar.

Den här uppdelningen minskar risken för oavsiktlig migreringskörning även om en approcess startas om eller dupliceras. Lagra den utökade behörigheten bland driftsättningshemligheterna i stället för i den vanliga långkörande tjänstens miljö.

Verifiera att utrullningen inte kan tillämpa ändringspaketet två gånger

Testa driftsättningen i en tillfällig databas eller en återställd ögonblicksbild genom att starta flera appinstanser, starta om dem och köra driftsättningskommandot igen. Migreringssteget ska rapportera det befintliga schematillståndet utan att ändra det en andra gång.

JetBrains sammanfattar den operativa regeln som att köra migreringar som ett driftsättningssteg före normal appstart.

Förebyggande åtgärder är fullständiga när appomstarter inte kan ändra schemat, en misslyckad migrering stoppar driftsättningen och upprepade körningar av utrullningen lämnar databasen oförändrad. Den relaterade ZimaSpace-artikeln om diagnostik av duplicerade migreringar beskriver återställningsalternativet om duplicerad körning redan har inträffat.

Support och tips

Mer att läsa

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.