Teilen über

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

In dieser Schnellstartanleitung bewerten und migrieren Sie ein .NET-Projekt mithilfe der GitHub Copilot-App-Modernisierung für .NET. Sie führen die folgenden Aufgaben durch:

  • Bewerten eines Beispielprojekts (Contoso University)
  • Starten des Migrationsprozesses

Prerequisites

Bewerten der App-Bereitschaft

GitHub Copilot-App-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 zum Einrichten von Azure-Ressourcen, Hinzufügen von Konfigurationen und Vornehmen von Codeänderungen. Führen Sie die folgenden Schritte aus, um ihre Migration zu starten:

  1. Klonen Sie das .NET-Migration-Copilot-Beispiel-Repository auf Ihren Computer.

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

  3. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektmappenknoten, und wählen Sie "Modernisieren" aus.

    Screenshot der Option

  4. Das GitHub Copilot Chat-Fenster wird mit einer Willkommensnachricht und vordefinierten Optionen geöffnet. Wählen Sie "Zu Azure migrieren" aus den verfügbaren Optionen aus, und senden Sie sie an Copilot.

    Screenshot der Willkommensnachricht mit Migrationsoptionen.

    Tip

    Statt der Schritte 3 und 4 können Sie GitHub Copilot Chat direkt öffnen und senden @Modernize Migrate to Azure , um die Bewertung und den 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.

    Screenshot, das die Statusindikatoren einer Bewertung zeigt, die in Bearbeitung ist.

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

    Screenshot des generierten Bewertungsberichts mit detaillierten Ergebnissen.

App-Migrationen

GitHub Copilot-App-Modernisierung für .NET enthält 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.

Screenshot des Sendens einer Nachricht im Copilot-Chat zum Starten einer Migrationsaufgabe.

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 es Aufgaben ausführt.
  • 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 zur 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 Progress Tracker:

    • 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 Modernisierung der GitHub Copilot-App für .NET bietet standardmäßige Chatnachrichtenoptionen, um Ihren Workflow zu optimieren.

Screenshot der Standardoptionen für Chatnachrichten im Copilot-Chat.

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

  • Führen Sie die Modernisierungsbewertung aus: Startet eine neue Bewertung Ihrer Anwendung, um Migrationsbereitschaftsprobleme 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.

Tip

Diese Standardmeldungen helfen Ihnen, schnell in gängige Workflows zu navigieren, ohne benutzerdefinierte Eingabeaufforderungen einzugeben. Sie können auch Eigene Nachrichten eingeben, um mit Copilot für bestimmte Fragen oder Anforderungen zu interagieren.

Nächste Schritte

Prerequisites

Bewerten der App-Bereitschaft

GitHub Copilot-App-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 zum Einrichten von Azure-Ressourcen, Hinzufügen von Konfigurationen und Vornehmen von Codeänderungen. Führen Sie die folgenden Schritte aus, um ihre Migration zu starten:

  1. Klonen Sie das .NET-Migration-Copilot-Beispiel-Repository auf Ihren Computer.

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

  3. Öffnen Sie die GitHub Copilot-App-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.

    Screenshot der Ausführung einer Aufgabe im Aufgabenabschnitt zum Starten einer Migrationsaufgabe.

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

    Screenshot der Ausführung einer Aufgabe, die Ihr Projekt für die Migrationsbereitschaft analysiert.

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

    Screenshot von der UI-Seite zum Ausführen eines Bewertungsberichts und einer Liste von Migrationsaufgaben.

App-Migrationen

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

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 Aktivitätsleiste 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.

    Screenshot der Auswahl des benutzerdefinierten .NET-Agents im Chatfenster.

  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 AUFGABEN - .NET aus. Die Aufgabe "Datenbank zu Azure Database für PostgreSQL migrieren" unter " Datenbankaufgaben " aktualisiert beispielsweise Ihre Datenbankverbindung, Konfigurationen, Abhängigkeiten und Datenzugriffscode, um Azure Database für PostgreSQL zu verwenden.

Screenshot der Ausführung einer bestimmten vordefinierten Aufgabe.

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 es Aufgaben abschließt.

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

Screenshot der Plangenerierung während einer Migrationsaufgabe.

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 zur 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 Progress Tracker:

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

Hinweis

In Visual Studio Code verwendet die App-Modernisierung standardmäßig den AppModernization-DotNet benutzerdefinierten Agent mit Claude Sonnet 4.5, um optimale Ergebnisse beim Aktualisieren von .NET-Code zur Migration zu Azure zu erzielen. Es fällt auf das 'auto'-Modell zurück, wenn Sonnet 4.5 Ihnen nicht zur Verfügung steht. Sie können den benutzerdefinierten Agent so konfigurieren, dass er die Einstellung "Modell" ändert, indem Sie im Menü "Agent" die Option "Benutzerdefinierte Agents konfigurieren" auswählen. Alternativ können Sie die Sprachmodellauswahl im Chatfenster verwenden, um Modelle für die aktuelle Chatsitzung zu wechseln.

Ü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.

Nächste Schritte

  • Last updated on