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 :

○ What would you like to do?

  > Assess        Analyze your source application and generate an assessment report
    Plan          Create a modernization plan based on assessment findings
    Execute       Run tasks defined in your modernization plan
  ──────────────
    Upgrade       Upgrade your runtime and frameworks to the latest versions

É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. 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.
  4. Sélectionnez des domaines d’évaluation, tels que Java mise à niveau et Cloud Readiness, puis appuyez sur Enter.
  5. 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.
  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. Entrez un nom de plan ou appuyez sur Entrée pour utiliser le nom par défaut.
  3. Entrez votre objectif de modernisation en tant qu’invite. Par défaut, l'invite est References the assessment summary and creates plan 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
  4. Appuyez sur Entrée pour générer le plan.

L’agent analyse votre codebase et génère les éléments suivants :

  • Fichier de plan (.github/modernize/{plan-name}/plan.md) : stratégie et approche détaillées.
  • Liste des tâches (.github/modernize/{plan-name}/tasks.json) : répartition des étapes exécutables.

Conseil / Astuce

Vous pouvez modifier plan.md manuellement pour ajouter des clarifications ou ajuster les détails. Vous pouvez également effectuer une mise à jour tasks.json pour modifier, réorganiser, ajouter ou supprimer des tâches avant d’exécuter le plan.

É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

Votre entrée est importante ! Si vous avez des commentaires sur l’agent de modernisation, créez un problème au niveau du dépôt github-copilot-appmod ou utilisez le formulaire de commentaires de modernisation GitHub Copilot.

  • Last updated on