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

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

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

Prerequisites

Hinweis

Diese Voraussetzungen gelten für Visual Studio. Weitere Entwicklungsumgebungen finden Sie unter Installieren der GitHub Copilot-Modernisierung.

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 Projektmappen-Explorer mit der rechten Maustaste auf den Lösungsknoten, und wählen Sie Modernize aus.

    Screenshot der Option

  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.

    Screenshot der Willkommensnachricht mit Migrationsoptionen.

    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.

    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

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.

Screenshot zum Senden einer Nachricht in Copilot Chat zum Starten einer Migrationsaufgabe.

Plan und Progress Tracker generieren

  • Wenn Sie die Migration starten, startet GitHub Copilot eine Sitzung mit dem Namen "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.

Screenshot mit Standardoptionen für Chatnachrichten in der Copilot Chat.

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.

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

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.

    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

Die GitHub Copilot-Modernisierung für .NET umfasst 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 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.

    Screenshot zum Auswählen des .NET benutzerdefinierten 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 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.

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 Aufgaben ausgeführt werden.

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

Hinweis

In Visual Studio Code verwendet die 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.

Prerequisites

Installieren des Plug-Ins

  1. Führen Sie in einem Terminal copilot aus, um Copilot CLI zu starten.

    copilot

  2. Fügen Sie den Marketplace hinzu, und installieren Sie das Plug-In:

    /plugin marketplace add microsoft/github-copilot-modernization
/plugin install github-copilot-modernization@github-copilot-modernization

  3. Überprüfen Sie, ob das Plug-In installiert ist:

    /plugin list

    Sie sollten github-copilot-modernization in der Liste sehen.

Bewerten der App-Bereitschaft

GitHub Copilot Modernisierungsbewertung hilft Ihnen, Herausforderungen bei der App-Bereitschaft zu finden, ihre Auswirkungen zu erlernen und empfohlene Migrationsaufgaben anzuzeigen.

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

  2. Navigieren Sie zum Projektordner der Contoso University :

    cd dotnet-migration-copilot-samples/ContosoUniversity

  3. Starten Sie Copilot CLI mit dem Modernisierungs-Agent:

    copilot --agent=github-copilot-modernization:modernize

    Von Bedeutung

    Sie müssen den github-copilot-modernization:modernize Agent auswählen, bevor Sie Modernisierungsaufforderungen ausführen. Wenn Sie sich bereits in einer Copilot CLI-Sitzung befinden, verwenden /agent Und wählen Sie github-copilot-modernization:modernize sie aus der Liste aus.

  4. Bitten Sie den Agenten, die Anwendung zu bewerten:

    copilot> modernize my application

    Der Agent startet automatisch die Bewertungsphase und analysiert Ihr Projekt auf die Migrationsbereitschaft – einschließlich Abhängigkeiten, Frameworks und Azure Migrationsmöglichkeiten.

  5. Nach Abschluss der Bewertung stellt der Agent eine Zusammenfassung der Ergebnisse vor und fragt: "Fahren Sie mit der Planung fort?"

Migrieren Ihrer App

Fahren Sie nach der Überprüfung der Bewertung mit den Planungs- und Ausführungsphasen fort.

Vollständige Modernisierung (bewerten → Plan → ausführen)

Der Agent führt den vollständigen Workflow automatisch aus, wenn Sie jede Phase bestätigen:

  1. Bewertung → Überprüfen Sie die Ergebnisse → Bestätigen, dass Sie fortfahren möchten.
  2. Planung → Der Agent generiert einen Migrationsplan (plan.md) → Überprüfen und Bestätigen.
  3. Ausführung → Der Agent leitet Aufgaben an spezialisierte Executor-Agents weiter, die Codeänderungen anwenden, Builds ausführen und Ergebnisse überprüfen.

Der Agent verarbeitet alles – bestätigen Sie einfach an jedem Prüfpunkt.

Spezifische Migrationsaufgabe

Wenn Sie bereits wissen, was Sie migrieren möchten, überspringen Sie die Bewertung, und fahren Sie direkt mit der Ausführung fort:

copilot> migrate from local SQL Server to Azure SQL Database

Listen Sie diese für mehrere Aufgaben auf:

copilot> migrate from RabbitMQ to Azure Service Bus and upgrade to .NET 9

Unbeaufsichtigte Ausführung

Verwenden Sie für die vollständig autonome Ausführung ohne Aufforderungen das --allow-all Kennzeichen:

copilot --agent=github-copilot-modernization:modernize --allow-all

Enterprise-Playbook

Um Modernisierungsrichtlinien einzubetten, platzieren Sie Markdown-Dateien im .github/modernize/playbook/ Verzeichnis. Während der Planungsphase führen Playbook-Einschränkungen mit Bewertungsergebnissen zusammen – Playbook-Richtlinien haben Vorrang vor Bewertungsempfehlungen.

Weitere Informationen finden Sie unter Migrieren von .NET-Apps, um Azure mithilfe GitHub Copilot Modernisierung in Copilot CLI zu Azure.

Validation

Nachdem der Agent Codeänderungen angewendet hat, führt er Überprüfungen aus:

  1. Erstellt das Projekt und löst alle Buildfehler.
  2. Erkennt allgemeine Sicherheitsrisiken und Expositionen (CVEs) in Abhängigkeiten und behebt sie.
  3. Führt Tests aus und behebt fehler.

Nachdem alle Überprüfungen bestanden haben, generiert der Agent eine Zusammenfassung. Überprüfen Sie die Ergebnisse, und überprüfen Sie Folgendes:

dotnet build
dotnet test

Nächste Schritte

  • Last updated on