Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
GitHub Copilot modernisering is een GitHub Copilot-agent waarmee u projecten kunt upgraden naar nieuwere versies van .NET en .NET toepassingen kunt migreren naar Azure snel en betrouwbaar. Het begeleidt u bij de evaluatie, aanbevelingen voor oplossingen, codecorrecties en validatie in Visual Studio, Visual Studio Code, GitHub Copilot CLI en GitHub.com.
Gebruik deze agent om het volgende te doen:
- Voer een upgrade uit naar een nieuwere versie van .NET.
- Technologieën migreren en implementeren naar Azure.
- Uw .NET-app moderniseren, met name wanneer u een upgrade uitvoert van .NET Framework.
- Evalueer de code, configuratie en afhankelijkheden van uw toepassing.
- Plan en stel de juiste Azure resource in.
- Los problemen op en pas best practices toe voor cloudmigratie.
- Controleer of uw app succesvol wordt gebouwd en getest.
Scenariën
De agent biedt meerdere end-to-end moderniseringswerkstromen, scenario's genoemd. Elk scenario is een beheerde werkstroom die u begeleidt bij een specifiek type upgrade of migratie:
| Scenario | Beschrijving | Voorbeeldprompt |
|---|---|---|
| .NET versie-upgrade | Upgrades van oudere .NET versies naar .NET 8, 9, 10 of hoger. | "Upgrade mijn oplossing naar .NET 10" |
| Conversie van SDK-stijl | Converteert de verouderde projectindeling naar SDK-stijl. | "Converteren naar SDK-stijl" |
| Newtonsoft.Json-migratie | Vervangt Newtonsoft.Json door System.Text.Json. | "Migreren vanuit Newtonsoft.Json" |
| SqlClient-migratie | Migreert van System.Data.SqlClient naar Microsoft. Data.SqlClient. | "SqlClient bijwerken" |
| Azure Functions upgrade | Upgrades Azure Functions van een in-proces naar een geïsoleerd werkermodel. | 'Upgrade mijn Azure Functions' |
| Semantic Kernel naar agents | Migreert Semantic Kernel Agents naar Microsoft Agents AI. | "Mijn SK-agents migreren" |
Zie Overzicht van scenario's en vaardigheden voor een volledig referentie van alle scenario's en meer dan 30 ingebouwde migratievaardigheden.
Feedback geven
Microsoft hecht waarde aan uw feedback en gebruikt die om de agent te verbeteren. Feedback geven met een van de volgende opties:
Gebruik in Visual Studio de Suggest a feature and Report a problem options.
Dien een melding in in de @modernize-dotnet GitHub opslagplaats.
Vereiste voorwaarden
Stel GitHub Copilot modernisering in uw ontwikkelomgeving in voordat u de agent gebruikt. Zie Install GitHub Copilot modernization voor installatiestappen.
.NET-projecten upgraden
De moderniseringsagent ondersteunt het upgraden van C# en Visual Basic projecten van de volgende typen:
- ASP.NET Core (en gerelateerde technologieën zoals MVC, Razor Pages en Web-API)
- Blazor
- Azure Functions
- Windows Presentation Foundation (WPF)
- Windows Forms
- WinUI
- .NET MAUI en Xamarin
- Klassebibliotheken
- Consoletoepassingen
- Testprojecten (MSTest, NUnit en xUnit)
Zie Een .NET-app upgraden met modernisering door GitHub Copilot om een upgrade te starten.
Ondersteunde upgradepaden
De agent ondersteunt de volgende upgradepaden:
| bron | Target |
|---|---|
| .NET Framework (elke versie) | .NET 8 of hoger |
| .NET Core 1.x–3.x | .NET 8 of hoger |
| .NET 5 of hoger | .NET 8 of hoger |
.NET projecten migreren naar Azure
De moderniseringsagent vereenvoudigt Azure migraties via geautomatiseerde analyse, AI-gestuurde codeherstel, controles voor bouwen en beveiligingsproblemen en automatisering van implementatie:
Analyse en intelligente aanbevelingen.
Beoordeel de gereedheid van uw toepassing voor Azure migratie en ontvang op maat gemaakte richtlijnen op basis van de afhankelijkheden en geïdentificeerde problemen.
Door AI aangedreven codeherstel.
Pas vooraf gedefinieerde codepatronen voor best practice toe om modernisering te versnellen met minimale handmatige inspanning.
Automatische build en CVE-resolutie.
Bouw uw app en los compilatiefouten en beveiligingsproblemen op, en stroomlijn de ontwikkeling.
Naadloze implementatie.
Implementeer naar Azure en neem uw code sneller van ontwikkeling naar productie.
Vooraf gedefinieerde taken voor migratie
GitHub Copilot modernisering voor .NET biedt vooraf gedefinieerde taken die aanbevolen procedures voor de branche vastleggen en algemene migratiescenario's behandelen.
Migreer naar een op Managed Identity gebaseerde database op Azure, inclusief Azure SQL DB, Azure SQL MI en Azure PostgreSQL
Moderniseer uw gegevenslaag door te migreren van on-premises of verouderde databases (zoals DB2, Oracle DB of SQL Server) naar Azure SQL DB, Azure SQL Managed Instance of Azure PostgreSQL. Gebruik beveiligde verificatie van beheerde identiteiten.
Migrate to Azure File Storage
Verplaats bestands-I/O-bewerkingen van het lokale bestandssysteem naar Azure File Storage voor schaalbaar, cloudbestandsbeheer.
Migrate to Azure Blob Storage
Vervang on-premises of cross-cloud objectopslag, of bestand I/O van lokale bestandssystemen, door Azure Blob Storage voor niet-gestructureerde gegevens.
Migreer naar Microsoft Entra ID
Verificatie en autorisatie overzetten van Windows Active Directory naar Microsoft Entra ID (voorheen Azure AD) voor modern identiteitsbeheer.
Migreer naar beveiligde referenties met Managed Identity en Azure Key Vault
Vervang platte-tekst referenties in configuratie of code door beveiligde, beheerde identiteiten en Azure Key Vault voor het beheer van geheimen.
Migreren naar Azure Service Bus
Overstappen van verouderde berichtenwachtrijen of berichtenwachtrijen van derden (zoals MSMQ of RabbitMQ) of Amazon SQS (AWS Simple Queue Service) naar Azure Service Bus voor betrouwbare, cloudgebaseerde berichten.
Migreer naar Azure Communication Service-e-mail
Vervang directe SMTP-e-mail die wordt verzonden door Azure Communication Service voor schaalbare, veilige e-mailbezorging.
Migrate to Confluent Cloud/Azure Event Hub for Apache Kafka
Stap over van lokale of on-premises Kafka naar beheerde gebeurtenisstreaming met Confluent Cloud of Azure Event Hubs.
Migreer naar OpenTelemetry op Azure
Overstappen van lokale frameworks voor logboekregistratie, zoals log4net, Serilog en Windows gebeurtenislogboek naar OpenTelemetry op Azure.
Gebruik Managed Identity om naar Azure Cache voor Redis te migreren
Vervang in-memory of lokale Redis-cacheimplementaties door Azure Cache voor Redis voor hoge beschikbaarheid, schaalbaarheid en beveiliging op bedrijfsniveau.
Hoe het werkt
Als u een upgrade of migratieproces wilt starten, raadpleegt u:
Open uw .NET project of oplossing in uw ontwikkelomgeving.
Start de agent met behulp van een van de volgende methoden:
-
Visual Studio: klik met de rechtermuisknop op de oplossing of het project in Solution Explorer en selecteer Modernize. Of open het venster GitHub Copilot Chat en typ
@Modernize. -
Visual Studio Code: Open het deelvenster GitHub Copilot Chat en typ
@modernize-dotnet. -
GitHub Copilot CLI: typ
@modernize-dotnetgevolgd door uw upgrade- of migratieaanvraag. -
GitHub.com: gebruik de
modernize-dotnetcoderingsagent in uw opslagplaats.
-
Visual Studio: klik met de rechtermuisknop op de oplossing of het project in Solution Explorer en selecteer Modernize. Of open het venster GitHub Copilot Chat en typ
Laat de agent weten wat er moet worden bijgewerkt of gemigreerd.
Wanneer u de moderniseringsagent vraagt om uw app te upgraden, zal Copilot u eerst vragen om een nieuwe branch te maken als u in een Git-opslagplaats werkt. Vervolgens Copilot uw project beoordeelt en een werkstroom met drie fasen uitvoert. Elke fase produceert Markdown-bestanden in .github/upgrades/{scenarioId} uw repository, zodat u kunt controleren wat er daarna gebeurt voordat u verder gaat. Als .github/upgrades/{scenarioId} al bestaat uit een eerdere poging, Copilot vraagt of u wilt doorgaan of opnieuw wilt beginnen.
Copilot begint met het onderzoeken van uw projectstructuur, afhankelijkheden en codepatronen om een uitgebreide evaluatie te maken. Het assessment.md bestand bevat belangrijke wijzigingen, API-compatibiliteitsproblemen, afgeschafte patronen en het upgradebereik.
Na de evaluatie voert Copilot de volgende drie fasen uit:
Assessment: Copilot onderzoekt uw projectstructuur, afhankelijkheden en codepatronen en presenteert vervolgens strategiebeslissingen voor uw beoordeling, zoals de upgradestrategie (bottom-up, top-down of all-at-once), de benadering van projectmigratie, opties voor technologische modernisering en compatibiliteitsafhandeling. Copilot slaat bevestigde beslissingen op in
upgrade-options.md.Planning: Copilot converteert de evaluatie en uw bevestigde opties naar een gedetailleerde specificatie. Het
plan.mdbestand documenteert upgradestrategieën, herstructureringsmethoden, afhankelijkheidspaden en risicobeperking.Execution: Copilot breekt het plan af in opeenvolgende, concrete taken met validatiecriteria in
tasks.md. Elke taak beschrijft één wijziging en hoe Copilot bevestigt dat deze is geslaagd.
Bewerk een van de Markdown-bestanden .github/upgrades/{scenarioId} om de upgradestappen aan te passen of context toe te voegen voordat u verdergaat.
Upgradestrategieën
Tijdens de evaluatiefase evalueert de agent uw oplossing en wordt een van de volgende strategieën aanbevolen:
| Strategie | Ideaal voor | Beschrijving |
|---|---|---|
| Bottom-up | Grote oplossingen met diepe afhankelijkheidsgrafieken | Upgradet bladprojecten eerst en werkt vervolgens omhoog. |
| Van boven naar beneden | Snelle feedback over de hoofdtoepassing | Werkt eerst het toepassingsproject bij en lost vervolgens afhankelijkheden op. |
| Alles tegelijk | Kleine, eenvoudige oplossingen | Hiermee worden alle projecten in één pas bijgewerkt. |
Stroommodi
De agent ondersteunt twee stroommodi die bepalen hoeveel deze pauzeert voor uw invoer:
- Automatisch: De agent werkt door alle fasen zonder te onderbreken en stopt alleen bij echte blokkers. Het meest geschikt voor ervaren gebruikers en eenvoudige upgrades.
- Geleid: De agent onderbreekt bij elke fasegrens, zodat u de evaluatie, het plan en de taken kunt controleren voordat u doorgaat. Het meest geschikt voor gebruikers voor het eerst en complexe oplossingen.
Schakel op elk gewenst moment tussen modi door te zeggen 'onderbreken' (om de begeleide modus in te schakelen) of 'doorgaan' (om de automatische modus in te schakelen).
Toestandbeheer
De agent slaat alle upgradestatussen op in .github/upgrades/{scenarioId}/. De map bevat:
| Bestand | Purpose |
|---|---|
assessment.md |
Analyse van uw oplossing |
upgrade-options.md |
Bevestigde beslissingen voor upgrades |
plan.md |
Geordende taakplanning |
tasks.md |
Livevoortgangsdashboard |
scenario-instructions.md |
Het permanente geheugen van de agent, inclusief voorkeuren, beslissingen en aangepaste instructies |
execution-log.md |
Gedetailleerd overzicht van alle wijzigingen |
tasks/{taskId}/task.md |
Bereik en context per taak |
tasks/{taskId}/progress-details.md |
Notities en resultaten per taakuitvoering |
Omdat alle statussen zich in deze map bevinden, kunt u uw IDE sluiten, schakelen tussen sessies of zelfs schakelen tussen ontwikkelomgevingen (bijvoorbeeld starten in VS Code en doorgaan in Visual Studio). De agent gaat verder waar het was gebleven.
Aanbeveling
Voer de map door naar uw .github/upgrades/ vertakking. De vastgelegde status fungeert als back-up en stelt teamleden in staat de voortgang van de upgrade te bekijken.
De upgrade uitvoeren
Nadat elke fase is voltooid, controleert en wijzigt u de gegenereerde bestanden indien nodig en geeft u Copilot vervolgens aan om door te gaan naar de volgende fase.
Wanneer u de fase Execution bereikt, laat u Copilot weten om de upgrade te starten. Als Copilot een probleem ondervindt, wordt geprobeerd de oorzaak te identificeren en een oplossing toe te passen. Als Copilot het probleem niet kan oplossen, wordt u om hulp gevraagd. Wanneer u tussenkomt, leert Copilot van de wijzigingen die u aanbrengt en probeert deze automatisch toe te passen als het probleem zich opnieuw voordoet.
Resultaten van de upgrade
Terwijl Copilot elke taak uitvoert, wordt het bestand tasks.md bijgewerkt in .github/upgrades/{scenarioId} met de status van elke stap. Controleer de voortgang door dit bestand te controleren. Copilot maakt een Git-doorvoer voor elk deel van het proces, zodat u wijzigingen kunt terugdraaien of kunt controleren wat er is gewijzigd.
Wanneer de upgrade is voltooid, worden in Copilot volgende stappen in het chatantwoord weergegeven.
Telemetrie
Het hulpprogramma verzamelt gegevens over projecttypen, intentie om te upgraden en upgradeduur. De ontwikkelomgeving verzamelt en aggregeert de gegevens en bevat geen door de gebruiker identificeerbare informatie. Zie Visual Studio Programma voor kwaliteitsverbetering voor meer informatie over het privacybeleid van Microsoft.
Verwante inhoud
- Installeer GitHub Copilot modernisering
- Upgrade een .NET-app met modernisering door GitHub Copilot
- Kernconcepten
- Referentie voor scenario's en vaardigheden
- Beste praktijken
- Problemen oplossen met GitHub Copilot modernisering
- Quickstart: Een .NET-project migreren
- veelgestelde vragen modernisering van GitHub Copilot