Cli-Befehle des GitHub Copilot-Modernisierungs-Agents

Der GitHub Copilot-Modernisierungs-Agent bietet interaktive und nicht interaktive Modi für die Anwendungsmodernisierung.

Befehlsmodi

Interaktiver Modus

Starten Sie die interaktive Text-Benutzeroberfläche (TUI) zur geführten Modernisierung:

modernize

Der interaktive Modus bietet Folgendes:

• Menügesteuerte Navigation über den Modernisierungsworkflow.
• Visuelle Plan- und Fortschrittsindikatoren.
• Geführte Eingabeaufforderungen für Konfigurationsoptionen.
• Multi-Repository-Auswahlschnittstelle.

Nicht interaktiver Modus

Führen Sie bestimmte Befehle direkt für Automatisierung und Skripting aus:

modernize <command> [options]

Verwenden Sie den nicht interaktiven Modus, wenn:

• Integration in CI/CD-Pipelines.
• Automatisieren von Batchvorgängen.
• Skript-Modernisierungsworkflows.
• Wird in headless Umgebungen ausgeführt.

Globale Optionen

Alle Befehle unterstützen diese globalen Optionen:

Befehle

Bewerten

Führt eine Bewertung aus und generiert einen umfassenden Analysebericht.

Syntax

modernize assess [options]

Options

Beispiele

Grundlegende Bewertung des aktuellen Verzeichnisses:

modernize assess

Bewerten mit benutzerdefiniertem Ausgabespeicherort:

modernize assess --output-path ./reports/assessment

Bewerten und Aktualisieren des GitHub-Problems mit Ergebnissen:

modernize assess --issue-url https://github.com/org/repo/issues/123

Bewerten eines bestimmten Projektverzeichnisses:

modernize assess --source /path/to/project

Bewerten mehrerer Repositorys im aktuellen Verzeichnis:

modernize assess  --multi-repo

Output

Die Bewertung generiert Folgendes:

• Berichtsdateien: Detaillierte Analyse in JSON-, MD- und HTML-Formaten.
• Zusammenfassung: Wichtige Ergebnisse und Empfehlungen.
• Problemaktualisierungen (wenn Sie bereitstellen --issue-url): GitHub-Problemkommentar mit Zusammenfassung.

Plan erstellen

Erstellt einen Modernisierungsplan basierend auf einer Aufforderung in natürlicher Sprache, die Ihre Modernisierungsziele beschreibt.

Syntax

modernize plan create <prompt> [options]

Argumente

Options

Beispiele

Generieren Eines Migrationsplans:

modernize plan create "migrate from oracle to azure postgresql"

Generieren Sie einen Upgradeplan mit benutzerdefiniertem Namen:

modernize plan create "upgrade to spring boot 3" --plan-name spring-boot-upgrade

Generieren Eines Bereitstellungsplans:

modernize plan create "deploy the app to azure container apps" --plan-name deploy-to-aca

Beispiel für vollständige Optionen:

modernize plan create "upgrade to .NET 8" \
    --source /path/to/project \
    --plan-name dotnet8-upgrade \
    --language dotnet \
    --issue-url https://github.com/org/repo/issues/456

Beispiele für Eingabeaufforderungen

Framework-Upgrades:

• upgrade to spring boot 3
• upgrade to .NET 10
• upgrade to JDK 21
• migrate from spring boot 2 to spring boot 3

Datenbankmigrationen:

• migrate from oracle to azure postgresql
• migrate from SQL Server to azure cosmos db
• switch from MySQL to azure database for mysql

Cloudmigrationen:

• migrate from on-premises to azure
• containerize and deploy to azure container apps
• migrate from rabbitmq to azure service bus

Einsatz:

• deploy to azure app service
• deploy to azure kubernetes service
• set up CI/CD pipeline for azure

Output

Der Befehl generiert Folgendes:

• Plandatei (.github/modernize/{plan-name}/plan.md): Detaillierte Modernisierungsstrategie, einschließlich:

  • Kontext und Ziele
  • Ansatz und Methodik
  • Klarstellungen

• Aufgabenliste (.github/modernize/{plan-name}/tasks.json): Strukturierte Aufschlüsselung ausführbarer Aufgaben mit:

  • Aufgabenbeschreibungen
  • Zu verwendende Fähigkeiten
  • Erfolgskriterien

Planausführung

Führt einen modernisierungsplan aus, der von modernize plan create.

Syntax

modernize plan execute [prompt] [options]

Argumente

Options

Beispiele

Führen Sie den neuesten Plan interaktiv aus:

modernize plan execute

Ausführen eines bestimmten Plans:

modernize plan execute --plan-name spring-boot-upgrade

Ausführen mit zusätzlichen Anweisungen:

modernize plan execute "skip the test" --plan-name spring-boot-upgrade

Wird im Headless-Modus für CI/CD ausgeführt:

modernize plan execute --plan-name spring-boot-upgrade --no-tty

Ausführungsverhalten

Während der Ausführung:

1. Lädt den Plan: Liest die Plan- und Aufgabenliste aus .github/modernization/{plan-name}/

2. Führt Aufgaben aus: Verarbeitet jede Aufgabe in der Aufgabenliste sequenziell:

   • Wendet Codetransformationen an.
   • Überprüft Builds nach Änderungen.
   • Sucht nach CVEs.
   • Führt Änderungen mit beschreibenden Nachrichten durch.

3. Generiert zusammenfassung: Stellt einen Bericht aller Änderungen und Ergebnisse bereit.

Output

• Commitverlauf: Detaillierte Commits für jede ausgeführte Aufgabe.
• Zusammenfassungsbericht: Übersicht über Änderungen, Erfolge und alle aufgetretenen Probleme.
• Buildüberprüfung: Bestätigung, dass die Anwendung erfolgreich erstellt wurde.
• CVE-Bericht: Sicherheitsrisiken identifiziert und behoben.

upgrade

Führt einen End-to-End-Upgrade-Workflow – Plan und Ausführung – in einem einzigen Befehl aus.

Syntax

modernize upgrade [prompt] [options]

Argumente

Options

Beispiele

Führen Sie die Ausführung upgrade im aktuellen Verzeichnis aus:

modernize upgrade "Java 17"

modernize upgrade ".NET 10"

Ausführen upgrade für ein bestimmtes Projekt:

modernize upgrade "Java 17" --source /path/to/project

Ausführen upgrade mithilfe des Cloud Coding-Agents:

modernize upgrade "Java 17" --delegate cloud

help

Stellt Hilfe- und Informationsbefehle bereit.

Syntax

modernize help [command]

Befehle

Beispiele

Verfügbare Modelle auflisten:

modernize help models

Konfigurieren der CLI

Mithilfe des Modernisierungs-Agents können Sie das Anwendungsverhalten über JSON-Dateien und Umgebungsvariablen anpassen.

Umgebungsvariablen

Legen Sie Umgebungsvariablen fest, um alle anderen Konfigurationsbereiche außer Kraft zu setzen:

Beispiel:

export MODERNIZE_LOG_LEVEL=debug
export MODERNIZE_MODEL=claude-sonnet-4.6
modernize assess

Benutzerkonfiguration

Speichern Sie benutzerspezifische Einstellungen in ~/.modernize/config.json oder repositoryweite Einstellungen in .github/modernize/config.json.

{
  "model": "claude-sonnet-4.6",
  "log_level": "info",
  "trusted_folders": [
    "/path/to/trusted/project",
  ]
}

Die trusted_folders Eigenschaft gibt die Ordner an, die für die Verwendung von LLM im interaktiven Modus vertrauenswürdig sind.

Konfiguration für mehrere Repositorys

Erstellen Sie eine .github/modernize/repos.json Datei, um den Modus für mehrere Repositorys zu aktivieren:

[
  {
    "name": "PhotoAlbum-Java",
    "url": "https://github.com/Azure-Samples/PhotoAlbum-Java.git"
  },
  {
    "name": "PhotoAlbum",
    "url": "https://github.com/Azure-Samples/PhotoAlbum.git"
  }
]

Nachdem die repos.json Datei vorhanden ist, verwenden Sie die folgenden Befehle, um in allen konfigurierten Repositorys zu arbeiten:

Bewerten aller Repositorys lokal:

modernize assess

Bewerten Sie alle Repositorys mithilfe des Cloud Coding-Agents:

modernize assess --delegate cloud

Aktualisieren Sie alle Repositorys mithilfe des Cloud Coding-Agents:

modernize upgrade --delegate cloud

Nächste Schritte

• Batchbewertung: Bewerten mehrerer Anwendungen
• Batchupgrade: Upgrade mehrerer Anwendungen
• Erstellen von benutzerdefinierten Fähigkeiten für Ihre Organisation
• Zurück zur Übersicht