# Migrering ## Hvad det er En migrering er en planlagt flytning af noget, der allerede er i brug, til en ny version eller en ny platform. Den sker i trin, og til sidst bliver det gamle lukket ned. Det, der flyttes, kan være en hel workload, en applikation, en mængde data eller den struktur, dataene ligger i. Forskellen fra en genopbygning er, at systemet bliver ved med at være i brug undervejs: brugere, data og integrationer følger med, og den gamle version arbejder videre, indtil den nye har taget over. Ordet bruges om arbejde i to størrelser, ofte uden at nogen siger, hvilken af dem der er tale om. I den store skala er det en flytning til en ny platform eller en ny hovedversion. Microsofts Cloud Adoption Framework beskriver det at flytte workloads til Azure, fra egne servere eller fra en anden cloud, som fem trin: planlæg, forbered workloads, gennemfør, optimer og afvikl kilden. Esris kunder flytter deres kort og data fra ArcMap til ArcGIS Pro. En Next.js-applikation flytter fra Pages Router til App Router, hvor `getServerSideProps` afløses af datahentning inde i Server Components. En PostgreSQL-klynge flytter til en ny hovedversion, som ofte ændrer opbygningen af systemtabellerne, så dataene skal føres over med `pg_upgrade` eller med et dump og en gendannelse. I den lille skala er en migrering én versioneret ændring af en databases struktur, gemt som en fil i repositoryet og udført af et værktøj i en fast rækkefølge. Django kalder sine migreringer et versionsstyringssystem for databaseskemaet: hver fil beskriver en ændring af modellerne, bliver committet sammen med koden og køres i samme rækkefølge på udviklerens maskine, på staging og i produktion. GitLab leverer batchede baggrundsmigreringer, der omskriver store tabeller en portion ad gangen efter en opgradering, for eksempel når heltalskolonner gøres til `bigint`, før de løber over. En datamigrering hører også hjemme her: den ændrer rækkerne frem for kolonnerne, for eksempel ved at udfylde et nyt felt ud fra to gamle. Det er én idé i to størrelser. Begge har en kendt starttilstand, en ordnet række trin, et mål og en vej tilbage, hvis et trin går galt. En platformsflytning rummer som regel skemamigreringer, og en lang række skemamigreringer er med årene en platform, der skifter stykke for stykke under dem, der bruger den. ## Hvorfor det betyder noget Software lever længere end det, den er bygget på. Cloudkontrakter bliver genforhandlet, frameworks skifter model, og leverandører udfaser produkter. Et system, der skal leve i ti år, bliver migreret flere gange i løbet af de ti år, så hvor godt et team migrerer, ender med at betyde mere end hvor godt det valgte den første platform. 1. **Mellemstadiet er der, regningen lander.** Mens en del af systemet kører på den gamle platform og en del på den nye, skal begge drives, overvåges og holdes i takt. Cloud Adoption Framework råder til at holde den periode kort og til at flytte komponenter, der afhænger direkte af hinanden, i samme bølge. 2. **En database kan ikke bare udrulles igen.** Kode kan bygges igen og skiftes ud; det kan rækkerne i produktion ikke. Skemamigreringer gør en ændring af strukturen i en kørende database til en fil, der kan reviewes, testes mod en kopi, køres i rækkefølge og for de fleste ændringers vedkommende rulles tilbage. Alternativet er et produktionsskema, der ser ud, som den sidste person med en konsol efterlod det. 3. **En planlagt flytning kan fortrydes.** Cloud Adoption Framework beder om, at kriterier og procedurer for tilbagerulning ligger fast, før en migrering begynder, at tilbagerulningen er testet, og at der er go/no-go-kontrolpunkter undervejs. Afvejningerne ligger i selve omstillingen. Cloud Adoption Framework skelner mellem migrering med nedetid og migrering med næsten nul nedetid, hvor data replikeres løbende, og skiftet sker til sidst. Ved en ny hovedversion af PostgreSQL forkorter `pg_upgrade` omstillingen: værktøjet springer det dump og den gendannelse over, som en sådan opgradering typisk kræver, ved at genbruge de eksisterende datafiler, og i `--link`-tilstand, hvor intet kopieres, går det langt hurtigere. ## Sådan ser det ud i praksis Tre projekter på dette site viser begrebet i tre størrelser, fra en hel platform ned til rækkefølgen af filerne i ét repository. Det største var en flytning væk fra en cloududbyder. En kundes AWS-opsætning var overdimensioneret, og arbejdet begyndte med at skære ned frem for at flytte: duplikerede og unødvendige tjenester forsvandt, og resten blev dimensioneret efter den reelle efterspørgsel. Først derefter [flyttede workloads fra AWS til billigere hosting](/da/portfolio/a-tenth-of-the-cloud-bill-and-nothing-lost/), i etaper, så den kørende forretning ikke mærkede migreringen under sig. Fordi der blev skåret ned først, havde flytningen mindre at bære. Budgetomkostningerne faldt til omkring en tiendedel uden tab af produktivitet. Det andet var et skift af databasemotor med et nyt design i den anden ende. En geografisk kortapplikations database flyttede fra MSSQL til PostgreSQL med udvidelsen PostGIS, og målet var ikke en kopi af den gamle struktur. [Det nye skema blev designet til spatiale data](/da/portfolio/improved-gis-map-performance-10x-on-postgresql/), med GiST- og SP-GiST-indeks og strenge foreign key- og check-constraints, der håndhæver valideringsregler for de spatiale koordinater. Over 50 millioner spatiale poster flyttede ind gennem ETL-pipelines, der transformerede dem til EPSG:4326. En flytning til et nyt design er chancen for at skrive reglerne for dataene ind i selve skemaet. Siden melder om 10 gange bedre ydeevne for spatiale forespørgsler og en CPU-belastning i backend, der faldt med 65 %. Det tredje er den lille skala, holdt ved lige i årevis. En platforms skema er summen af [1.022 migreringer, nummereret fra 036 til 1102](/da/portfolio/1022-migrations-behind-a-schema-drift-gate/), og siden kalder disciplinen om deres rækkefølge kedelig og ikke til forhandling. Historikken i repositoryet er en beskrivelse af produktion, og den holder kun stik, så længe enhver database, fra en udviklers friske kopi til en gendannelse, kan bygges op igen ved at afspille den fra første til sidste fil. ## Hvor det går galt Omstillingen får planlægningen, og problemerne samler sig gerne i ugerne omkring den, i fire genkendelige former. **To systemer kører side om side længere end planlagt.** Flytningen går i stå halvvejs, de stykker, der er tilbage, er de svære, og teamet driver begge platforme i månedsvis. Brugerne mærker sømmen: Next.js-guiden gør opmærksom på, at et skift mellem en side under Pages Router og en side under App Router er en hård navigation, og at `next/link` ikke prefetcher på tværs af de to. Hold bølgerne små, og gør hvert næste trin billigt. Én frontend her flytter sine sider over på [en fælles fabrik, der henter hver side på én rundtur](/da/portfolio/built-the-next-js-16-frontend-ssr-ssg-and-csr/), så hver side, der flyttes, arver opførslen. **En omstilling uden vej tilbage.** Nogle trin ændrer kilden såvel som målet. Med `pg_upgrade --link` har den nye klynge, så snart den er startet, skrevet i filer, som den gamle deler, og den gamle klynge må derefter gendannes fra backup. Esri advarer om, at et datasæt, der er opgraderet til ArcGIS Pro, måske ikke længere kan bruges i ArcMap, og beder brugerne tage en kopi først. I Django udløser en `RunSQL`-operation uden omvendt SQL en `IrreversibleError`, i det øjeblik nogen migrerer baglæns. Fastlæg kriterierne for tilbagerulning før første trin, øv vejen tilbage, og gør den til et tjek: ét repository her har en kontrolmotor, hvis validatorer blandt andet efterprøver, [at en migrering kan rulles tilbage](/da/portfolio/built-a-268-check-guard-engine-for-the-repo/). **En migrering, der allerede er kørt, bliver redigeret.** Migreringsværktøjer registrerer, hvilke filer der er udført, og springer dem over fra da af. Ændrer man en fil, efter at den har nået produktion, beholder produktion den gamle udgave, mens hver ny database får den nye: to skemaer under én historik. Lad udførte migreringer være, og ret dem med en ny; et build, der afspiller hele historikken fra en tom database og sammenligner resultatet med en migreret kopi, fanger afvigelsen. **Den opgraderede database er langsom første dag.** `pg_upgrade` fører de fleste af planlæggerens statistikker over, men ikke alle, og planlæggeren gætter på resten, indtil de er bygget op igen. Tilstanden `--check` ændrer intet og kan køre, mens den gamle server stadig betjener brugere, så kør den først, og genopbyg de manglende statistikker lige efter opgraderingen, før resten indsamles: ```sh pg_upgrade --check -b "$OLD/bin" -B "$NEW/bin" -d "$OLD/data" -D "$NEW/data" pg_upgrade -b "$OLD/bin" -B "$NEW/bin" -d "$OLD/data" -D "$NEW/data" vacuumdb --all --analyze-in-stages --missing-stats-only vacuumdb --all --analyze-only ``` ## Læs mere - [Plan your migration](https://learn.microsoft.com/en-us/azure/cloud-adoption-framework/migrate/) — Microsofts metode til at flytte workloads til Azure: bølger, valg af omstilling og planlægning af tilbagerulning. - [Migrations](https://docs.djangoproject.com/en/stable/topics/migrations/) — Djangos vejledning i versionerede skemaændringer, i at rulle dem tilbage og i datamigreringer. - [pg_upgrade](https://www.postgresql.org/docs/current/pgupgrade.html) — PostgreSQL's opgraderingsværktøj med check-tilstand, link-tilstand, tilbagerulning og statistiktrinnene bagefter. - [How to migrate from Pages to the App Router](https://nextjs.org/docs/app/guides/migrating/app-router-migration) — sådan flyttes en Next.js-applikation til den nye router én side ad gangen. - [Migrate existing work](https://doc.esri.com/en/arcgis-pro/latest/get-started/migrate-existing-work.html) — hvad der følger med fra ArcMap til ArcGIS Pro, hvad der skal konverteres, og hvad der bør kopieres først. - [Check migrations before upgrade](https://docs.gitlab.com/update/background_migrations/) — hvordan GitLabs batchede baggrundsmigreringer omskriver store tabeller efter en opgradering, og hvordan man ser, at de er færdige.