Dela via


Snabbstart: Utvärdera och migrera ett .NET-projekt med GitHub Copilot-appmodernisering för .NET

I den här snabbstarten utvärderar och migrerar du ett .NET-projekt med hjälp av GitHub Copilot-appmodernisering för .NET. Du utför följande uppgifter:

  • Utvärdera ett exempelprojekt (Contoso University)
  • Starta migreringsprocessen

Prerequisites

Utvärdera appberedskap

Med GitHub Copilot-appmodernisering för .NET-utvärdering kan du hitta utmaningar för appberedskap, lära dig hur de påverkas och se rekommenderade migreringsuppgifter. Varje migreringsuppgift innehåller referenser för att konfigurera Azure-resurser, lägga till konfigurationer och göra kodändringar. Följ dessa steg för att starta migreringen:

  1. Klona .NET-migrerings-exempelarkivet för Copilot till datorn.

  2. Öppna Contoso University-lösningen från exempellagringsplatsen i Visual Studio.

  3. Högerklicka på lösningsnoden i Solution Explorer och välj Modernisera.

    Skärmbild som visar alternativet modernisera i snabbmenyn.

  4. GitHub Copilot Chat-fönstret öppnas med ett välkomstmeddelande och fördefinierade alternativ. Välj Migrera till Azure från de tillgängliga alternativen och skicka det till Copilot.

    Skärmbild som visar välkomstmeddelandet med migreringsalternativ.

    Tip

    I stället för steg 3 och 4 kan du öppna GitHub Copilot Chat direkt och skicka @Modernize Migrate to Azure för att starta utvärderings- och migreringsflödet.

  5. En ny Copilot-chattsession öppnas och visar välkomstmeddelandet. Utvärderingen startar automatiskt och analyserar projektet för migreringsberedskap.

    Skärmbild som visar pågående utvärdering med statusindikatorer.

  6. När utvärderingen är klar visas en omfattande utvärderingsrapports användargränssnittssida och en lista över migreringsuppgifter i chattfönstret.

    Skärmbild som visar den genererade utvärderingsrapporten med detaljerade resultat.

Appmigreringar

GitHub Copilot-appmodernisering för .NET innehåller fördefinierade uppgifter för vanliga migreringsscenarier och följer Microsofts metodtips.

Starta en migreringsuppgift

Starta en migreringsaktivitet på något av följande sätt:

Alternativ 1. Starta från utvärderingsrapporten

Välj knappen Kör uppgift i utvärderingsrapporten från föregående steg för att starta en migreringsaktivitet.

Alternativ 2. Skicka Copilot Chat

Skicka migreringsaktivitetsnumret (till exempel 1.1) eller dess namn i chatten.

Skärmbild av att skicka ett meddelande i Copilot Chat för att starta en migreringsaktivitet.

Generering av planerings- och förloppsspårning

  • När du startar migreringen startar GitHub Copilot en session med namnet "Appmodernisering: migrera från <source technology> till <target technology>" i agentläge med fördefinierade frågor.
  • Verktyget skapar två filer i .appmod/.migration mappen:
    • plan.md: Den övergripande migreringsplanen.
    • progress.md: En förloppsspårare som GitHub Copilot uppdaterar när den slutför uppgifter.
  • Redigera dessa filer för att anpassa migreringen innan du fortsätter.

Starta kodåtgärdande

  • Om du är nöjd med planen och förloppsspåraren anger du en uppmaning om att starta migreringsprocessen, till exempel:

    The plan and progress tracker look good to me. Go ahead with the migration.
    
  • GitHub Copilot startar migreringsprocessen och kan be om ditt godkännande att använda kunskapsbasverktyg på MCP-servern (Model Context Protocol). Bevilja behörighet när du uppmanas att göra det.

  • Copilot följer planen och förloppsspåraren för att:

    • Hantera beroenden.
    • Tillämpa konfigurationsändringar.
    • Gör kodändringar.
    • Skapa lösningen, åtgärda alla kompilerings- och konfigurationsfel och se till att bygget lyckas.
    • Åtgärda säkerhetsrisker.

Standardchattmeddelanden

GitHub Copilot-appmodernisering för .NET tillhandahåller standardalternativ för chattmeddelanden för att effektivisera arbetsflödet.

Skärmbild som visar standardalternativ för chattmeddelanden i Copilot Chat.

Välj ett av de fördefinierade alternativen och skicka det i chatten:

  • Kör moderniseringsutvärdering: Startar en ny utvärdering av ditt program för att identifiera problem med migreringsberedskap och Azure-kompatibilitetsutmaningar.
  • Visa utvärderingsrapport: Öppnar den tidigare utvärderingsrapporten och visar en sammanfattning av migreringsuppgifter baserat på resultaten. Om det inte finns någon tidigare utvärdering körs en ny utvärdering först.
  • Bläddra bland de viktigaste migreringsuppgifterna: Visar rekommenderade migreringsuppgifter och vanliga moderniseringsscenarier, oavsett eventuella specifika utvärderingsresultat.

Tip

Dessa standardmeddelanden hjälper dig att snabbt navigera i vanliga arbetsflöden utan att skriva anpassade prompter. Du kan också ange egna meddelanden för att interagera med Copilot för specifika frågor eller behov.

Nästa steg

Prerequisites

Utvärdera appberedskap

Med GitHub Copilot-appmodernisering för .NET-utvärdering kan du hitta utmaningar för appberedskap, lära dig hur de påverkas och se rekommenderade migreringsuppgifter. Varje migreringsuppgift innehåller referenser för att konfigurera Azure-resurser, lägga till konfigurationer och göra kodändringar. Följ dessa steg för att starta migreringen:

  1. Klona .NET-migrerings-exempelarkivet för Copilot till datorn.

  2. I Visual Studio Code öppnar du Contoso University-lösningen från exempellagringsplatsen.

  3. Öppna tillägget för modernisering av GitHub Copilot-appen .

  4. I avsnittet SNABBSTART väljer du Starta utvärdering. Sidan Utvärderingsrapporter öppnas.

  5. Välj Kör utvärdering i det övre högra hörnet på sidan.

    Skärmbild av att köra en aktivitet i aktivitetsavsnittet för att starta en migreringsaktivitet.

  6. Utvärderingen startar automatiskt och analyserar projektet för migreringsberedskap.

    Skärmbild av att köra en uppgift som analyserar projektet för migreringsberedskap.

  7. När utvärderingen är klar visas en omfattande utvärderingsrapports användargränssnittssida och en lista över migreringsuppgifter i chattfönstret.

    Skärmbild av att utföra en utvärderingsrapportens användargränssnittssida och en lista över migreringsuppdrag.

Appmigreringar

GitHub Copilot-appmodernisering för .NET innehåller fördefinierade uppgifter för vanliga migreringsscenarier och följer Microsofts metodtips.

Chattbaserad migrering är det rekommenderade sättet att starta en migrering. Den AppModernization-DotNet anpassade agenten är optimerad för programmoderniseringsuppgifter. Med den här agenten kan du använda enkla, naturliga språkfrågor för att utföra komplexa migreringsscenarier.

Slutför följande steg för att välja den anpassade agenten och starta migreringen:

  1. Kontrollera att du har ett .NET-projekt öppet i Visual Studio Code.

  2. Välj chattikonen i aktivitetsfältet för att öppna chattfönstret Copilot.

  3. I chattfönstret letar du upp listrutan agentväljare överst i rutan för chattinmatning. Välj AppModernization-DotNet i listan. Den här anpassade agenten är utformad för .NET-programmodernisering och migreringsscenarier.

    Skärmbild av att välja den anpassade .NET-agenten i chattfönstret.

  4. Ange en uppmaning med formatet migrate from <source> to <target> i chattfönstret. Till exempel:

    migrate from rabbitmq to Azure service bus
    
  5. Agenten analyserar din kod, skapar en migreringsplan, gör kodändringar, kör valideringar och genererar en sammanfattning. Välj Fortsätt för att gå igenom varje steg och Behåll för att acceptera ändringarna.

Starta en migreringsaktivitet från användargränssnittet

Du kan också starta en migreringsaktivitet från användargränssnittet:

Alternativ 1. Starta från utvärderingsrapporten

Välj knappen Kör uppgift i utvärderingsrapporten från föregående steg för att starta en migreringsaktivitet.

Alternativ 2. Tillämpa en fördefinierad uppgift

Kör den specifika aktiviteten i avsnittet TASKS – .NET . Till exempel uppdaterar uppgiften Migrera databas till Azure Database for PostgreSQL under Databasuppgifter din databasanslutning, konfigurationer, beroenden och dataåtkomstkod för att använda Azure Database for PostgreSQL.

Skärmbild av att köra en specifik fördefinierad uppgift.

Generering av planerings- och förloppsspårning

När du startar migreringen startar GitHub Copilot en session i agentläge.

Verktyget skapar två filer i .github/appmod/code-migration/<target-branch-name> mappen:

  • plan.md: Den övergripande migreringsplanen.
  • progress.md: En förloppsspårare som GitHub Copilot uppdaterar när den slutför uppgifter.

Redigera dessa filer för att anpassa migreringen innan du fortsätter.

Skärmbild av plangenerering under en migreringsaktivitet.

Starta kodåtgärdande

När du är nöjd med planen och förloppsspåraren, skriv continue för att starta migreringen.

GitHub Copilot startar migreringsprocessen och kan be om ditt godkännande att använda kunskapsbasverktyg på MCP-servern (Model Context Protocol). Bevilja behörighet när du uppmanas att göra det.

Copilot följer planen och förloppsspåraren för att:

  • Hantera beroenden.
  • Tillämpa konfigurationsändringar.
  • Gör kodändringar.
  • Skapa projektet, åtgärda alla kompilerings- och konfigurationsfel och se till att bygget lyckas.
  • Åtgärda säkerhetsrisker.

Markera eller ange Fortsätt upprepade gånger för att bekräfta användningen av verktyg eller kommandon och vänta tills kodändringarna har slutförts.

Anmärkning

I Visual Studio Code använder appmodernisering den anpassade agenten AppModernization-DotNet med Claude Sonnet 4.5 som standard för bästa resultat när du uppdaterar .NET-kod för migrering till Azure. Den återgår till modellen "auto" om Sonnet 4.5 inte är tillgängligt för dig. Du kan konfigurera den anpassade agenten så att den ändrar inställningen "modell" genom att välja Konfigurera anpassade agenteragentmenyn . Du kan också använda språkmodellväljaren i chattfönstret för att växla modeller för den aktuella chattsessionen.

Validerings-iteration

När kodändringarna är klara startar migreringsverktyget en verifierings- och korrigeringsloop. Den här loopen innehåller följande fem steg:

  1. Identifiera vanliga sårbarheter och exponeringar (CVE) i aktuella beroenden och åtgärda dem.
  2. Skapa projektet och lös eventuella byggfel.
  3. Analysera koden för funktionell konsekvens.
  4. Analysera projektet efter enhetstestfel och generera automatiskt en plan för att åtgärda dem tills testerna har godkänts.
  5. Analysera koden för migreringsobjekt som missades i den första kodmigreringen och åtgärda dem.

När alla processer har slutförts genererar migreringsverktyget en sammanfattning. Granska kodändringarna och bekräfta dem genom att välja Behåll.

Nästa steg