Partager via

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 De GitHub Copilot et de son utilisation pour moderniser un exemple d’application.

Prerequisites

  • Un abonnement GitHub Copilot : Gratuit, Pro, Pro+, Business ou Enterprise. Consultez Plans Copilot.
  • Interface CLI GitHub : installez l’interface CLI GitHub (gh) pour l’authentification. Consultez Installation de gh.

Plateforme requise

  • Windows : x64 ou ARM64.
  • Linux : x64 ou ARM64 avec glibc la version 2.27 ou 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.

Exécutez la commande suivante dans PowerShell :

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

Vous pouvez également télécharger et exécuter le programme d’installation MSI à partir de la page des versions gitHub.

Note

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 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

Étape 1 : Évaluer l’application

  1. Sélectionnez 1. Évaluer l’application.
  2. Suivez les invites pour configurer les options d’évaluation (ou appuyez sur Entrée pour utiliser les valeurs par défaut).
  3. Passez en revue vos sélections et appuyez sur Entrée pour démarrer l’évaluation.
  4. 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

Nous apprécions vos commentaires ! Si vous avez des commentaires sur l’agent de modernisation, créez un problème dans le dépôt github-copilot-appmod ou utilisez le formulaire de commentaires de modernisation de GitHub Copilot.

  • Last updated on