Démarrage rapide : Installer et utiliser l’agent de modernisation GitHub Copilot

Ce guide de démarrage rapide vous guide tout au long de l’installation de l’agent de modernisation GitHub Copilot et de son utilisation pour moderniser un exemple d’application.

Prerequisites

  • abonnement GitHub Copilot : Gratuit, Pro, Pro+, Business ou Enterprise. Consultez Copilot plans.
  • GitHub CLI : installez l’interface CLI GitHub (gh) pour l’authentification, la version v2.45.0 ou une version ultérieure. Consultez Installation de gh.

Plateforme requise

  • Windows : x64 ou ARM64.
  • Linux : x64 ou ARM64 avec glibc 2.27 ou version ultérieure (Ubuntu 18.04 ou version ultérieure, Debian 10 ou version ultérieure, Fedora 29 ou version ultérieure, Azure Linux 2.0 ou version ultérieure).
  • macOS : Apple Silicon ou Intel.

Installer l’agent de modernisation

Utilisez les commandes suivantes pour installer l’agent de modernisation ou effectuer une mise à jour vers la dernière version.

Utilisez l’une des options suivantes :

Option 1 - Winget (recommandé) :

winget install GitHub.Copilot.modernization.agent

Pour une installation silencieuse sans invite :

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

Option 2 - PowerShell one-liner :

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

Option 3 - Programme d’installation MSI :

Téléchargez et exécutez la dernière msi à partir de la page des versions GitHub.

Note

Après l’installation, ouvrez un nouveau terminal pour que la modernize commande soit disponible sur votre chemin d’accès. Ces commandes fonctionnent à la fois pour l’installation initiale et la mise à jour vers la dernière version. Une commande de mise à jour de version dédiée sera disponible dans une prochaine version.

Vérifiez l’installation :

modernize --version

Obtenir un exemple d’application

Pour ce guide de démarrage rapide, utilisez un exemple d’application. Choisissez Java ou .NET :

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

Utiliser le mode interactif

Le moyen le plus simple de commencer consiste à utiliser le mode interactif. Tout d’abord, authentifiez-vous à l’aide de l’interface CLI GitHub :

gh auth login

Ensuite, lancez l'agent de modernisation :

modernize

Le menu principal s’affiche :

○ How would you like to modernize your app?

  > Assess
    Analyze modernization readiness across one or multiple applications
    Plan
    Generate a structured plan to guide the agent
    Execute
    Run the tasks defined in the modernization plan

  Or select a quick-start scenario:

    Upgrade
    Upgrade runtimes and frameworks across one or multiple applications

Étape 1 : Évaluer l’application

  1. Sélectionnez Évaluer dans le menu principal.
  2. Choisissez comment spécifier vos référentiels cibles. Vous pouvez sélectionner le dossier actuel pour utiliser votre répertoire actuel, l’entrée manuelle pour entrer des chemins d’accès locaux ou des URL Git distantes, ou à partir d’un fichier de configuration pour charger des dépôts à partir d’un fichier de configuration JSON. Pour ce guide de démarrage rapide, sélectionnez Dossier actif.
  3. Sélectionnez des domaines d’évaluation, tels que Java mise à niveau et Cloud Readiness, puis appuyez sur Enter.
  4. Passez en revue les options de configuration de l’évaluation, telles que la couverture d’analyse et le runtime cible. Appuyez sur Entrée sur Continuer pour accepter les valeurs par défaut recommandées ou ajuster les paramètres individuels si nécessaire.
  5. Choisissez le mode d’exécution. Sélectionnez Évaluer localement pour exécuter l’évaluation sur votre ordinateur ou déléguer à des agents cloud pour permettre aux agents cloud d’exécuter l’évaluation en parallèle. Pour ce guide de démarrage rapide, sélectionnez Évaluer localement.
  6. Acceptez le chemin de sortie par défaut ou entrez un chemin personnalisé, puis appuyez sur Entrée pour démarrer l’évaluation.
  7. Attendez que l’évaluation se termine.

Les résultats de l’évaluation sont enregistrés dans .github\modernize\assessment\ dans votre répertoire de projet. L’agent analyse votre code, vos dépendances et votre configuration pour identifier :

  • Versions obsolètes du framework
  • API dépréciées
  • Problèmes de compatibilité cloud
  • Opportunités de migration

Étape 2 : Créer un plan de modernisation

Une fois l’évaluation terminée, l’agent vous invite à créer un plan de modernisation en fonction des problèmes identifiés :

○ 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. Sélectionnez 1. Créer un plan de modernisation.
  2. Sélectionnez 1. Conservez le plan local pour générer le plan sur votre ordinateur, ou choisissez 2. Envoyez-le à l’agent cloud pour qu’un agent cloud le génère. L’option 2 est expérimentale.
  3. Le rapport d’évaluation nouvellement créé est sélectionné par défaut pour générer le plan. Sélectionnez 1. Aucun rapport si vous souhaitez décrire vos exigences spécifiques à la place.
  4. Entrez un nom de plan ou appuyez sur Entrée pour utiliser le nom par défaut.
  5. Entrez votre objectif de modernisation en tant qu’invite. Par défaut, l'invite est Based on the assessment report, upgrade the project and migrate to Azure pour créer un plan en fonction des résultats de l’évaluation. Vous pouvez le remplacer par toute autre demande de migration, par exemple :
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  6. Appuyez sur Entrée pour générer le plan.
  7. L’agent analyse votre codebase et vous demande de clarifier la demande. Vous pouvez sélectionner une réponse suggérée ou taper votre propre réponse.

L’agent agrège toutes les informations et génère :

  • Fichier de plan (.github/modernize/{plan-name}/plan.md) : stratégie et approche détaillées.

Conseil / Astuce

Vous pouvez modifier plan.md manuellement pour ajouter des clarifications ou ajuster les détails.

Étape 3 : Exécuter le plan de modernisation

Après avoir vérifié le plan, vérifiez que vous souhaitez exécuter le plan.

○ How would you like to continue?

  > 1. Execute modernization plan
       Run the tasks defined in the modernization plan
    2. Return to main menu
  1. Sélectionnez 1. Exécuter le plan de modernisation.
  2. Appuyez sur Entrée pour exécuter le plan.
  3. Surveillez la progression à mesure que l’agent applique les modifications.

L’agent exécute chaque tâche dans l’ordre :

  • Apporte des modifications de code en fonction du plan.
  • Valide les builds après chaque modification.
  • Identifie et corrige les CVE.
  • Valide les modifications.

Étape 4 : Passer en revue les résultats

Une fois l’exécution terminée, vous pouvez passer en revue toutes les modifications apportées par l’agent avant de les fusionner :

  1. Passer en revue les modifications : vérifiez les modifications sur la branche actuelle.

    git status
git diff main

  2. Créer une pull request : Si vous êtes satisfait des modifications, créez une pull request pour l’examen de l’équipe.

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

Étapes suivantes

Fournir des commentaires

Vos commentaires aident à améliorer l’agent de modernisation. Pour envoyer des commentaires à partir du TUI Moderniser, appuyez sur F.

GitHub Copilot modernization v1.0.0
GitHub Copilot modernization is AI-powered and may not always be accurate.

GitHub account: <username>
Copilot CLI version: 1.0.0
Model: Claude Sonnet 4.5 (1x) · M Select model · F Feedback

Vous pouvez également créer un problème dans le dépôt github-copilot-appmod ou utiliser le formulaire de commentaires de modernisation GitHub Copilot.

  • Last updated on