Megosztás a következőn keresztül:

Kiszolgálói környezet ellenőrzése és előkészítése a migráláshoz

  • Cikk

Az érvényesítés magában foglalja a frissített Azure DevOps Server-környezet migrálásra való előkészítését. Ez a cikk segítséget nyújt a gyakori problémák elhárításában. Ha nem történt hiba, és az összes ellenőrzési ellenőrzés megfelelt, akkor a csapatprojekt-gyűjtemény készen áll, és továbbléphet a következő fázisra. Tekintse át a naplófájlokat, és keressen hibákat, ha nem minden ellenőrzés átment.

A migrálás hét szakaszának kiemelt Érvényesítési szakaszának diagramja.

Előfeltételek

Töltse le a legújabb adatmigrálási eszközt.

Folyamatérvényesítési típusok megismerása

Az ellenőrzés során az adatmigrálási eszköz határozza meg az egyes projektek célfolyamat-modelljét. Automatikusan hozzárendeli az alábbi két folyamatmodell egyikét a gyűjtemény egyes projektjeihez:

  • Örökölt folyamatmodell: Ha a projektet az Agile, Scrum vagy Képesség-fejlettségi modell integrációja (CMMI) folyamatsablonnal hozták létre, és soha nem lett testre szabva.
  • Üzemeltetett XML-folyamatmodell: Ha úgy tűnik, hogy a projektfolyamat testre van szabva. A testreszabott folyamatok egyéni mezőket, munkaelem-típusokat vagy más testreszabási típusokat tartalmaznak.

Ha az üzemeltetett XML-folyamat a célzott folyamatmodell, az adatmigrálási eszköz ellenőrzi, hogy a testreszabások migrálhatók-e. Az adatmigrálási eszköz két fájlt hoz létre az ellenőrzés során:

  • DataMigrationTool.log: A gyűjteményben található folyamatérvényesítési hibák készletét tartalmazza. Javítsa ki az áttelepítés folytatásához talált összes folyamathibát.
  • TryMatchOobProcesses.log: Listázza minden projekthez a célfolyamat-modellt – Öröklés vagy üzemeltetett XML. Az üzemeltetett XML-folyamatmodellt célzó projektek esetében ez megmagyarázza, hogy miért tekinthetők testre szabottnak. Ezeket a hibákat nem kell kijavítania, de útmutatást nyújtanak arra az esetre, ha át szeretne költözni az öröklési folyamat modelljébe. A gyűjtemények migrálása után áttelepíthet egy projektet egy öröklési folyamatmodellbe.

Csoportprojekt-gyűjtemény ellenőrzése

Mivel minden csapatprojekt-gyűjtemény a saját SQL-adatbázisának felel meg, az ellenőrzési folyamat a gyűjtemény különböző aspektusait vizsgálja, többek között a következőket:

  • A gyűjteményadatbázis mérete
  • Az SQL-adatbázis rendezése
  • A gyűjtemény felhasználóinak identitásai
  • Sablon testreszabása (folyamat)

Az ellenőrzés megkezdéséhez használja a vándorló eszközt. Javasoljuk, hogy futtassa a migrálási eszközt az Azure DevOps Server-környezet egyik alkalmazásrétegbeli (AT) kiszolgálójáról.

Adott parancssori beállítások esetén kérjen súgószöveget a következő paranccsal:

	Migrator validate /help

Az ellenőrzés elindításának leggyakoribb módja a csapatprojekt-gyűjtemény URL-címének megadásával a következő struktúrával:

	Migrator validate /collection:http://localhost:8080/tfs/DefaultCollection

Érvényesítési figyelmeztetések és hibák megtekintése

Amikor a migrálási eszköz befejeződik, naplófájlokat és eredményeket hoz létre a parancssor képernyőjén. Ha nem történik hiba, és minden ellenőrzési ellenőrzés sikeres, a csapat projektgyűjteménye készen áll a következő fázisra. Ha az ellenőrzés sikertelen, tekintse át a naplófájlokat a hibák azonosításához, majd kezelje őket.

Koncentráljon a Migrator.log fájlra, amely az ellenőrzési ellenőrzések alapvető részleteit tartalmazza, és segít megőrizni a testreszabást. A többi fájl a nevük alapján megadott érvényesítési hibáknak felel meg. Keresse meg az "Érvényesítés – Az 1. projekt érvényesítésének megkezdése" sztringet. Minden projekt érvényesítve van. Vizsgálja át az összes projektet, és keressen olyan sorokat, amelyek a következő előtagot tartalmazzák: [Error...

Emellett felsorolja a TryMatchOobProcesses.log házon kívül (OOB) folyamatokat (például Agile, Scrum vagy CMMI) használó projektek hibáit is. Ha egy projekt testreszabás nélkül használ OOB-folyamatot, a projekt szerepel az örökölt modellben. Fontos, hogy a fájl hibái nem akadályozzák az áttelepítési folyamatot.

Képernyőkép az adatmigrálási eszköz által létrehozott DataMigrationTool.log fájlról.

Az érvényesítési hibák listáját az érvényesítési hibák megoldása című témakörben találja. Minden érvényesítési hiba esetében megadtuk a hibaszámot, a leírást és a feloldandó módszert. Az ellenőrzési ellenőrzési naplókban különböző hibatípusok jelenhetnek meg. Kérjen segítséget a betanított DevOps-partnertől, a Microsoft Consulting Servicestől vagy a Microsoft Premier támogatásától a tapasztalt hibák megoldásához.

Folyamatsablon hibáinak elhárítása

Az elsődleges hibák a folyamatsablonokkal kapcsolatos problémák. Ezek a problémák olyan elavult csapatprojektekből erednek, amelyek nem építik be az Azure DevOps Server legújabb funkcióit vagy az Azure DevOps Services nem támogatott testreszabásait. Az Azure DevOps Services azonban számos testreszabást támogat, és az ellenőrzés csak azokat jelöli meg, amelyek megoldási előtelepítést igényelnek. Az Adatmigrálási eszköz átfogó ellenőrzést végez a sablonokon az Azure DevOps Services kompatibilitása érdekében, de szükség lehet néhány módosításra.

  • A testreszabott folyamatsablonok vagy elavult sablonok folyamatérvényesítési hibákat okozhatnak az áttelepítés során.
  • Ha OOB Agile-, Scrum- vagy CMMI-folyamatot használ, ellenőrizze a TryMatchOobProcesses.log hibákat. A hibamentes projektek OOB-folyamatokra képeznek le.
  • Egyes testreszabások nem működnek az Azure DevOps Servicesben. Tekintse át a támogatott testreszabási listát.
  • A régebbi sablonokat használó projektek esetében futtassa a Funkciók konfigurálása varázslót a legutóbbi funkciókkal rendelkező sablonok frissítéséhez és a hibák számának csökkentéséhez.
  • Győződjön meg arról witadmin , hogy elérhető azon a gépen, amelyen a folyamathibákat kijavítja. A sablonok módosításához elengedhetetlen.

Vegye figyelembe a következő eszközöket a folyamathibák megoldásához:

  • Használja a Visual Studio telepítéseihez mellékelt witadmin.exe parancssori eszközt. A hibák elhárítására vonatkozó részletes műszaki dokumentáció ezen a linken érhető el.
  • Folyamatsablonok exportálásának automatizálása minden csapatprojekthez egy nem dokumentált migrációs eszköz parancsával: A migrálás érvényesíti /gyűjtemény:http://localhost:8080/tfs/DefaultCollection /SaveProcesses.
  • Ismerkedjen meg a TFS Team Project Managerrel a GitHubon (link). Lehetővé teszi a csapatprojektek és az ismert folyamatsablonok összehasonlítását, beleértve a beépített sablonokat is.

A hibák kijavításához módosítsa az XML-szintaxist, és alkalmazza a módosításokat a projektre.

Tipp.

Javasoljuk, hogy a TFS Power Tools használata helyett manuálisan módosítsa az XML-t.

A folyamatsablon projektből való lekéréséhez adja hozzá a /SaveProcesses paramétert az Adatmigrálási eszköz parancs futtatásakor.

Migrator validate /collection:{collection URL} /tenantDomainName:{name} /region:{region} /SaveProcesses

Ez a parancs kinyeri az XML-fájlt a projektből, és ugyanabba a mappába helyezi, mint a naplók. Bontsa ki a zip-fájlokat a helyi gépre, hogy szerkessze a fájlokat.

Most javítsa ki az XML-t. Az egyes projektek hibáinak meghatározásához használja a DataMigrationTool.log fájl naplóit.

Képernyőkép az Adatmigrálási eszköz által létrehozott folyamatnaplózási fájlról.

Bizonyos hibák esetén parancsot witadmin changefield kell használnia. A mezőnév módosítása a leggyakoribb példa. Ha időt szeretne spórolni, javasoljuk, hogy futtassa a witadmin changefield parancsot, majd futtassa újra az adatmigrálási eszközt. Ezzel újraexportálja az XML-t a javított névvel. Ellenkező esetben manuálisan is javítsa ki az XML-szintaxis mezőit.

A javítás után alkalmazza a módosításokat az Azure DevOps Serverre. A végrehajtott módosításoktól függően egy vagy több witadmin parancsot kell futtatnia. Létrehoztunk egy PowerShell-szkriptet a folyamat automatizálásához. A szkript tartalmazza az összes witadmin parancsot, amely a teljes folyamat megerősítéséhez szükséges.

A szkripteket a folyamat testreszabási szkriptjeiben szerezheti be. Használja az import/ConformProject.ps1 szkriptet.

.\conformproject.ps1 "<collection url>" "<project name>" "<process template folder>"

Amikor a szkript befejeződött, futtassa újra az adatmigrálási eszközt a gyűjtemény ellenőrzéséhez. Kövesse az 1–3. lépést, amíg az adatmigrálási eszköz nem hoz létre több érvényesítési hibát.

Képernyőkép a PowerShell megfelelő projektfolyamatáról.

Tipp.

Ha még nem ismerkedik az XML és a witadmin szolgáltatással, javasoljuk, hogy egyszerre egy javítást végezze el, majd feleljen meg. Folytassa ezt a ciklust, amíg az összes hiba meg nem szűnik.

Frissítés rendszerfolyamatra

Ha az Azure DevOps Server egy régebbi verziójával kezdte, a projektek valószínűleg egy régebbi folyamatsablont használnak. Ha ezeket a projekteket nem frissítették a Funkciók konfigurálása varázslóval, az adatmigrálási eszköz folyamathibákat észlel. Ritkán előfordulhat, hogy még a varázsló sem oldja meg a régi folyamattal kapcsolatos problémákat.

A következő hibaüzenetek közül néhányat kaphat:

Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402571: Required element PortfolioBacklog is missing from Process Configuration.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402571: Required element BugWorkItems is missing from Process Configuration.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402571: Required element FeedbackRequestWorkItems is missing from Process Configuration.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402571: Required element FeedbackResponseWorkItems is missing from Process Configuration.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402574: ProcessConfiguration doesn't specify required TypeField Team.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402574: ProcessConfiguration doesn't specify required TypeField RemainingWork.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402574: ProcessConfiguration doesn't specify required TypeField Order.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402574: ProcessConfiguration doesn't specify required TypeField Effort.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402574: ProcessConfiguration doesn't specify required TypeField Activity.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402574: ProcessConfiguration doesn't specify required TypeField ApplicationStartInformation.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402574: ProcessConfiguration doesn't specify required TypeField ApplicationLaunchInstructions.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF402574: ProcessConfiguration doesn't specify required TypeField ApplicationType.
Invalid process template: WorkItem Tracking\Process\ProcessConfiguration.xml:: TF400572: The Project Process Settings must be configured for this feature to be used.

Ha nem szabta testre a projektet (például hozzáadott mezőket, munkaelemtípusokat stb.), a hibák kijavítása egyszerű. Ha azonban testre szabta a folyamatot, ez a megközelítés nem elegendő. Manuálisan kell módosítania a folyamatsablonokat, hogy a testreszabások ne legyenek felülírva.

Hajtsa végre az alábbi lépéseket minden projekt esetében a folyamat igazításához:

  1. Azonosítsa a projekt kezdeti folyamatát (Scrum, Agile vagy CMMI).
  2. Látogasson el a GitHub folyamat testreszabási szkriptjeire, és töltse le az adattárat.
  3. Összpontosítson a Migrálás mappában lévő tartalomra.
  4. Az alábbi ConformProject.ps1 szkripttel igazíthat egy tetszőleges projektet az Agilis rendszerfolyamathoz. Ez a művelet a teljes projektet Agile értékre frissíti.
.\ConformProject.ps1 "<collection url>" "<project name>" "c:\process-customization-scripts\import\agile"

Gyakori érvényesítési hibák

VS402841: Az X mező a munkaelem típusában A hiba szinkronizálásnévchanges=hamis, de a szabályok identitásmezővé teszik. Az identitásmezőknek syncnamechanges=true értékűnek kell lenniük. Frissítse a folyamatsablont, hogy belefoglalja ezt a módosítást.

Az Azure DevOps Servicesben hozzáadtunk egy szabályt, hogy minden identitásmezőnek rendelkeznie kell az syncnamechanges=true attribútummal. Az Azure DevOps Serveren ez a szabály nem érvényes. Ezért az adatmigrálási eszköz ezt problémaként azonosítja. A helyszíni Azure DevOps Serveren történő módosítás nem okoz semmilyen kárt.

Futtassa a witadmin changefield parancsot. A parancs szintaxisa az alábbi példához hasonlóan néz ki.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:fieldname /syncnamechanges:true

A witadmin changefield parancsról további információt a Munkaelem-mezők kezelése című témakörben talál.

TF402556: Ahhoz, hogy a System.IterationId mező jól definiálható legyen, el kell neveznie az iterációs azonosítót, és egész számra kell állítania a típusát.

Ez a hiba gyakran elavult folyamatsablonokhoz van társítva. Ennek kezeléséhez futtathatja a Szolgáltatások konfigurálása varázslót minden projekthez. Másik lehetőségként a következő parancsot is végrehajthatja a folyamat automatizálásához.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:fieldname /name:newname

TF402571: A szükséges elem, a BugWorkItems hiányzik a folyamatkonfigurációból.

Ez a hiba általában akkor jelenik meg, ha egy folyamat egy ideig nem frissült. A probléma megoldásához futtassa a Szolgáltatások konfigurálása varázslót minden projekthez.

TF402564: XX globális listákat definiált. Csak 64 engedélyezett

Az Azure DevOps Services natív módon 64 globális listát támogat. Ez a hiba általában akkor fordul elő, ha számos buildfolyamat van, mivel minden új folyamat létrehoz egy globális listát.Builds - TeamProjectName A hiba megoldásához távolítsa el az elavult globális listákat.

Ellenőrzési ellenőrzések ismétlése

Minden iterációban hárítsa el a hibákat, és végezzen érvényesítési ellenőrzéseket a megoldásuk érdekében, ahogyan azt az érvényesítési naplófájlok is jelzik. Ezt a ciklust addig őrizze meg, amíg az összes hiba kijavítva nem lesz, és megerősítést kap arról, hogy a gyűjteményérvényesítési ellenőrzések sikeresek.

Következő lépések

Felkészülés a tesztfuttatásra