Delen via

Quickstart: Een .NET-project evalueren en migreren met GitHub Copilot-modernisering voor .NET

In deze quickstart evalueert en migreert u een .NET-project met behulp van GitHub Copilot-modernisering voor .NET. U voert de volgende taken uit:

  • Een voorbeeldproject evalueren (Contoso University)
  • Het migratieproces starten

Prerequisites

Opmerking

Deze vereisten zijn van toepassing op Visual Studio. Zie GitHub Copilot-modernisering installeren voor andere ontwikkelomgevingen.

Gereedheid van apps beoordelen

GitHub Copilot-modernisering voor .NET-evaluatie helpt u bij het vinden van uitdagingen voor app-gereedheid, het leren van hun impact en het bekijken van aanbevolen migratietaken. Elke migratietaak bevat verwijzingen om Azure resources in te stellen, configuraties toe te voegen en codewijzigingen aan te brengen. Volg deze stappen om uw migratie te starten:

  1. Kloon de .NET migratie copilot-voorbeelden naar uw computer.

  2. Open in Visual Studio de oplossing Contoso University uit de opslagplaats met voorbeelden.

  3. Klik in Solution Explorer met de rechtermuisknop op het oplossingsknooppunt en selecteer Modernize.

    Schermopname van de optie moderniseren in het contextmenu.

  4. Het venster GitHub Copilot Chat wordt geopend met een welkomstbericht en vooraf gedefinieerde opties. Selecteer Migrate naar Azure uit de beschikbare opties en verzend deze naar Copilot.

    Schermopname van het welkomstbericht met migratieopties.

    Tip

    In plaats van stap 3 en 4 kunt u GitHub Copilot Chat rechtstreeks openen en @Modernize Migrate to Azure verzenden om de evaluatie- en migratiestroom te starten.

  5. Er wordt een nieuwe Copilot chatsessie geopend en het welkomstbericht weergegeven. De evaluatie wordt automatisch gestart en analyseert uw project voor migratiegereedheid.

    Schermopname van de evaluatie die wordt uitgevoerd met statusindicatoren.

  6. Wanneer de evaluatie is voltooid, ziet u een uitgebreide pagina met de gebruikersinterface van het evaluatierapport en een lijst met migratietaken in het chatvenster.

    Schermopname van het gegenereerde evaluatierapport met gedetailleerde bevindingen.

App-migraties

GitHub Copilot-modernisering voor .NET bevat vooraf gedefinieerde taken voor algemene migratiescenario's en volgt de aanbevolen procedures van Microsoft.

Een migratietaak starten

Start een migratietaak op een van de volgende manieren:

Optie 1. Uitvoeren op basis van het evaluatierapport

Selecteer de knop Taak uitvoeren in het evaluatierapport uit de vorige stap om een migratietaak te starten.

Optie 2. Verzenden in Copilot Chat

Verzend het migratietaaknummer (bijvoorbeeld 1.1) of de naam ervan in de chat.

Scherm van het verzenden van een bericht in Copilot Chat om een migratietaak te starten.

Genereren van plan- en voortgangstrackers

  • Wanneer u de migratie start, start GitHub Copilot een sessie met de naam Modernisering: migreren van <source technology> naar <target technology>" in de agentmodus met vooraf gedefinieerde prompts.
  • Het hulpprogramma maakt twee bestanden in de .appmod/.migration map:
    • plan.md: Het algemene migratieplan.
    • progress.md: Een voortgangstracker die door GitHub Copilot wordt bijgewerkt naarmate het taken voltooit.
  • Bewerk deze bestanden om uw migratie aan te passen voordat u doorgaat.

Herstel van code starten

  • Als u tevreden bent met het plan en de voortgangstracker, voert u een prompt in om het migratieproces te starten, zoals:

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

  • GitHub Copilot het migratieproces start en kan u vragen om goedkeuring voor het gebruik van Knowledge Base-hulpprogramma's op de MCP-server (Model Context Protocol). Geef toestemming wanneer u hierom wordt gevraagd.

  • Copilot volgt het plan en houdt de voortgangstracker bij om:

    • Afhankelijkheden beheren.
    • Pas configuratiewijzigingen toe.
    • Breng codewijzigingen aan.
    • Bouw de oplossing, los alle compilatie- en configuratiefouten op en zorg voor een geslaagde build.
    • Beveiligingsproblemen oplossen.

Standaardchatberichten

GitHub Copilot-modernisering voor .NET biedt standaardopties voor chatberichten om uw werkstroom te stroomlijnen.

Schermafbeelding met standaardopties voor chatberichten in de Copilot Chat.

Kies een van de vooraf gedefinieerde opties en verzend deze in de chat:

  • De moderniseringsevaluatie uitvoeren: hiermee start u een nieuwe evaluatie van uw applicatie om problemen met de migratiegereedheid op te sporen en compatibiliteitsproblemen met Azure.
  • Evaluatierapport weergeven: hiermee opent u het vorige evaluatierapport en ziet u een overzicht van migratietaken op basis van de resultaten. Als er geen eerdere evaluatie bestaat, wordt eerst een nieuwe evaluatie uitgevoerd.
  • Blader door de belangrijkste migratietaken: toont aanbevolen migratietaken en algemene moderniseringsscenario's, ongeacht eventuele specifieke evaluatieresultaten.

Tip

Deze standaardberichten helpen u snel door algemene werkstromen te navigeren zonder aangepaste prompts te typen. U kunt ook uw eigen berichten invoeren om te communiceren met Copilot voor specifieke vragen of behoeften.

Volgende stappen

Prerequisites

Gereedheid van apps beoordelen

GitHub Copilot-modernisering voor .NET-evaluatie helpt u bij het vinden van uitdagingen voor app-gereedheid, het leren van hun impact en het bekijken van aanbevolen migratietaken. Elke migratietaak bevat verwijzingen om Azure resources in te stellen, configuraties toe te voegen en codewijzigingen aan te brengen. Volg deze stappen om uw migratie te starten:

  1. Kloon de .NET migratie copilot-voorbeelden naar uw computer.

  2. Open in Visual Studio Code de oplossing Contoso University uit de opslagplaats met voorbeelden.

  3. Open de uitbreiding voor modernisering van GitHub Copilot .

  4. Selecteer Evaluatie starten in de sectie QUICKSTART. De pagina Evaluatierapporten wordt geopend.

  5. Selecteer Evaluatie uitvoeren in de rechterbovenhoek van de pagina.

    Schermopname van het uitvoeren van een taak in de sectie Taken om een migratietaak te starten.

  6. De evaluatie wordt automatisch gestart en analyseert uw project voor migratiegereedheid.

    Schermopname van het uitvoeren van een taak die uw project analyseert op gereedheid voor migratie.

  7. Wanneer de evaluatie is voltooid, ziet u een uitgebreide pagina met de gebruikersinterface van het evaluatierapport en een lijst met migratietaken in het chatvenster.

    Schermopname van het uitvoeren van een gebruikersinterfacepagina van een evaluatierapport en een lijst met migratietaken.

App-migraties

GitHub Copilot-modernisering voor .NET bevat vooraf gedefinieerde taken voor algemene migratiescenario's en volgt de aanbevolen procedures van Microsoft.

Migratie op basis van chat is de aanbevolen manier om een migratie te starten. De AppModernization-DotNet aangepaste agent is geoptimaliseerd voor het moderniseren van toepassingen. Met deze agent kunt u eenvoudige, natuurlijke taalprompts gebruiken om complexe migratiescenario's uit te voeren.

Voer de volgende stappen uit om de aangepaste agent te selecteren en de migratie te starten:

  1. Zorg ervoor dat u een .NET project hebt geopend in Visual Studio Code.

  2. Selecteer het chatpictogram in de Activiteitsbalk om het Copilot chatvenster te openen.

  3. Zoek in het chatvenster de vervolgkeuzelijst agent kiezer bovenaan het chatinvoerveld. Selecteer AppModernization-DotNet in de lijst. Deze aangepaste agent is ontworpen voor .NET scenario's voor het moderniseren en migreren van toepassingen.

    Scherm van het selecteren van de aangepaste .NET agent in het chatvenster.

  4. Voer een prompt in met behulp van de indeling migrate from <source> to <target> in het chatvenster. Voorbeeld:

    migrate from rabbitmq to Azure service bus

  5. De agent analyseert uw code, maakt een migratieplan, brengt codewijzigingen aan, voert validaties uit en genereert een samenvatting. Selecteer Doorgaan om door te gaan met elke stap en Blijf de wijzigingen accepteren.

Een migratietaak starten vanuit de gebruikersinterface

U kunt ook een migratietaak starten vanuit de gebruikersinterface:

Optie 1. Uitvoeren op basis van het evaluatierapport

Selecteer de knop Taak uitvoeren in het evaluatierapport uit de vorige stap om een migratietaak te starten.

Optie 2. Een vooraf gedefinieerde taak toepassen

Voer de specifieke taak uit in de sectie TASKS - .NET. De Migrate Database bijvoorbeeld naar Azure Database for PostgreSQL taak onder Databasetaken werkt uw databaseverbinding, configuraties, afhankelijkheden en gegevenstoegangscode bij om Azure Database for PostgreSQL te gebruiken.

Schermopname van het uitvoeren van een specifieke vooraf gedefinieerde taak.

Genereren van plan- en voortgangstrackers

Wanneer u de migratie start, start GitHub Copilot een sessie in de agentmodus.

Het hulpprogramma maakt twee bestanden in de .github/appmod/code-migration/<target-branch-name> map:

  • plan.md: Het algemene migratieplan.
  • progress.md: Een voortgangstracker die door GitHub Copilot wordt bijgewerkt naarmate het taken voltooit.

Bewerk deze bestanden om uw migratie aan te passen voordat u doorgaat.

Schermopname van het genereren van plannen tijdens een migratietaak.

Herstel van code starten

Wanneer u tevreden bent met het plan en de voortgangstracker, gaat u verder met het starten van de migratie.

GitHub Copilot het migratieproces start en kan u vragen om goedkeuring voor het gebruik van Knowledge Base-hulpprogramma's op de MCP-server (Model Context Protocol). Geef toestemming wanneer u hierom wordt gevraagd.

Copilot volgt het plan en houdt de voortgangstracker bij om:

  • Afhankelijkheden beheren.
  • Pas configuratiewijzigingen toe.
  • Breng codewijzigingen aan.
  • Bouw het project, los alle compilatie- en configuratiefouten op en zorg voor een geslaagde build.
  • Beveiligingsproblemen oplossen.

Selecteer of voer herhaaldelijk Doorgaan in om het gebruik van hulpprogramma's of opdrachten te bevestigen en te wachten tot de codewijzigingen zijn voltooid.

Opmerking

In Visual Studio Code gebruikt modernisering standaard de AppModernization-DotNet aangepaste agent met Claude Sonnet 4.5 voor de beste resultaten bij het bijwerken van .NET-code om naar Azure te migreren. Het valt terug op het 'auto'-model als Sonnet 4.5 niet beschikbaar is voor u. U kunt de aangepaste agent configureren om de instelling Model te wijzigen door Aangepaste agents configureren te selecteren in het menu Agent . U kunt ook de taalmodelkiezer in het chatvenster gebruiken om van model te wisselen voor de huidige chatsessie.

Validatie-iteratie

Nadat de codewijzigingen zijn voltooid, start het migratieprogramma een validatie- en herstellus voor iteraties. Deze lus bevat de volgende vijf stappen:

  1. Detecteer veelvoorkomende beveiligingsproblemen en blootstellingen (CVE's) in huidige afhankelijkheden en corrigeer deze.
  2. Bouw het project en los eventuele buildfouten op.
  3. Analyseer de code voor functionele consistentie.
  4. Analyseer het project voor eenheidstestfouten en genereer automatisch een plan om ze op te lossen totdat de tests zijn geslaagd.
  5. Analyseer de code voor migratie-items die tijdens de eerste codemigratie zijn gemist en corrigeer ze.

Nadat alle processen zijn voltooid, genereert het migratieprogramma een samenvatting. Controleer de codewijzigingen en bevestig ze door Behouden te selecteren.

Volgende stappen

  • Last updated on