Rövid útmutató: .NET-projekt értékelése és migrálása a GitHub Copilot által végzett modernizálás segítségével .NET-hez

Ebben a rövid útmutatóban felmérhet és migrálhat egy .NET-projektet a GitHub Copilot .NET-alapú modernizációjával. A következő feladatokat hajtja végre:

  • Mintaprojekt értékelése (Contoso Egyetem)
  • Az áttelepítési folyamat elindítása

Prerequisites

Megjegyzés:

Ezek az előfeltételek a Visual Studio vonatkoznak. Más fejlesztési környezetek esetén lásd: A GitHub Copilot modernizációjának telepítése.

Alkalmazáskészség felmérése

A GitHub Copilot .NET-felméréshez készült modernizálása segít megtalálni az alkalmazások felkészültségi kihívásait, megismerni azok hatását, és megtekinteni az ajánlott migrálási feladatokat. Minden áttelepítési feladat hivatkozásokat tartalmaz Azure erőforrások beállítására, konfigurációk hozzáadására és kódmódosításokra. A migrálás elindításához kövesse az alábbi lépéseket:

  1. Klónozza a számítógépére a .NET migrálási copilot minták tárhelyet.

  2. A Visual Studio nyissa meg a Contoso Egyetem megoldást a mintatárból.

  3. A Solution Explorer kattintson a jobb gombbal a megoldáscsomópontra, és válassza a Modernize lehetőséget.

    A helyi menü 'Modernizálás' lehetőséget bemutató képernyőkép.

  4. Megnyílik a GitHub Copilot csevegőablak egy üdvözlő üzenettel és előre definiált beállításokkal. Válassza a Migrate to Azure lehetőséget az elérhető lehetőségek közül, és küldje el a Copilotnak.

    Képernyőkép az üdvözlő üzenetről a migrálási lehetőségekkel.

    Tip

    A 3. és a 4. lépés helyett közvetlenül megnyithatja GitHub Copilot csevegést, és elküldheti @Modernize Migrate to Azure az értékelés és a migrálási folyamat elindításához.

  5. Megnyílik egy új Copilot csevegési munkamenet, és megjelenik az üdvözlő üzenet. Az értékelés automatikusan elindul, és elemzi a projektet a migrálási készültség szempontjából.

    A folyamatban lévő értékelést állapotjelzőkkel ábrázoló képernyőkép.

  6. Amikor az értékelés befejeződik, megjelenik egy átfogó értékelési jelentés felhasználói felülete, valamint a migrálási feladatok listája a csevegőablakban.

    Képernyőkép a létrehozott értékelő jelentésről részletes megállapításokkal.

Alkalmazásmigrálások

A .NET-hez készült GitHub Copilot-modernizáció előre meghatározott feladatokat tartalmaz a gyakori migrálási forgatókönyvekhez, és követi a Microsoft ajánlott eljárásait.

Migrálási feladat indítása

Migrálási feladat indítása az alábbi módok egyikével:

1. lehetőség: Futtatás az értékelési jelentésből

A migrálási feladat elindításához válassza az Értékelési jelentés Feladat futtatása gombját az előző lépésben.

2. lehetőség: Küldés Copilot csevegésben

Küldje el a migrálási feladat számát (például 1.1) vagy nevét a csevegésben.

Képernyőkép egy üzenet elküldéséről a Copilot Chat-ben, egy migrálási feladat elindításához.

Terv- és folyamatkövetési generáció

  • A migrálás indításakor a GitHub Copilot elindít egy "Modernizáció: migrálás <source technology>-ről <target technology>-re" nevű munkamenetet egy ügynök módban, előre megadott utasításokkal.
  • Az eszköz két fájlt hoz létre a .appmod/.migration mappában:
    • plan.md: A teljes migrálási terv.
    • progress.md: Egy folyamatkövető, amit a GitHub Copilot frissít, ahogy a feladatokat befejezi.
  • A folytatás előtt szerkessze ezeket a fájlokat az áttelepítés testreszabásához.

Kód szervizelésének indítása

  • Ha elégedett a tervvel és a folyamatkövetéssel, írjon be egy kérést az áttelepítési folyamat elindításához, például:

    The plan and progress tracker look good to me. Go ahead with the migration.

  • GitHub Copilot elindítja a migrálási folyamatot, és kérheti a jóváhagyást a Tudásbázis eszközeinek a Model Context Protocol (MCP) kiszolgálón való használatához. Adjon engedélyt, amikor a rendszer kéri.

  • A Copilot követi a tervet és a haladásfigyelőt.

    • Függőségek kezelése.
    • Konfigurációs módosítások alkalmazása.
    • Kódmódosítások végrehajtása.
    • Hozza létre a megoldást, javítsa ki az összes fordítási és konfigurációs hibát, és biztosítsa a sikeres buildelést.
    • Biztonsági rések javítása.

Alapértelmezett csevegőüzenetek

A .NET-hez készült GitHub Copilot modernizálása alapértelmezett csevegőüzenet-beállításokat biztosít a munkafolyamat egyszerűsítése érdekében.

Egy képernyőkép, amely a Copilot Chat alapértelmezett csevegőüzenet lehetőségeit mutatja.

Válasszon egyet az előre definiált lehetőségek közül, és küldje el a csevegésben:

  • Korszerűsítési felmérés futtatása: Elindítja az alkalmazás új értékelését a migrálási készültségi problémák és Azure kompatibilitási problémák azonosítása érdekében.
  • Értékelési jelentés megtekintése: Megnyitja az előző értékelési jelentést, és az eredmények alapján megjeleníti a migrálási feladatok összegzését. Ha nincs korábbi értékelés, először egy új értékelést futtat.
  • Tallózás a leggyakoribb migrálási feladatok között: Az ajánlott migrálási feladatokat és a gyakori modernizációs forgatókönyveket jeleníti meg, függetlenül az adott értékelési eredményektől.

Tip

Ezek az alapértelmezett üzenetek segítenek a gyakori munkafolyamatok gyors navigálásában egyéni kérések beírása nélkül. Saját üzeneteket is megadhat, hogy konkrét kérdések vagy igények esetén Copilot kommunikáljon.

Következő lépések

Prerequisites

Alkalmazáskészség felmérése

A GitHub Copilot .NET-felméréshez készült modernizálása segít megtalálni az alkalmazások felkészültségi kihívásait, megismerni azok hatását, és megtekinteni az ajánlott migrálási feladatokat. Minden áttelepítési feladat hivatkozásokat tartalmaz Azure erőforrások beállítására, konfigurációk hozzáadására és kódmódosításokra. A migrálás elindításához kövesse az alábbi lépéseket:

  1. Klónozza a számítógépére a .NET migrálási copilot minták tárhelyet.

  2. A Visual Studio Code-ban nyissa meg a Contoso Egyetem megoldást a példatárból.

  3. Nyissa meg a GitHub Copilot modernizációs bővítményét .

  4. A QUICKSTART szakaszban válassza az Értékelés indítása lehetőséget. Megnyílik az Értékelés jelentések lap.

  5. Válassza az Értékelés futtatása lehetőséget a lap jobb felső sarkában.

    Képernyőkép egy feladat futtatásáról a Feladatok szakaszban egy migrálási feladat elindításához.

  6. Az értékelés automatikusan elindul, és elemzi a projektet a migrálási készültség szempontjából.

    Képernyőkép a projekt migrálási készültségét elemző feladat futtatásáról.

  7. Amikor az értékelés befejeződik, megjelenik egy átfogó értékelési jelentés felhasználói felülete, valamint a migrálási feladatok listája a csevegőablakban.

    Képernyőkép az értékelési jelentés felhasználói felületének futtatásáról és a migrálási feladatok listájáról.

Alkalmazásmigrálások

A .NET-hez készült GitHub Copilot-modernizáció előre meghatározott feladatokat tartalmaz a gyakori migrálási forgatókönyvekhez, és követi a Microsoft ajánlott eljárásait.

A csevegésalapú migrálás a migrálás indításának ajánlott módja. Az AppModernization-DotNet egyéni ügynök alkalmazáskorszerűsítési feladatokhoz van optimalizálva. Ez az ügynök lehetővé teszi egyszerű, természetes nyelvi kérések használatát összetett migrálási forgatókönyvek végrehajtásához.

Az egyéni ügynök kiválasztásához és az áttelepítés elindításához hajtsa végre az alábbi lépéseket:

  1. Győződjön meg arról, hogy egy .NET projekt van megnyitva a Visual Studio Code-ban.

  2. Válassza a csevegés ikont a Activity bar a Copilot csevegőablak megnyitásához.

  3. A csevegőablakban keresse meg az ügynökválasztó legördülő menüt a csevegés beviteli mezőjének tetején. Válassza az AppModernization-DotNet elemet a listából. Ez az egyéni ügynök .NET alkalmazáskorszerűsítési és migrálási forgatókönyvekhez készült.

    A .NET egyéni ügynök kiválasztásának képe a csevegőablakban.

  4. Adjon meg egy üzenetet a csevegőablak formátumával migrate from <source> to <target> . Például:

    migrate from rabbitmq to Azure service bus

  5. Az ügynök elemzi a kódot, létrehoz egy migrálási tervet, módosítja a kódokat, futtatja az érvényesítéseket, és létrehoz egy összegzést. A Folytatás gombra kattintva haladhat végig az egyes lépéseken, és a Keep gombra kattintva elfogadhatja a módosításokat.

Migrálási feladat indítása a felhasználói felületről

Migrálási feladatot a felhasználói felületről is elindíthat:

1. lehetőség: Futtatás az értékelési jelentésből

A migrálási feladat elindításához válassza az Értékelési jelentés Feladat futtatása gombját az előző lépésben.

2. lehetőség: Előre definiált tevékenység alkalmazása

Futtassa az adott feladatot a TASKS – .NET szakaszban. Például az Migrate Database to Azure Database for PostgreSQL feladat a Database Tasks alatt frissíti az adatbázis-kapcsolatot, a konfigurációkat, a függőségeket és az adatelérési kódot, hogy az Azure Database for PostgreSQL-t használja.

Képernyőkép egy adott előre definiált feladat futtatásáról.

Terv- és folyamatkövetési generáció

Az áttelepítés indításakor GitHub Copilot elindít egy munkamenetet ügynök módban.

Az eszköz két fájlt hoz létre a .github/appmod/code-migration/<target-branch-name> mappában:

  • plan.md: A teljes migrálási terv.
  • progress.md: Egy folyamatkövető, amit a GitHub Copilot frissít, ahogy a feladatokat befejezi.

A folytatás előtt szerkessze ezeket a fájlokat az áttelepítés testreszabásához.

Képernyőkép a terv létrehozásról egy migrálási feladat során.

Kód szervizelésének indítása

Ha elégedett a tervvel és a folyamatkövetéssel, írja be a continue parancsot a migrálás elindításához.

GitHub Copilot elindítja a migrálási folyamatot, és kérheti a jóváhagyást a Tudásbázis eszközeinek a Model Context Protocol (MCP) kiszolgálón való használatához. Adjon engedélyt, amikor a rendszer kéri.

A Copilot követi a tervet és a haladásfigyelőt.

  • Függőségek kezelése.
  • Konfigurációs módosítások alkalmazása.
  • Kódmódosítások végrehajtása.
  • Hozza létre a projektet, javítsa ki az összes fordítási és konfigurációs hibát, és biztosítsa a sikeres buildelést.
  • Biztonsági rések javítása.

Az eszközök vagy parancsok használatának megerősítéséhez és a kódmódosítások befejezéséhez ismételten válassza vagy írja be a Folytatás lehetőséget.

Megjegyzés:

A Visual Studio Code-ban a modernizálás alapértelmezés szerint a AppModernization-DotNet Claude Sonnet 4.5-tel rendelkező egyéni ügynököt használja a legjobb eredmény érdekében a .NET-kód Azure-ba való migrálása során. Visszaesik az "auto" modellre, ha a Sonnet 4.5 nem érhető el. Az egyéni ügynököt úgy konfigurálhatja, hogy módosítsa a "modell" beállítást az Ügynök menü Egyéni ügynökök konfigurálása parancsával. Másik lehetőségként használhatja a csevegőablakban található nyelvi modellválasztót az aktuális csevegési munkamenet modelljeinek váltásához.

Érvényesítési iteráció

A kódmódosítások befejeződése után az áttelepítési eszköz elindít egy érvényesítési és kijavítási ciklust. Ez a hurok a következő öt lépést tartalmazza:

  1. Az aktuális függőségek gyakori biztonsági réseinek és expozícióinak észlelése és javítása.
  2. Készítse el a projektet, és oldja meg a buildelési hibákat.
  3. Elemezze a funkcionális konzisztencia kódját.
  4. Elemezze a projektet az egységtesztelési hibák esetén, és automatikusan hozzon létre egy tervet a javításukhoz, amíg a tesztek befejeződnek.
  5. Elemezze a kezdeti kódmigrálás során kihagyott áttelepítési elemek kódját, és javítsa ki őket.

Az összes folyamat befejezése után az áttelepítési eszköz létrehoz egy összegzést. Tekintse át a kód módosításait, és erősítse meg őket a Keep (Megtartás) gombra kattintva.

Következő lépések

  • Last updated on