Delen via

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

In deze snelstartgids evalueert en migreert u een .NET-project door het gebruik van GitHub Copilot-appmodernisatie voor .NET. U voert de volgende taken uit:

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

Prerequisites

Gereedheid van apps beoordelen

De modernisering van GitHub Copilot-apps 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 voor het instellen van Azure-resources, het toevoegen van configuraties en het aanbrengen van codewijzigingen. Volg deze stappen om uw migratie te starten:

  1. Kopieer de repository van de .NET migration copilot samples naar uw computer.

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

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

    Schermopname van de optie moderniseren in het contextmenu.

  4. Het Venster GitHub Copilot Chat wordt geopend met een welkomstbericht en vooraf gedefinieerde opties. Selecteer Migreren 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 verzenden @Modernize Migrate to Azure 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

Modernisering van GitHub Copilot-apps voor .NET omvat 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.

Schermopname 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 "App modernization: migrate from <source technology> to <target technology>" in agentmodus met vooraf gedefinieerde opdrachten.
  • 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 wanneer deze 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 start het migratieproces en kan uw goedkeuring vragen om knowledge base-hulpprogramma's te gebruiken op de MCP-server (Model Context Protocol). Geef toestemming wanneer u hierom wordt gevraagd.

  • Copilot volgt het plan en de voortgangsmonitor om te:

    • 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

Modernisering van GitHub Copilot-apps voor .NET biedt standaardopties voor chatberichten om uw werkstroom te stroomlijnen.

Schermopname van de standaardopties voor chatberichten in de Copilot-chat.

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

  • Moderniseringsevaluatie uitvoeren: start een nieuwe evaluatie van uw toepassing om problemen met migratiegereedheid en Azure-compatibiliteitsproblemen te identificeren.
  • 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 met Copilot te communiceren voor specifieke vragen of behoeften.

Volgende stappen

Prerequisites

Gereedheid van apps beoordelen

De modernisering van GitHub Copilot-apps 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 voor het instellen van Azure-resources, het toevoegen van configuraties en het aanbrengen van codewijzigingen. Volg deze stappen om uw migratie te starten:

  1. Kopieer de repository van de .NET migration copilot samples naar uw computer.

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

  3. Open de uitbreiding voor modernisering van de GitHub Copilot-app .

  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

Modernisering van GitHub Copilot-apps voor .NET omvat 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 op de activiteitenbalk 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 modernisering en migratiescenario's voor .NET-toepassingen.

    Schermopname 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 taak Database migreren naar Azure Database for PostgreSQL onder Databasetaken werkt bijvoorbeeld uw databaseverbinding, configuraties, afhankelijkheden en gegevenstoegangscode bij voor het gebruik van Azure Database for PostgreSQL.

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 wanneer deze 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 start het migratieproces en kan uw goedkeuring vragen om knowledge base-hulpprogramma's te gebruiken op de MCP-server (Model Context Protocol). Geef toestemming wanneer u hierom wordt gevraagd.

Copilot volgt het plan en de voortgangsmonitor om te:

  • 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 app-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