Comandi dell'interfaccia della riga di comando dell'agente di modernizzazione di GitHub Copilot

L'agente di modernizzazione copilot di GitHub offre modalità interattive e non interattive per la modernizzazione delle applicazioni.

Modalità di comando

Modalità interattiva

Avviare l'interfaccia utente testo interattiva (TUI) per la modernizzazione guidata:

modernize

La modalità interattiva offre:

• Spostamento basato su menu tramite il flusso di lavoro di modernizzazione.
• Indicatori di piano visivo e di avanzamento.
• Richieste guidate per le opzioni di configurazione.
• Interfaccia di selezione multi-repository.

Modalità non interattiva

Eseguire comandi specifici direttamente per l'automazione e lo scripting:

modernize <command> [options]

Usare la modalità non interattiva quando:

• Integrazione con pipeline CI/CD.
• Automazione delle operazioni batch.
• Creare script per i flussi di lavoro di modernizzazione.
• Esecuzione in ambienti headless.

Opzioni globali

Tutti i comandi supportano queste opzioni globali:

Comandi

Valutare

Esegue una valutazione e genera un report di analisi completo.

Sintassi

modernize assess [options]

Options

Examples

Valutazione di base della directory corrente:

modernize assess

Valutare con la posizione di output personalizzata:

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

Valutare e aggiornare il problema di GitHub con i risultati:

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

Valutare una directory di progetto specifica:

modernize assess --source /path/to/project

Valutare più repository nella directory corrente:

modernize assess  --multi-repo

Risultato

La valutazione genera:

• File di report: analisi dettagliata in formati JSON, MD e HTML.
• Riepilogo: risultati chiave e raccomandazioni.
• Aggiornare i problemi (se si specifica --issue-url): commento sul problema di GitHub con riepilogo.

plan create

Crea un piano di modernizzazione basato su una richiesta di linguaggio naturale che descrive gli obiettivi di modernizzazione.

Sintassi

modernize plan create <prompt> [options]

Arguments

Options

Examples

Generare un piano di migrazione:

modernize plan create "migrate from oracle to azure postgresql"

Generare un piano di aggiornamento con il nome personalizzato:

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

Generare un piano di distribuzione:

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

Esempio di opzioni complete:

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

Esempi di prompt

Aggiornamenti del framework:

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

Migrazioni di database:

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

Migrazioni cloud:

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

Spiegamento:

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

Risultato

Il comando genera:

• File di piano (.github/modernize/{plan-name}/plan.md): strategia di modernizzazione dettagliata, tra cui:

  • Contesto e obiettivi
  • Approccio e metodologia
  • Chiarimenti

• Elenco attività (.github/modernize/{plan-name}/tasks.json): suddivisione strutturata delle attività eseguibili con:

  • Descrizioni delle attività
  • Competenze da usare
  • Criteri di esito positivo

pianificare l'esecuzione

Esegue un piano di modernizzazione creato da modernize plan create.

Sintassi

modernize plan execute [prompt] [options]

Arguments

Options

Examples

Eseguire il piano più recente in modo interattivo:

modernize plan execute

Eseguire un piano specifico:

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

Eseguire con istruzioni aggiuntive:

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

Eseguire in modalità headless per CI/CD:

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

Comportamento di esecuzione

Durante l'esecuzione, l'agente:

1. Carica il piano: legge il piano e l'elenco di attività da .github/modernization/{plan-name}/

2. Esegue attività: elabora ogni attività nell'elenco di attività in sequenza:

   • Applica trasformazioni del codice.
   • Convalida le compilazioni dopo le modifiche.
   • Esegue l'analisi delle cve.
   • Esegue il commit delle modifiche con messaggi descrittivi.

3. Genera riepilogo: fornisce un report di tutte le modifiche e i risultati.

Risultato

• Cronologia commit: commit dettagliati per ogni attività eseguita.
• Report riepilogo: panoramica delle modifiche, delle operazioni riuscite e degli eventuali problemi riscontrati.
• Convalida della compilazione: conferma che l'applicazione viene compilata correttamente.
• Report CVE: vulnerabilità di sicurezza identificate e risolte.

aggiornamento di a

Esegue un flusso di lavoro di aggiornamento end-to-end, ovvero piano ed esecuzione, in un singolo comando.

Sintassi

modernize upgrade [prompt] [options]

Arguments

Options

Examples

Eseguire upgrade nella directory corrente:

modernize upgrade "Java 17"

modernize upgrade ".NET 10"

Esecuzione upgrade in un progetto specifico:

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

Eseguire upgrade usando l'agente di codifica cloud:

modernize upgrade "Java 17" --delegate cloud

help

Fornisce comandi della Guida e delle informazioni.

Sintassi

modernize help [command]

Comandi

Examples

Elencare i modelli disponibili:

modernize help models

Configurare l'interfaccia della riga di comando

Usando l'agente di modernizzazione, è possibile personalizzare il comportamento dell'applicazione tramite file JSON e variabili di ambiente.

Variabili di ambiente

Impostare le variabili di ambiente per eseguire l'override di tutti gli altri ambiti di configurazione:

Esempio:

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

Configurazioni degli utenti

Archiviare le preferenze specifiche dell'utente nelle ~/.modernize/config.json impostazioni a livello di repository o in .github/modernize/config.json.

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

La trusted_folders proprietà specifica le cartelle attendibili per l'uso di LLM in modalità interattiva.

Configurazione multi-repository

Creare un .github/modernize/repos.json file per abilitare la modalità multi-repository:

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

Al termine del repos.json file, usare i comandi seguenti per operare in tutti i repository configurati:

Valutare tutti i repository in locale:

modernize assess

Valutare tutti i repository usando l'agente di codifica cloud:

modernize assess --delegate cloud

Aggiornare tutti i repository usando l'agente di codifica cloud:

modernize upgrade --delegate cloud

Passaggi successivi

• Valutazione batch: valutare più applicazioni
• Aggiornamento batch: aggiornare più applicazioni
• Creare competenze personalizzate per l'organizzazione
• Torna alla panoramica