Schnellstart: Installieren und Verwenden des GitHub Copilot-Modernisierungs-Agents

Diese Schnellstartanleitung führt Sie durch die Installation des GitHub Copilot-Modernisierungs-Agents und dessen Verwendung zum Modernisieren einer Beispielanwendung.

Voraussetzungen

• Ein GitHub Copilot-Abonnement: Kostenloser, Pro-, Pro+-, Business- oder Enterprise-Plan. Weitere Informationen findest du unter Copilot-Pläne.
• GitHub CLI: Installieren Sie die GitHub CLI (gh) für die Authentifizierung v2.45.0 oder höher. Siehe Installieren von GH.

Plattformanforderungen

• Windows: x64 oder ARM64.
• Linux: x64 oder ARM64 mit glibc 2.27 oder höher (Ubuntu 18.04 oder höher, Debian 10 oder höher, Fedora 29 oder höher, Azure Linux 2.0 oder höher).
• macOS: Apple Silicon oder Intel.

Installieren Sie den Modernisierungsagenten

Verwenden Sie die folgenden Befehle, um den Modernisierungs-Agent zu installieren oder auf die neueste Version zu aktualisieren.

winget install GitHub.Copilot.modernization.agent

winget install GitHub.Copilot.modernization.agent --silent

iex (irm 'https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.ps1')

brew tap microsoft/modernize https://github.com/microsoft/modernize-cli
brew install modernize

curl -fsSL https://raw.githubusercontent.com/microsoft/modernize-cli/main/scripts/install.sh | bash

Überprüfen Sie die Installation:

modernize --version

Eine Beispielanwendung abrufen

Verwenden Sie für diese Schnellstartanleitung eine Beispielanwendung. Wählen Sie entweder Java oder .NET aus:

git clone https://github.com/Azure-Samples/PhotoAlbum-Java.git
cd PhotoAlbum-Java
git checkout -b modernize

git clone https://github.com/Azure-Samples/PhotoAlbum.git
cd PhotoAlbum
git checkout -b modernize

Verwenden des interaktiven Modus

Am einfachsten können Sie loslegen, indem Sie den interaktiven Modus verwenden. Authentifizieren Sie zunächst mithilfe der GitHub CLI:

gh auth login

Führen Sie dann den Modernisierungs-Agent aus:

modernize

Das Hauptmenü wird angezeigt:

○ How would you like to modernize your Java app?

  > 1. Assess application
       Analyze the project and identify modernization opportunities
    2. Create modernization plan
       Generate a structured plan to guide the agent
    3. Execute modernization plan
       Run the tasks defined in the modernization plan

Schritt 1: Bewerten der Anwendung

1. Wählen Sie 1. Anwendung bewerten.
2. Folgen Sie den Anweisungen zum Konfigurieren von Bewertungsoptionen (oder drücken Sie die EINGABETASTE, um Standardwerte zu verwenden).
3. Überprüfen Sie Ihre Auswahl, und drücken Sie die EINGABETASTE, um die Bewertung zu starten.
4. Warten Sie, bis die Bewertung abgeschlossen ist.

Die Auswertungsergebnisse werden in Ihrem Projektverzeichnis unter .github\modernize\assessment\ gespeichert. Der Agent analysiert Ihren Code, Ihre Abhängigkeiten und Konfiguration, um Folgendes zu identifizieren:

• Veraltete Frameworkversionen
• Veraltete APIs
• Probleme mit der Cloudkompatibilität
• Migrationschancen

Schritt 2: Erstellen eines Modernisierungsplans

Nach Abschluss der Bewertung fordert der Agent Sie auf, basierend auf den identifizierten Problemen einen Modernisierungsplan zu erstellen:

○ How would you like to continue?

  > 1. Create modernization plan
       Generate a plan.md file according to the identified issues
    2. Return to main menu

1. Wählen Sie "1" aus. Erstellen Sie einen Modernisierungsplan.
2. Geben Sie einen Plannamen ein, oder drücken Sie die EINGABETASTE, um den Standardnamen zu verwenden.
3. Geben Sie Ihr Modernisierungsziel als Eingabeaufforderung ein. Standardmäßig besteht References the assessment summary and creates plan die Aufforderung darin, einen Plan basierend auf den Bewertungsergebnissen zu erstellen. Sie können sie durch jede andere Migrationsanforderung ersetzen, z. B.:
   • migrate the database to Azure PostgreSQL
   • upgrade to Spring Boot 3
   • deploy to Azure Container Apps
4. Drücken Sie die EINGABETASTE, um den Plan zu generieren.

Der Agent analysiert Ihre Codebasis und generiert Folgendes:

• Plandatei (.github/modernize/{plan-name}/plan.md): Detaillierte Strategie und Vorgehensweise.
• Aufgabenliste (.github/modernize/{plan-name}/tasks.json): Aufschlüsselung der ausführbaren Schritte.

Schritt 3: Ausführen des Modernisierungsplans

Nachdem Sie den Plan überprüft haben, vergewissern Sie sich, dass Sie den Plan ausführen möchten.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu

1. Wählen Sie "1" aus. Führen Sie den Modernisierungsplan aus.
2. Drücken Sie die EINGABETASTE, um den Plan auszuführen.
3. Überwachen des Fortschritts, wenn der Agent Änderungen anwendet.

Der Agent führt jede Aufgabe in der folgenden Reihenfolge aus:

• Nimmt Codeänderungen gemäß dem Plan vor.
• Überprüft Builds nach jeder Änderung.
• Sucht nach CVEs und adressiert sie.
• Änderungen festschreiben.

Schritt 4: Überprüfen der Ergebnisse

Nach Abschluss der Ausführung können Sie alle Änderungen überprüfen, die der Agent vor dem Zusammenführen vorgenommen hat:

1. Änderungen überprüfen: Überprüfen Sie die Änderungen in der aktuellen Verzweigung.

   git status
   git diff main
   

2. Erstellen Sie eine Pull Request: Wenn Sie mit den Änderungen zufrieden sind, erstellen Sie eine PR zur Überprüfung durch das Team.

   gh pr create \
       --title "Modernization: migrate the app to azure" \
       --body "Automated modernization by GitHub Copilot agent"
   

Nächste Schritte

• Erfahren Sie mehr über CLI
• Batchbewertung: Bewertung mehrerer Applikationen
• Batchupgrade: Upgrade mehrerer Anwendungen
• Erstellen von benutzerdefinierten Fähigkeiten für Ihre Organisation

Feedback geben

Wir schätzen Ihre Eingabe! Wenn Sie Feedback zum Modernisierungs-Agent haben, erstellen Sie ein Problem im Github-copilot-appmod-Repository , oder verwenden Sie das GitHub Copilot Modernisierungsfeedback-Formular.