Schnellstart: Bewerten und Migrieren eines .NET-Projekts mit GitHub Copilot-Modernisierung für .NET

Prerequisites

• Windows Betriebssystem.

• Visual Studio 2026 (oder Visual Studio 2022, Version 17.14.17 und höher).

• .NET Desktopentwicklungsworkload mit den folgenden optionalen Komponenten aktiviert:

  • GitHub Copilot
  • GitHub Copilot Modernisierungsagent

• GitHub Copilot Abonnement (kostenpflichtig oder kostenlos).

• Angemeldet in Visual Studio mit einem GitHub-Konto mit Copilot-Zugriff.

  Von Bedeutung

  Wenn Sie Abonnements ändern, müssen Sie Visual Studio neu starten.

• Code muss in C# geschrieben werden.

Bewerten der App-Bereitschaft

Die GitHub Copilot-Modernisierung für .NET-Bewertung hilft Ihnen, Herausforderungen bei der App-Bereitschaft zu finden, ihre Auswirkungen zu erlernen und empfohlene Migrationsaufgaben anzuzeigen. Jede Migrationsaufgabe enthält Verweise, um Azure Ressourcen einzurichten, Konfigurationen hinzuzufügen und Codeänderungen vorzunehmen. Führen Sie die folgenden Schritte aus, um ihre Migration zu starten:

1. Klonen Sie das Repository mit den Beispielen für den .NET-Migrations-Copilot auf Ihrem Computer.

2. Öffnen Sie in Visual Studio die Lösung Contoso University aus dem Beispiel-Repository.

3. Klicken Sie in Solution Explorer mit der rechten Maustaste auf den Lösungsknoten, und wählen Sie Modernize aus.

   

4. Das GitHub Copilot Chatfenster wird mit einer Willkommensnachricht und vordefinierten Optionen geöffnet. Wählen Sie Migrate zu Azure aus den verfügbaren Optionen aus, und senden Sie sie an Copilot.

   

   Tip

   Statt der Schritte 3 und 4 können Sie GitHub Copilot Chat direkt öffnen und @Modernize Migrate to Azure senden, um den Bewertungs- und Migrationsfluss zu starten.

5. Eine neue Copilot-Chatsitzung wird geöffnet und zeigt die Willkommensnachricht an. Die Bewertung beginnt automatisch und analysiert Ihr Projekt für die Migrationsbereitschaft.

   

6. Nach Abschluss der Bewertung wird eine umfassende Benutzeroberfläche des Bewertungsberichts und eine Liste der Migrationsaufgaben im Chatfenster angezeigt.

   

App-Migrationen

Die GitHub Copilot-Modernisierung für .NET umfasst vordefinierte Aufgaben für allgemeine Migrationsszenarien und folgt den bewährten Methoden von Microsoft.

Starten einer Migrationsaufgabe

Starten Sie eine Migrationsaufgabe auf eine der folgenden Arten:

Option 1: Aus dem Bewertungsbericht ausführen

Wählen Sie die Schaltfläche " Aufgabe ausführen " im Bewertungsbericht aus dem vorherigen Schritt aus, um eine Migrationsaufgabe zu starten.

Option 2. In Copilot Chat senden

Senden Sie die Aufgabennummer der Migration (z. B. 1.1) oder ihren Namen im Chat.

Plan und Progress Tracker generieren

• Wenn Sie die Migration starten, startet GitHub Copilot eine Sitzung mit dem Namen "App-Modernisierung: Migrieren von <source technology> zu <target technology>" im Agentmodus mit vordefinierten Eingabeaufforderungen.
• Das Tool erstellt zwei Dateien im .appmod/.migration Ordner:
  • plan.md: Der allgemeine Migrationsplan.
  • progress.md: Eine Fortschrittsanzeige, die GitHub Copilot aktualisiert, während Aufgaben ausgeführt werden.
• Bearbeiten Sie diese Dateien, um Ihre Migration anzupassen, bevor Sie fortfahren.

Codekorrektur starten

• Wenn Sie mit dem Plan und der Statusverfolgung zufrieden sind, geben Sie eine Eingabeaufforderung ein, um den Migrationsprozess zu starten, z. B.:

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

• GitHub Copilot startet den Migrationsprozess und fordert möglicherweise Ihre Genehmigung für die Verwendung von Knowledge Base-Tools auf dem MCP-Server (Model Context Protocol) auf. Erteilen Sie die Berechtigung, wenn Sie dazu aufgefordert werden.

• Copilot folgt dem Plan und der Fortschrittsanzeige, um:

  • Verwalten von Abhängigkeiten.
  • Wenden Sie Konfigurationsänderungen an.
  • Nehmen Sie Änderungen am Code vor.
  • Erstellen Sie die Lösung, beheben Sie alle Kompilierungs- und Konfigurationsfehler, und stellen Sie einen erfolgreichen Build sicher.
  • Beheben Sie Sicherheitslücken.

Standardchatnachrichten

Die GitHub Copilot-Modernisierung für .NET bietet Standardmäßige Chatnachrichtenoptionen, um Ihren Workflow zu optimieren.

Wählen Sie eine der vordefinierten Optionen aus, und senden Sie sie im Chat:

• Run-Modernisierungsbewertung: Startet eine neue Bewertung Ihrer Anwendung, um Probleme mit der Migrationsbereitschaft und Azure Kompatibilitätsprobleme zu identifizieren.
• Bewertungsbericht anzeigen: Öffnet den vorherigen Bewertungsbericht und zeigt eine Zusammenfassung der Migrationsaufgaben basierend auf den Ergebnissen an. Wenn keine vorherige Bewertung vorhanden ist, wird zuerst eine neue Bewertung ausgeführt.
• Durchsuchen sie die wichtigsten Migrationsaufgaben: Zeigt empfohlene Migrationsaufgaben und allgemeine Modernisierungsszenarien an, unabhängig von bestimmten Bewertungsergebnissen.

Nächste Schritte

• Arbeiten mit Bewertung
• Vordefinierte Aufgaben
• Häufig gestellte Fragen

Prerequisites

• Ein GitHub-Konto mit einem aktiven GitHub Copilot-Abonnement unter einem beliebigen Plan.

• Die neueste Version von Visual Studio Code. Muss Version 1.101 oder höher sein.

  • GitHub Copilot in Visual Studio Code. Anweisungen zum Einrichten von GitHub Copilot finden Sie unter "Einrichten von GitHub Copilot" in Visual Studio Code. Melden Sie sich bei Ihrem GitHub-Konto in Visual Studio Code an.
  • GitHub Copilot Modernisierung. Starten Sie Visual Studio Code nach der Installation neu.

• Eine .NET Entwicklungsumgebung zum Erstellen und Testen des Projekts.

Bewerten der App-Bereitschaft

Die GitHub Copilot-Modernisierung für .NET-Bewertung hilft Ihnen, Herausforderungen bei der App-Bereitschaft zu finden, ihre Auswirkungen zu erlernen und empfohlene Migrationsaufgaben anzuzeigen. Jede Migrationsaufgabe enthält Verweise, um Azure Ressourcen einzurichten, Konfigurationen hinzuzufügen und Codeänderungen vorzunehmen. Führen Sie die folgenden Schritte aus, um ihre Migration zu starten:

1. Klonen Sie das Repository mit den Beispielen für den .NET-Migrations-Copilot auf Ihrem Computer.

2. Öffnen Sie in Visual Studio Code die Lösung Contoso University aus dem Beispiel-Repository.

3. Öffnen Sie die GitHub Copilot-Modernisierungserweiterung .

4. Wählen Sie im Abschnitt "SCHNELLSTART " die Option "Bewertung starten" aus. Die Seite "Bewertungsberichte " wird geöffnet.

5. Wählen Sie " Bewertung ausführen" in der oberen rechten Ecke der Seite aus.

   

6. Die Bewertung beginnt automatisch und analysiert Ihr Projekt für die Migrationsbereitschaft.

   

7. Nach Abschluss der Bewertung wird eine umfassende Benutzeroberfläche des Bewertungsberichts und eine Liste der Migrationsaufgaben im Chatfenster angezeigt.

   

App-Migrationen

Die GitHub Copilot-Modernisierung für .NET umfasst vordefinierte Aufgaben für allgemeine Migrationsszenarien und folgt den bewährten Methoden von Microsoft.

Chatbasierte Migration (empfohlen)

Chatbasierte Migration ist die empfohlene Methode zum Starten einer Migration. Der AppModernization-DotNet benutzerdefinierte Agent ist für Anwendungsmodernisierungsaufgaben optimiert. Mit diesem Agent können Sie einfache, natürliche Sprachaufforderungen verwenden, um komplexe Migrationsszenarien auszuführen.

Führen Sie die folgenden Schritte aus, um den benutzerdefinierten Agent auszuwählen und die Migration zu starten:

1. Stellen Sie sicher, dass ein .NET Projekt in Visual Studio Code geöffnet ist.

2. Wählen Sie das Chatsymbol in der Activity Bar aus, um das Copilot-Chatfenster zu öffnen.

3. Suchen Sie im Chatfenster das Dropdownmenü der Agentauswahl oben im Chateingabefeld. Wählen Sie "AppModernization-DotNet " aus der Liste aus. Dieser benutzerdefinierte Agent wurde für .NET Anwendungsmodernisierungs- und Migrationsszenarien entwickelt.

   

4. Geben Sie eine Eingabeaufforderung mit dem Format migrate from <source> to <target> im Chatfenster ein. Beispiel:

   migrate from rabbitmq to Azure service bus
   

5. Der Agent analysiert Ihren Code, erstellt einen Migrationsplan, nimmt Codeänderungen vor, führt Validierungen aus und generiert eine Zusammenfassung. Wählen Sie "Weiter" , um die einzelnen Schritte fortzusetzen und die Änderungen anzunehmen.

Starten einer Migrationsaufgabe über die Benutzeroberfläche

Sie können auch eine Migrationsaufgabe über die Benutzeroberfläche starten:

Option 1: Aus dem Bewertungsbericht ausführen

Wählen Sie die Schaltfläche " Aufgabe ausführen " im Bewertungsbericht aus dem vorherigen Schritt aus, um eine Migrationsaufgabe zu starten.

Option 2. Anwenden einer vordefinierten Aufgabe

Führen Sie den spezifischen Vorgang im Abschnitt TASKS - .NET aus. Die Aufgabe Migrate Database to Azure Database for PostgreSQL unter Datenbankaufgaben aktualisiert Ihre Datenbankverbindung, Konfigurationen, Abhängigkeiten und Datenzugriffscode, um die Azure Database for PostgreSQL zu nutzen.

Plan und Progress Tracker generieren

Wenn Sie die Migration starten, startet GitHub Copilot eine Sitzung im Agentmodus.

Das Tool erstellt zwei Dateien im .github/appmod/code-migration/<target-branch-name> Ordner:

• plan.md: Der allgemeine Migrationsplan.
• progress.md: Eine Fortschrittsanzeige, die GitHub Copilot aktualisiert, während Aufgaben ausgeführt werden.

Bearbeiten Sie diese Dateien, um Ihre Migration anzupassen, bevor Sie fortfahren.

Codekorrektur starten

Wenn Sie mit dem Plan und der Statusverfolgung zufrieden sind, geben Sie weiter ein, um die Migration zu starten.

GitHub Copilot startet den Migrationsprozess und fordert möglicherweise Ihre Genehmigung für die Verwendung von Knowledge Base-Tools auf dem MCP-Server (Model Context Protocol) auf. Erteilen Sie die Berechtigung, wenn Sie dazu aufgefordert werden.

Copilot folgt dem Plan und der Fortschrittsanzeige, um:

• Verwalten von Abhängigkeiten.
• Wenden Sie Konfigurationsänderungen an.
• Nehmen Sie Änderungen am Code vor.
• Erstellen Sie das Projekt, beheben Sie alle Kompilierungs- und Konfigurationsfehler, und stellen Sie einen erfolgreichen Build sicher.
• Beheben Sie Sicherheitslücken.

Wählen Sie wiederholt "Weiter" aus, oder geben Sie "Weiter" ein, um die Verwendung von Tools oder Befehlen zu bestätigen, und warten Sie, bis die Codeänderungen abgeschlossen sind.

Überprüfungsiteration

Nach Abschluss der Codeänderungen startet das Migrationstool eine Validierungs- und Korrekturschleife der Iterationen. Diese Schleife enthält die folgenden fünf Schritte:

1. Erkennen Sie allgemeine Sicherheitsrisiken und Expositionen (CVEs) in aktuellen Abhängigkeiten, und beheben Sie sie.
2. Erstellen Sie das Projekt, und beheben Sie alle Buildfehler.
3. Analysieren Sie den Code auf funktionsbezogene Konsistenz.
4. Analysieren Sie das Projekt auf Komponententestfehler, und generieren Sie automatisch einen Plan, um sie zu beheben, bis die Tests erfolgreich sind.
5. Analysieren Sie den Code für Migrationselemente, die bei der anfänglichen Codemigration verpasst wurden, und korrigieren Sie sie.

Nach Abschluss aller Prozesse generiert das Migrationstool eine Zusammenfassung. Überprüfen Sie die Codeänderungen, und bestätigen Sie sie, indem Sie "Beibehalten" auswählen.