Hoe je databasemigraties scheidt van het opstarten van de app tijdens containeruitrol

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Dubbele databasemigraties voorkom je gemakkelijker wanneer schemaveranderingen als één expliciete implementatiestap worden uitgevoerd in plaats van bij het opstarten van elke appcontainer.

Het preventieve ontwerp geeft migraties één verantwoordelijke, één set inloggegevens en één voltooiingssignaal voordat nieuwe replica's verkeer gaan verwerken. Zorg dat web- en workercontainers opnieuw kunnen starten zonder rechten te krijgen om het schema te wijzigen, laat de uitrol wachten tot een migratietaak is geslaagd en ontwerp schemaveranderingen zo dat de oude en nieuwe appversies korte tijd naast elkaar kunnen bestaan. Zo voorkom je de raceconditie, in plaats van er alleen maar op te hopen dat elke replica dezelfde migratiegeschiedenis als eerste opmerkt.

Verwijder migratieopdrachten uit het normale opstartproces van de app

Controleer het startscript van de image, de Compose-opdracht, de workeropdracht, de gezondheidscontrolewrapper en het implementatiescript op automatische migratieaanroepen. De applicatie moet opnieuw kunnen starten zonder het schema te wijzigen, tenzij die herstart de bewust gekozen migratiestap is.

Een implementatieartikel van Octopus stelt dat migraties een aparte levenscyclus nodig hebben, in plaats van gekoppeld te zijn aan het starten van elk microserviceproces.

Houd het migratieprogramma beschikbaar waar nodig, maar roep het niet aan vanuit zowel het startscript van de webapp als een tweede taak. Eén expliciete verantwoordelijke is eenvoudiger te controleren dan meerdere opstartpaden die allemaal afhankelijk zijn van vergrendeling door het framework.

Voer één migratietaak uit vóór de implementatie

Maak een eenmalige taak die dezelfde migratiebestanden als de release gebruikt en pas succesvol wordt beëindigd wanneer de doeldatabase de verwachte schematoestand heeft bereikt. Laat de uitrol van de applicatie afhangen van dat resultaat.

Een actuele uitrolgids laat zien hoe één taak wordt uitgevoerd vóór de uitrol, in plaats van elke replica bij het opstarten te laten racen.

Schaal de migratietaak niet op zoals de applicatieservice. De taak moet één uitvoeringsverantwoordelijke per doeldatabase hebben, een begrensde time-out, logboeken en een duidelijke foutstatus die de nieuwe appversie blokkeert.

Blokkeer het starten van de applicatie tot de migratie is geslaagd

Laat nieuwe web- en workercontainers wachten tot de migratiefase als geslaagd is gemarkeerd, maar laat niet elke wachtende container de migratie zelf opnieuw uitvoeren. De afhankelijkheid betreft het resultaat, niet het opnieuw uitvoeren van de schemaverandering.

De implementatiemethode van Andrew Lock gebruikt app-pods wachten op migratie, terwijl de migratielogica gecentraliseerd blijft.

Voor een kleine thuisserveropstelling kan hetzelfde principe worden toegepast met een aparte Compose-service en een gecontroleerd implementatiescript. Houd het mechanisme eenvoudig genoeg om ervoor te zorgen dat een mislukte migratie de uitrol zichtbaar stopt.

Gebruik achterwaarts compatibele schemawijzigingen tijdens de overlap

Bij doorlopende implementaties kunnen oude en nieuwe applicatieversies tijdelijk dezelfde database gebruiken. Vermijd migraties die een veld verwijderen of hernoemen voordat de oude versie het niet meer gebruikt.

Een recente gids voor migraties zonder downtime raadt aan om eerst uit te breiden en daarna in te krimpen, zodat uitbreidende schemawijzigingen worden doorgevoerd voordat destructieve opschoning plaatsvindt.

Splits grote wijzigingen indien nodig op in de fasen uitbreiden, aanvullen, omschakelen en opruimen. De migratietaak mag geen schema aanmaken dat alleen de nieuwe container begrijpt terwijl oude replica's nog verzoeken verwerken.

Houd migratie-inloggegevens buiten app-replica's

Gebruik waar mogelijk alleen voor de eenmalige migratiefase een databaseaccount met bevoegdheden om het schema te wijzigen. Normale app-containers moeten de beperktere lees- en schrijfrechten behouden die nodig zijn voor applicatiegegevens.

Een Liquibase-implementatieartikel beschrijft dat databasewijzigingen in automatisering thuishoren, met gecontroleerde, herhaalbare toepassing van wijzigingen.

Door deze scheiding is het minder waarschijnlijk dat migraties per ongeluk worden uitgevoerd, zelfs als een app-proces opnieuw wordt gestart of gedupliceerd. Bewaar de verhoogde inloggegevens in het pad voor implementatiegeheimen in plaats van in de gewone omgeving van de langdurig draaiende service.

Controleer of de uitrol de batch niet twee keer kan toepassen

Test de implementatie in een wegwerpdatabase of teruggezette momentopname door meerdere app-replica's te starten, ze opnieuw op te starten en de implementatieopdracht opnieuw uit te voeren. De migratiefase moet de bestaande schematoestand melden zonder die een tweede keer te wijzigen.

JetBrains vat de operationele regel samen als migraties uitvoeren als implementatiestap voordat de applicatie normaal opstart.

Het preventiebeleid is compleet wanneer app-herstarts het schema niet kunnen wijzigen, één mislukte migratie de release blokkeert en herhaalde rollout-uitvoering de database ongewijzigd laat. Het gerelateerde ZimaSpace-artikel over diagnose van dubbele migraties biedt de herstelprocedure als de dubbele uitvoering al heeft plaatsgevonden.

Ondersteuning en tips

Meer om te lezen

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.