Freigeben über


Schnellstart: Bewerten und Migrieren eines Java-Projekts mithilfe der GitHub Copilot-Modernisierung

In dieser Schnellstartanleitung erfahren Sie, wie Sie die GitHub Copilot-Modernisierung verwenden, um ein Java-Projekt zu bewerten und zu migrieren. In dieser Schnellstartanleitung installieren und konfigurieren Sie die Erweiterung, bewerten und migrieren ein Beispielprojekt. Sie verwenden beispielsweise eine vordefinierte Aufgabe, um eine Azure SQL-Datenbankverbindung zu aktualisieren, um Azure Managed Identity anstelle eines Benutzernamens und Kennworts zu verwenden.

Das folgende Video zeigt, wie die GitHub Copilot-Modernisierung AppCAT verwendet, um ein Java-Projekt für die Migration zu Azure zu bewerten:


Prerequisites

Hinweis

Wenn Sie Gradle verwenden, wird nur der Gradle-Wrapper, Version 5 oder höher, unterstützt. Die Kotlin Domain Specific Language (DSL) wird nicht unterstützt.

Aktualisieren von JDK- und Abhängigkeitsversionen

Sie können Ihre JDK-Version auf zwei Arten aktualisieren. Beide Möglichkeiten verwenden den GitHub Copilot-Modernisierungsbereich in Visual Studio Code, auf den Sie über die Randleiste zugreifen können.

Eine Möglichkeit zum Upgrade Ihrer JDK-Version ist die Auswahl von Upgrade runtime & Frameworks im QuickSTART-Abschnitt . Eine weitere Möglichkeit besteht darin, die Upgrade-Java-Runtime-Aufgabe im Abschnitt "TASKS - Upgrade Tasks " auszuführen. Weitere Informationen finden Sie in der Schnellstartanleitung: Upgrade eines Java-Projekts mit GitHub Copilot-Modernisierung.

Screenshot von Visual Studio Code, der den GitHub Copilot-Modernisierungsbereich mit hervorgehobenen Upgradeoptionen zeigt.

Um das Spring-Framework oder eine Abhängigkeit von Drittanbietern zu aktualisieren, führen Sie die Aufgabe "Java Framework aktualisieren" im Abschnitt "AUFGABEN – Upgradeaufgaben " aus. Weitere Informationen finden Sie unter Upgrade eines Java-Frameworks oder einer Abhängigkeit von Drittanbietern mithilfe der GitHub Copilot-Modernisierung.

Screenshot von Visual Studio Code, der den GitHub Copilot-Modernisierungsbereich mit hervorgehobener Aufgabe

Bewerten der Cloudbereitschaft

Führen Sie die folgenden Schritte aus, um ihren Migrationsprozess mit der Lösungsbewertung zu starten. Diese Bewertung hilft Ihnen, Ihre Herausforderungen bei der Cloudbereitschaft zu verstehen und wie wirkungsvoll sie sind. Außerdem werden empfohlene Lösungen bereitgestellt. Eine Lösungsempfehlung enthält Verweise zum Einrichten von Azure-Ressourcen, Hinzufügen von Konfigurationen und Vornehmen von Codeänderungen.

  1. Klonen Sie das Java-Migrations-Copilot-Beispiel-Repository , und sehen Sie sich dann den Quellzweig an.

  2. Öffnen Sie in Visual Studio Code den Projektordner mi-sql-public-demo im Beispiel-Repository.

  3. Wählen Sie auf der Randleiste den GitHub Copilot-Modernisierungsbereich und dann im SCHNELLSTART-Abschnitt "Bewertung starten" oder "Bewertungsdashboard öffnen" aus.

    Screenshot von Visual Studio Code, der den GitHub Copilot-Modernisierungsbereich mit hervorgehobener Schaltfläche

  4. Wählen Sie "Empfohlene Bewertung" aus, wählen Sie die Cloudbereitschaftsdomäne und dann "OK " aus, um die Bewertung zu starten.

  5. Nach Abschluss der Analyse öffnet der Modernisierungsbewerter den Bewertungsbericht und zeigt eine kategorisierte Ansicht der Probleme mit der Cloudbereitschaft an.

    Screenshot des Visual Studio Code-Bereichs, der den Bewertungsbericht anzeigt.

  6. Wenn Sie den Zusammenfassungsbericht überprüfen, können Sie in der Lösungsliste unter der Problemdatenbankmigration (Microsoft SQL) die Option "Zu Azure SQL-Datenbank migrieren" (Spring) auswählen. Wählen Sie dann "Aufgabe ausführen" aus, um zur Codekorrekturstufe zu wechseln.

    Screenshot des Bereichs

Prerequisites

Hinweis

Wenn Sie Gradle verwenden, wird nur der Gradle-Wrapper, Version 5 oder höher, unterstützt. Die Kotlin Domain Specific Language (DSL) wird nicht unterstützt.

Die Funktion My Tasks wird für IntelliJ IDEA noch nicht unterstützt.

Aktualisieren von JDK- und Abhängigkeitsversionen

Sie können Ihre JDK-Version auf zwei Arten aktualisieren. Beide Möglichkeiten verwenden den GitHub Copilot-Modernisierungsbereich in IntelliJ IDEA, auf den Sie über die Randleiste zugreifen können.

Eine Möglichkeit zum Upgrade Ihrer JDK-Version ist die Auswahl von Upgrade runtime & Frameworks im QuickSTART-Abschnitt . Eine weitere Möglichkeit besteht darin, die Upgrade-Java-Runtime-Aufgabe im Abschnitt "TASKS - Upgrade Tasks " auszuführen. Weitere Informationen finden Sie in der Schnellstartanleitung: Upgrade eines Java-Projekts mit GitHub Copilot-Modernisierung.

Screenshot des GitHub Copilot-Modernisierungsbereichs mit hervorgehobenen Upgradeoptionen.

Um das Spring-Framework oder eine Abhängigkeit von Drittanbietern zu aktualisieren, führen Sie die Aufgabe "Java Framework aktualisieren" im Abschnitt "AUFGABEN – Upgradeaufgaben " aus. Weitere Informationen finden Sie unter Upgrade eines Java-Frameworks oder einer Abhängigkeit von Drittanbietern mithilfe der GitHub Copilot-Modernisierung.

Screenshot des GitHub Copilot-Modernisierungsbereichs mit hervorgehobener Aufgabe

Bewerten der Cloudbereitschaft

Führen Sie die folgenden Schritte aus, um ihren Migrationsprozess mit der Lösungsbewertung zu starten. Diese Bewertung hilft Ihnen zu verstehen, was Ihre Herausforderungen bei der Cloudbereitschaft sind und wie wirkungsvoll sie sind. Außerdem werden empfohlene Lösungen bereitgestellt. Eine Lösungsempfehlung enthält Verweise zum Einrichten von Azure-Ressourcen, Hinzufügen von Konfigurationen und Vornehmen von Codeänderungen.

  1. Klonen Sie das Java-Migrations-Copilot-Beispiel-Repository und wechseln Sie dann zu dem Quellzweig.

  2. Öffnen Sie in IntelliJ IDEA den mi-sql-public-demo Projektordner im Beispiel-Repository.

  3. Wählen Sie auf der Randleiste den GitHub Copilot-Modernisierungsbereich aus, in dem Sie " Bewertung starten " oder " Bewertung ausführen " im Abschnitt "BEWERTUNG " auswählen können.

    Screenshot des GitHub Copilot-Modernisierungsbereichs mit hervorgehobenen Schaltflächen

  4. Das GitHub Copilot-Chatfenster mit agent-Modus wird geöffnet, um den Modernisierungsassessor aufzurufen, um die Modernisierungsbewertung auszuführen. Wählen Sie Weiter aus, um dies zu bestätigen.

  5. Der Modernisierungsbeurteiler öffnet sich nun appcat.log. Diese Datei zeigt die Protokolle für die Ausführung von AppCAT an, die die App-Bewertung durchführt. Wählen Sie "Weiter" , um die Bestätigung erneut zu bestätigen.

  6. Der Modernisierungsprüfer überprüft zuerst Ihre lokale Umgebung. Wenn appCAT und seine Abhängigkeiten nicht installiert sind, hilft ihnen der Agent bei der Installation. Nach der Installation ruft der Agent AppCAT auf, um das aktuelle Projekt zu bewerten. Dieser Schritt kann mehrere Minuten dauern.

  7. Nach Abschluss der Analyse erzeugt der Modernisierungsbewerter eine kategorisierte Ansicht von Cloudbereitschaftsproblemen in einem geöffneten Bewertungsbericht.

    Screenshot des Bewertungsberichts.

  8. Beim Überprüfen des Zusammenfassungsberichts können Sie in der Lösungsliste unter der Problemdatenbankmigration (Microsoft SQL) die Option "Zu Azure SQL-Datenbank migrieren" (Spring) auswählen. Wählen Sie dann "Aufgabe ausführen" aus, um zur Codekorrekturstufe zu wechseln.

    Screenshot der Option

Anwenden einer vordefinierten Aufgabe

Für die Migration stellt Copilot vordefinierte Aufgaben für häufige Migrationsszenarien bereit, denen Sie bei der Migration zu Azure möglicherweise begegnen. Beispielsweise wird durch die Verwendung des mi-sql-public-demo Beispiels bei der Aufgabe Datenbankmigration (Microsoft SQL) die Azure SQL-Datenbankverbindung so geändert, dass Azure Managed Identity anstelle eines Benutzernamens und Kennworts verwendet wird.

Führen Sie die folgenden Schritte aus, um eine vordefinierte Aufgabe anzuwenden:

  1. Wählen Sie im Bewertungsbericht die Option "Aufgabe ausführen" aus. Das Chatfenster "Copilot" wird geöffnet, wobei der Agentmodus ausgewählt ist.

  2. Der Copilot-Agent verwendet verschiedene Tools für die GitHub Copilot-Modernisierung, und jedes Tool erfordert möglicherweise eine Bestätigung, um fortzufahren. Der Agent generiert zuerst plan.md und progress.md. Sie können plan.md prüfen und dort bei Bedarf Änderungen vornehmen.

  3. Geben Sie continue manuell ein, um den Migrationsprozess zu bestätigen und zu starten.

  4. Bevor Codeänderungen vorgenommen werden, überprüft der Agent den Versionskontrollsystemstatus und checkt einen neuen Zweig für die Migration aus.

  5. 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 GitHub Copilot-Modernisierung standardmäßig den AppModernization benutzerdefinierten Agent mit Claude Sonnet 4.5, um optimale Ergebnisse beim Aktualisieren von Java-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 model Einstellung ä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

Nachdem Sie die Codeänderungen abgeschlossen haben, geben Sie continue manuell ein, um mit der Validierung und der Iterationsschleifenkorrektur fortzufahren. Diese Schleife enthält die folgenden fünf Teile:

  • Wenden Sie das Validate-CVEs Tool an. Dieses Tool versucht, allgemeine Sicherheitsrisiken und Expositionen (CVEs) in aktuellen Abhängigkeiten zu erkennen und zu beheben.
  • Wenden Sie das Build-Project Tool an. Dieses Tool versucht, Buildfehler zu beheben.
  • Wenden Sie das Consistency-Validation Tool an. Dieses Tool analysiert den Code auf funktionale Konsistenz.
  • Wenden Sie das Run-Test Tool an. Dieses Tool analysiert das Projekt auf Komponententestfehler und generiert automatisch einen Plan zur Behebung. Das Run-Test Tool führt iterativ Komponententests aus und behebt fehler.
  • Wenden Sie das Completeness-Validation Tool an. Dieses Tool erfasst Migrationselemente, die bei der anfänglichen Codemigration verpasst wurden, und behebt sie.

Nachdem alle Prozesse abgeschlossen sind, geben Sie fortfahren ein, um die Migrationszusammenfassung als letzten Schritt zu erzeugen. Überprüfen Sie die Codeänderungen, und bestätigen Sie sie, indem Sie "Beibehalten" auswählen.

Generieren von Komponententestfällen

Führen Sie die folgenden Schritte aus, um Komponententestfälle zu generieren:

  1. Wählen Sie auf der Randleiste den GitHub Copilot-Modernisierungsbereich aus.

  2. Öffnen Sie im Abschnitt AUFGABENQualitäts- und Sicherheitsaufgaben, und wählen Sie dann " Komponententestfälle generieren" aus.

Der Agent generiert Komponententests und erstellt einen TestReport , um Testergebnisse vor und nach der Generation anzuzeigen. Weitere Informationen finden Sie in der Schnellstartanleitung: Generieren von Komponententests mit GitHub Copilot-Modernisierung.

Nächste Schritte