Felkészülés a tesztfuttatás migrálására
Ez a cikk az adatmigrálási eszköz által igényelt csapatelőkészítéssel és fájllétrehozással foglalkozik.
Előfeltételek
A tesztelési futtatási migrálásra való felkészülés előtt végezze el az érvényesítési fázist .
Áttelepítési beállítások létrehozása
Hajtsa végre az alábbi lépéseket az áttelepítési specifikáció és a kapcsolódó fájlok létrehozásához a gyűjteményadatbázis áttelepítésének várólistára helyezéséhez.
Futtassa a Data Migration Tool prepare parancsot a következő paraméterekkel:
/collection:http://localhost:8080/tfs/DefaultCollection/ tenantDomainName:contoso.com /Region:CUS
- A bérlői tartománynév beállítás a vállalat Microsoft Entra ID-bérlőjének neve.
- A felkészülési parancshoz internet-hozzáférés szükséges. Ha az Azure DevOps Server nem rendelkezik internetkapcsolattal, futtassa a parancsot egy másik számítógépről.
- A "szervezeti régió" kifejezés arra a helyre vonatkozik, ahol a gyűjteményt az Azure DevOps Servicesbe szeretné migrálni. Korábban kiválasztott egy régiót, és rögzítette annak rövidített kódját. Használja ezt a kódot az előkészítési parancsban.
Jelentkezzen be egy olyan felhasználóval a bérlőből, aki engedéllyel rendelkezik a Microsoft Entra ID-bérlő összes felhasználójával kapcsolatos információk olvasására.
A migrálás specifikációs fájljának konfigurálása
A migrálási specifikációs fájl egy JSON-fájl, amely az adatmigrálási eszközt utasítja a következő műveletek végrehajtására.
- A migrált szervezet konfigurálása
- A forráshelyek megadása
- A migrálás testreszabása
A mezők nagy része automatikusan ki lesz töltve az előkészítési lépés során, de a következő mezőket kell konfigurálnia:
- Szervezet neve: Annak a szervezetnek a neve, amelyet az adatok áttelepítéséhez létre szeretne hozni.
- Hely: Az adatbázis biztonsági mentése és az Azure Storage-tárolóba feltöltendő migrálási fájlok. Ez a mező megadja a migrálási eszköz által a forrásfájlokhoz való biztonságos csatlakozáshoz és az Azure Storage-tárolóból való olvasáshoz használt SAS-kulcsot. A tároló létrehozását az 5. fázis későbbi szakasza ismerteti, és a SAS-kulcs létrehozása a 6. fázisban történik, mielőtt új migrálásra vár.
- DACPAC: A gyűjtemény SQL-adatbázisát csomagba csomagoló fájl.
- Migrálás típusa: A migrálás típusa: Tesztfuttatás vagy éles futtatás.
Minden áttelepítési specifikációs fájl egyetlen gyűjteményhez készült. Ha egy másik gyűjteményhez létrehozott áttelepítési specifikációs fájlt próbál használni, az áttelepítés nem indul el. Minden migrálni kívánt gyűjteményhez elő kell készítenie egy tesztfuttatást, és a létrehozott migrálási specifikációs fájllal kell várólistára helyeznie az áttelepítést.
Az identitástérkép naplófájljának áttekintése
Az identitástérkép-napló kulcsfontosságú, olyan fontos, mint az áttelepített tényleges adatok. A naplófájl vizsgálatakor ismerje meg az identitásmigrálás működését és a lehetséges eredményeket. Az identitás migrálása aktív vagy előzmény lehet. Az aktív identitások bejelentkezhetnek az Azure DevOps Servicesbe, míg a korábbi identitások nem. A szolgáltatás dönti el, hogy melyik típust használja a rendszer.
Feljegyzés
Miután az identitást előzményi identitásként migrálták, nem lehet aktív identitássá alakítani.
Aktív identitások
Az aktív identitások az Azure DevOps Services áttelepítés utáni felhasználói identitásaira vonatkoznak. Az Azure DevOps Servicesben ezek az identitások licencelve vannak, és a szervezet felhasználóiként jelennek meg. Az identitások aktívként vannak megjelölve az identitástérkép naplófájljának Várt importálási állapot oszlopában.
Előzményi identitások
Az előzményi identitások a várt importálási állapot oszlopban vannak leképezve az identitásleképezési naplófájlban. A fájlban sorbejegyzés nélküli identitások is előzményként válnak. Egy sorbejegyzés nélküli identitásra példa lehet egy alkalmazott, aki már nem dolgozik egy vállalatnál.
Az aktív identitásoktól eltérően a korábbi identitások:
- A migrálás után nincs hozzáférése egy szervezethez.
- Nincsenek licencek.
- Ne jelenjen meg a szervezet felhasználóiként. Minden, ami megmarad, az identitás nevének fogalma a szervezetben, hogy az előzményei később is kereshetők legyenek. Javasoljuk, hogy használjon előzményi identitásokat azokhoz a felhasználókhoz, akik már nem dolgoznak a vállalatnál, vagy akiknek nincs szükségük további hozzáférésre a szervezethez.
Feljegyzés
Miután egy identitás előzményként migrál, nem teheti aktívvá.
Licencek
A migrálás során a licencek automatikusan hozzá lesznek rendelve az identitásleképezési napló Várt importálási állapot oszlopában "aktívként" megjelenő összes felhasználóhoz. Ha az automatikus licenc-hozzárendelés helytelen, módosíthatja azt egy vagy több felhasználó hozzáférési szintjének szerkesztésével a migrálás befejezése után.
Előfordulhat, hogy a hozzárendelés nem mindig tökéletes, ezért a következő hónap első napjáig szükség szerint újra hozzárendelheti a licenceket. Ha a következő hónap első napjáig nem csatol egy előfizetést a szervezetéhez, és a megfelelő számú licencet vásárolta meg, a türelmi időszak összes licencét visszavonjuk. Másik lehetőségként, ha az automatikus hozzárendelés több licencet rendelt, mint amennyit a következő hónapban vásárolt, akkor nem számítjuk fel a további licenceket, de visszavonjuk az összes ki nem fizetett licencet.
A hozzáférés elvesztésének elkerülése érdekében javasoljuk, hogy a hónap első felében kapcsolja össze az előfizetést, és vásárolja meg a szükséges licenceket, mivel a számlázás havonta fut. Az összes tesztfuttatáshoz a licencek ingyenesek mindaddig, amíg a szervezet aktív.
Azure DevOps-előfizetések
Visual Studio-előfizetések alapértelmezés szerint nincs hozzárendelve az áttelepítésekhez. Ehelyett a Visual Studio-előfizetések felhasználók automatikusan frissítve lesznek a licenc használatára. Ha egy felhasználó munkahelyi szervezete megfelelően van összekapcsolva, az Azure DevOps Services automatikusan alkalmazza a Visual Studio-előfizetés előnyeit az első bejelentkezés utáni migráláskor.
Nem kell megismételnie a tesztfuttatás migrálását, ha a felhasználók nem frissülnek automatikusan a Visual Studio-előfizetésük Azure DevOps Servicesben való használatára. A Visual Studio-előfizetés összekapcsolása olyan dolog, amely a migrálás hatókörén kívül történik. Ha a munkahelyi szervezet megfelelően kapcsolódik az áttelepítés előtt vagy után, akkor a felhasználó a következő bejelentkezéskor automatikusan frissíti a licencét. Miután frissítette őket, a következő migráláskor a rendszer automatikusan frissíti a felhasználót a szervezetbe való kezdeti bejelentkezéskor.
Csak az Azure DevOps Services IP-címeinek hozzáférésének korlátozása
Az Azure Storage-fiókhoz való hozzáférést csak az Azure DevOps Services ip-címére korlátozhatja. A hozzáférést úgy korlátozhatja, hogy csak a gyűjteményadatbázis migrálási folyamatában részt vevő Azure DevOps Services IP-címekről engedélyezi a kapcsolatokat. A tárfiókhoz hozzáférést igénylő IP-címek a migrálandó régiótól függenek.
1. lehetőség: Szolgáltatáscímkék használata
Egyszerűen engedélyezheti a kapcsolatokat az Összes Azure DevOps Services-régióból, ha hozzáadja a azuredevops
szolgáltatáscímkét a hálózati biztonsági csoportokhoz vagy tűzfalakhoz a portálon keresztül vagy programozott módon.
2. lehetőség: IP-lista használata
IpList
A paranccsal lekérheti azoknak az IP-címeknek a listáját, amelyeknek hozzáférést kell biztosítaniuk egy adott Azure DevOps Services-régió kapcsolatainak engedélyezéséhez.
A súgódokumentáció tartalmazza az Azure DevOps Server-példányból és egy távoli gépről történő Migrálás futtatására vonatkozó utasításokat és példákat. Ha a parancsot az Azure DevOps Server-példány egyik alkalmazásszintjéről futtatja, a parancsnak a következő struktúrával kell rendelkeznie:
Migrator IpList /collection:{CollectionURI} /tenantDomainName:{name} /region:{region}
Az IP-címek listáját hozzáadhatja a hálózati biztonsági csoportokhoz vagy tűzfalakhoz a portálon keresztül vagy programozott módon.
IP-tűzfal-kivételek konfigurálása az SQL Azure-hoz
Ez a szakasz csak az SQL Azure tűzfal kivételeinek konfigurálására vonatkozik. A DACPAC-migrálásokról az Azure Storage-tűzfalak és virtuális hálózatok konfigurálása című témakörben olvashat.
Az adatmigrálási eszköz megköveteli, hogy az Azure DevOps Services IP-címeit csak a porton 1433
konfigurálja a bejövő kapcsolatokhoz.
Az alábbi lépések végrehajtásával kivételeket adhat az SQL Azure-beli virtuális gép azure-beli hálózati rétegében kezelt szükséges IP-címekhez.
- Jelentkezzen be az Azure Portalra.
- Nyissa meg az SQL Azure-beli virtuális gépet.
- A Beállítások részen válassza a Hálózat elemet.
- Kattintson a Bejövőport-szabály hozzáadása elemre.
- A Speciális lehetőséget választva konfigurálhat egy bejövő portszabályt egy adott IP-címhez.
- A Forrás legördülő listában válassza ki az IP-címeket, adjon meg egy ip-címet, amelyet kivételként kell megadni, állítsa be a Célporttartományt
1433
, és a Név mezőbe írjon be egy nevet, amely a legjobban leírja a konfigurálni kívánt kivételt.
Más konfigurált bejövő portszabályoktól függően előfordulhat, hogy módosítania kell az Azure DevOps Services kivételeinek alapértelmezett prioritását, hogy ne hagyja figyelmen kívül őket. Ha például az Azure DevOps Services kivételeinél magasabb prioritású "az összes bejövő kapcsolat megtagadása az 1433-hoz" szabály van érvényben, előfordulhat, hogy az adatmigrálási eszköz nem tud sikeres kapcsolatot létesíteni az adatbázissal.
Ismételje meg a bejövő portszabályok hozzáadását, amíg az összes szükséges Azure DevOps Services IP-cím kivételt nem kap. Ha hiányzik egy IP, az azt eredményezheti, hogy a migrálás nem indul el.
Nagyméretű gyűjtemények migrálása
Az adatmigrálási eszköz által figyelmeztetett adatbázisok túl nagyok, az Azure DevOps Servicesbe való migráláshoz más adatcsomagolási megközelítésre van szükség. Ha nem biztos abban, hogy a gyűjtemény túllépi-e a méretküszöböt, futtasson adatmigrálási eszközt a gyűjteményen. Az ellenőrzésből megtudhatja, hogy az SQL Azure-beli virtuálisgép-metódust kell-e használnia a migráláshoz.
Annak meghatározása, hogy csökkentheti-e a gyűjtemény méretét
Ellenőrizze, hogy törölheti-e a régi adatokat. A gyűjtemények idővel nagy mennyiségű adatot hozhatnak létre. Ez a növekedés a DevOps folyamat természetes része, de előfordulhat, hogy nem kell minden adatot megőriznie. Néhány gyakori példa a már nem releváns adatokra a régebbi munkaterületek és a buildelési eredmények.
Az adatmigrálási eszköz megvizsgálja a gyűjteményt, és összehasonlítja a korábban említett korlátozásokkal. Ezután jelzi, hogy a gyűjtemény jogosult-e a DACPAC- vagy AZ SQL-migrálási módszerre. Általánosságban elmondható, hogy ha a gyűjtemény elég kicsi ahhoz, hogy a DACPAC korlátain belül illeszkedjen, a gyorsabb és egyszerűbb DACPAC-megközelítést használhatja. Ha azonban a gyűjtemény túl nagy, az SQL-migrálási módszert kell használnia, amely magában foglalja egy SQL Azure-beli virtuális gép beállítását és az adatbázis manuális migrálását.
Méretkorlátok
A jelenlegi korlátok a következők:
- 150 GB teljes adatbázisméret (adatbázis-metaadatok + blobok) a DACPAC-hez, ha túllépi ezt a korlátot, akkor el kell végeznie az SQL-áttelepítési módszert.
- 30 GB egyéni táblaméret (adatbázis-metaadatok + blobok) a DACPAC-hez, ha bármelyik tábla meghaladja ezt a korlátot, akkor el kell végeznie az SQL-migrálási módszert.
- 1536 GB-os adatbázis-metaadatok mérete az SQL-áttelepítési módszerhez. Ha túllépi ezt a korlátot, figyelmeztetés jelenik meg, azt javasoljuk, hogy a sikeres migrálás érdekében tartsa ezt a méretet.
- 2048 GB-os adatbázis-metaadatok mérete az SQL-áttelepítési módszerhez. Ha túllépi ezt a korlátot, hiba lép fel, ezért nem hajthat végre migrálást.
- Az SQL-áttelepítési metódus blobméreteinek nincs korlátja.
Ha régebbi, már nem releváns összetevőket tisztít meg, az a vártnál sokkal több helyet távolíthat el, és meghatározhatja, hogy a DACPAC migrálási módszert vagy egy SQL Azure-beli virtuális gépet használ-e.
Fontos
A régebbi adatok törlése után csak akkor állítható helyre, ha visszaállítja a gyűjtemény régebbi biztonsági másolatát.
Ha a DACPAC küszöbértéke alatt van, kövesse az utasításokat a DACPAC létrehozásához a migráláshoz. Ha továbbra sem tudja lekérni az adatbázist a DACPAC küszöbértéke alatt, be kell állítania egy SQL Azure-beli virtuális gépet az Azure DevOps Servicesbe való migráláshoz.
SQL Azure-beli virtuális gép beállítása az Azure DevOps Servicesbe való migráláshoz
Hajtsa végre az alábbi magas szintű lépéseket egy SQL Azure-beli virtuális gép (VM) beállításához az Azure DevOps Servicesbe való migráláshoz.
- SQL Azure-beli virtuális gép beállítása
- IP-tűzfal-kivételek konfigurálása
- Adatbázis visszaállítása a virtuális gépen
- [A gyűjtemény konfigurálása migráláshoz
- A migrálás specifikációs fájljának konfigurálása a virtuális gép megcélzásához
SQL Azure-beli virtuális gép beállítása
Sql Azure-beli virtuális gépet gyorsan beállíthat az Azure Portalról. További információ: Windows rendszerű virtuális gép üzembe helyezése az Azure Portalon az SQL Serverrel.
Az SQL Azure-beli virtuális gép és a csatlakoztatott adatlemezek teljesítménye jelentős hatással van a migrálás teljesítményére. Ezért erősen javasoljuk a következő feladatok elvégzését:
- Válasszon ki egy virtuálisgép-méretet
D8s_v5_*
a nagyobb vagy nagyobb szinten. - Felügyelt lemezek használata.
- Tekintse át a virtuális gép és a lemez teljesítményét. Győződjön meg arról, hogy az infrastruktúra úgy van konfigurálva, hogy a virtuális gép IOPS -jának (bemenet/kimenet másodpercenként) és a tároló IOPS-jának ne legyen szűk keresztmetszete a migrálás teljesítményének. Például győződjön meg arról, hogy a virtuális géphez csatlakoztatott adatlemezek száma elegendő a virtuális gép IOPS-jának támogatásához.
Az Azure DevOps Services világszerte számos Azure-régióban érhető el. A migrálás sikeres indításának biztosítása érdekében fontos, hogy az adatok a megfelelő régióban legyenek elhelyezve. Ha helytelen helyen állította be az SQL Azure-beli virtuális gépet, a migrálás nem indul el.
Fontos
Az Azure-beli virtuális géphez nyilvános IP-cím szükséges.
Ha ezt az áttelepítési módszert használja, hozza létre a virtuális gépet egy támogatott régióban. Bár az Azure DevOps Services az Egyesült Államok (USA) több régiójában is elérhető, csak a központi Egyesült Államok régió fogad el új szervezeteket. Most már nem migrálhatja az adatokat más USA-beli Azure-régiókba.
Feljegyzés
A DACPAC-ügyfeleknek a "3. lépés: A DACPAC-fájl feltöltése](migration-test-run.md#)" szakaszban tekintse meg a régió tábláját. A fenti irányelvek csak SQL Azure-beli virtuális gépekre vonatkozik. Ha Ön DACPAC-ügyfél, tekintse meg a migráláshoz támogatott Azure-régiókat.
Használja a következő SQL Azure-beli virtuálisgép-konfigurációkat:
- Konfigurálja az SQL ideiglenes adatbázist úgy, hogy a C meghajtótól eltérő meghajtót használjon. Ideális esetben a meghajtónak elegendő szabad területtel kell rendelkeznie; legalább egyenértékű az adatbázis legnagyobb táblájával.
- Ha a forrásadatbázis mérete a méret csökkentése után még 1 terabájtnál (TB) nagyobb, több 1 TB-os lemezt kell csatolnia, és egyetlen partícióba kell egyesítenie őket, hogy visszaállíthassa az adatbázist a virtuális gépen.
- Ha a gyűjteményadatbázisok mérete meghaladja az 1 TB-ot, érdemes lehet SSD-t (szilárd állapotú merevlemezeket) használni az ideiglenes adatbázishoz és a gyűjteményadatbázishoz is. Érdemes lehet nagyobb virtuális gépeket is használni 16 virtuális PROCESSZOR (vCPU) és 128 GB (gigabájt) RAM (véletlenszerű hozzáférési memória) használatával.
Adatbázis visszaállítása a virtuális gépen
Egy Azure-beli virtuális gép beállítása és konfigurálása után le kell vennie a leválasztott biztonsági másolatot az Azure DevOps Server-példányról az Azure-beli virtuális gépre. A gyűjteményadatbázist vissza kell állítani az SQL-példányon, és nem szükséges telepíteni az Azure DevOps Servert a virtuális gépre.
A gyűjtemény konfigurálása migráláshoz
Miután a gyűjteményadatbázis helyreállt az Azure-beli virtuális gépen, konfiguráljon egy SQL-bejelentkezést, hogy az Azure DevOps Services csatlakozzon az adatbázishoz az adatok migrálásához. Ez a bejelentkezés csak egyetlen adatbázis olvasási elérését teszi lehetővé.
Nyissa meg az SQL Server Management Studiót a virtuális gépen, majd nyisson meg egy új lekérdezési ablakot az áttelepítendő adatbázison.
Állítsa az adatbázis helyreállítását egyszerűre:
ALTER DATABASE [<Database name>] SET RECOVERY SIMPLE;
Hozzon létre egy SQL-bejelentkezést az adatbázishoz, és rendelje hozzá a "TFSEXECROLE" bejelentkezést, az alábbi példához hasonlóan.
USE [<database name>] CREATE LOGIN <pick a username> WITH PASSWORD = '<pick a password>' CREATE USER <username> FOR LOGIN <username> WITH DEFAULT_SCHEMA=[dbo] EXEC sp_addrolemember @rolename='TFSEXECROLE', @membername='<username>'
Tekintse meg az SQL-parancs alábbi példáját:
ALTER DATABASE [Foo] SET RECOVERY SIMPLE;
USE [Foo]
CREATE LOGIN fabrikam WITH PASSWORD = 'fabrikampassword'
CREATE USER fabrikam FOR LOGIN fabrikam WITH DEFAULT_SCHEMA=[dbo]
EXEC sp_addrolemember @rolename='TFSEXECROLE', @membername='fabrikam'
Fontos
Engedélyezze az SQL Server és a Windows hitelesítési módot a virtuális gépen futó SQL Server Management Studióban. Ha nem engedélyezi a hitelesítési módot, az áttelepítés meghiúsul.
A migrálás specifikációs fájljának konfigurálása a virtuális gép megcélzásához
Frissítse a migrálás specifikációs fájlját, hogy tartalmazza az SQL Server-példányhoz való csatlakozással kapcsolatos információkat. Nyissa meg a migrálási specifikációs fájlt, és végezze el a következő frissítéseket:
Távolítsa el a DACPAC paramétert a forrásfájlok objektumából. A módosítás előtti migrálási specifikáció az alábbi példakódhoz hasonlóan néz ki.
A módosítás utáni migrálási specifikáció a következő példakódhoz hasonlóan néz ki.
Adja meg a szükséges paramétereket, és adja hozzá a következő tulajdonságobjektumot a forrásobjektumhoz a specifikációs fájlban.
"Properties": { "ConnectionString": "Data Source={SQL Azure VM Public IP};Initial Catalog={Database Name};Integrated Security=False;User ID={SQL Login Username};Password={SQL Login Password};Encrypt=True;TrustServerCertificate=True" }
A módosítások alkalmazása után a migrálási specifikáció az alábbi példához hasonlóan néz ki.
A migrálási specifikáció mostantól úgy van konfigurálva, hogy sql Azure-beli virtuális gépet használjon a migráláshoz. Folytassa a migrálás előkészítésének további lépéseit. Az áttelepítés befejezése után mindenképpen törölje az SQL-bejelentkezést, vagy forgassa el a jelszót. A Microsoft a migrálás befejezése után nem őrzi meg a bejelentkezési adatokat.
Azure Storage-tároló létrehozása a kiválasztott adatközpontban
Az Azure DevOps adatmigrálási eszközének használatához egy Azure Storage-tárolóra van szükség ugyanabban az Azure-adatközpontban, mint a végleges Azure DevOps Services-szervezet. Ha például azt szeretné, hogy az Azure DevOps Services-szervezet a Központi Egyesült Államok adatközpontban legyen létrehozva, akkor hozza létre az Azure Storage-tárolót ugyanabban az adatközpontban. Ez a művelet jelentősen felgyorsítja az SQL-adatbázis migrálásához szükséges időt, mivel az átvitel ugyanabban az adatközpontban történik.
További információ: Tárfiók létrehozása.
Számlázás beállítása
A rendszer türelmi időszakot helyez el az újonnan migrált Azure DevOps Services-szervezeten, amely lehetővé teszi a csapat számára, hogy befejezze a szükséges lépéseket, és javítsa a licenchozzárendeléseket. Ha arra számít, hogy további felhasználói csomagokat, buildelési vagy üzembehelyezési folyamatokat, üzemeltetett buildelési szolgáltatásokat, üzemeltetett terheléstesztelési szolgáltatásokat szeretne vásárolni, például azt javasoljuk, hogy biztosan rendelkezik olyan Azure-előfizetéssel, amely készen áll a migrált szervezethez való kapcsolódásra. A türelmi időszak a migrálás befejezése után a következő hónap első napján ér véget.
A migrálás utáni fázisban (hivatkozás) ismét emlékeztetjük arra, hogy mikor kell elvégeznie a csatolást. Ez az előkészítési lépés többet jelent annak biztosításáról, hogy tudja, melyik Azure-előfizetést használja a későbbi lépésben. További információ: A szervezet számlázásának beállítása.