Inicio rápido: Instalación y uso del agente de modernización de GitHub Copilot

Este inicio rápido le guía a través de la instalación del agente de modernización de GitHub Copilot y su uso para modernizar una aplicación de ejemplo.

Prerrequisitos

  • Una suscripción a GitHub Copilot: Plan Gratis, Pro, Pro+, Business o Enterprise. Consulte Copilot plans.
  • GitHub CLI: instale la CLI de GitHub (gh) para la autenticación, versión v2.45.0 o posterior. Consulte Instalación de gh.

Requisitos de la plataforma

  • Windows: x64 o ARM64.
  • Linux: x64 o ARM64 con glibc 2.27 o posterior (Ubuntu 18.04 o posterior, Debian 10 o posterior, Fedora 29 o posterior, Azure Linux 2.0 o posterior).
  • macOS: Apple Silicon o Intel.

Instalación del agente de modernización

Use los siguientes comandos para instalar el agente de modernización o actualizar a la versión más reciente.

Use una de las siguientes opciones:

Opción 1 - Winget (recomendado):

winget install GitHub.Copilot.modernization.agent

Para la instalación silenciosa sin avisos:

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

Opción 2: un comando PowerShell en una sola línea:

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

Opción 3- Instalador MSI:

Descargue y ejecute el MSI más reciente desde la página de versiones de GitHub.

Nota:

Después de la instalación, abra un nuevo terminal para que el modernize comando esté disponible en path. Estos comandos funcionan tanto para la instalación inicial como para la actualización a la versión más reciente. Un comando de actualización de versión dedicada estará disponible en una versión futura.

Compruebe la instalación:

modernize --version

Obtención de una aplicación de ejemplo

Para este inicio rápido, use una aplicación de ejemplo. Elija Java o .NET:

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

Usar el modo interactivo

La manera más fácil de empezar es usar el modo interactivo. En primer lugar, autentíquese mediante la CLI de GitHub:

gh auth login

A continuación, ejecute el agente de modernización:

modernize

Aparece el menú principal:

○ 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

Paso 1: Evaluación de la aplicación

  1. Seleccione Evaluar en el menú principal.
  2. Elija cómo especificar los repositorios de destino. Puede seleccionar Carpeta actual para usar el directorio actual, Entrada manual para escribir rutas de acceso locales o direcciones URL de Git remotas o Desde un archivo de configuración para cargar repositorios desde un archivo de configuración JSON. Para este inicio rápido, seleccione Carpeta actual.
  3. Elija el modo de ejecución. Seleccione Evaluar localmente para ejecutar la evaluación en el equipo o Delegar en Agentes en la nube para permitir que los agentes en la nube ejecuten la evaluación en paralelo. Para este inicio rápido, seleccione Evaluar localmente.
  4. Seleccione dominios de evaluación, como Java upgrade y Cloud Readiness y presione Enter.
  5. Revise las opciones de configuración de evaluación, como Cobertura de análisis y Entorno de ejecución objetivo. Presione Entrar en Continuar para aceptar los valores predeterminados recomendados o ajustar la configuración individual según sea necesario.
  6. Acepte la ruta de acceso de salida predeterminada o escriba una personalizada y presione Entrar para iniciar la evaluación.
  7. Espere a que se complete la evaluación.

Los resultados de la evaluación se guardan .github\modernize\assessment\ en el directorio del proyecto. El agente analiza el código, las dependencias y la configuración para identificar:

  • Versiones de marco obsoletas
  • API obsoletas
  • Problemas de compatibilidad en la nube
  • Oportunidades de migración

Paso 2: Crear un plan de modernización

Una vez finalizada la evaluación, el agente le pide que cree un plan de modernización en función de los problemas identificados:

○ 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. Seleccione 1. Cree un plan de modernización.
  2. Escriba un nombre de plan o presione Entrar para usar el nombre predeterminado.
  3. Escriba el objetivo de modernización como mensaje. De forma predeterminada, la solicitud consiste References the assessment summary and creates plan en crear un plan en función de los resultados de la evaluación. Puede reemplazarlo por cualquier otra solicitud de migración, por ejemplo:
    • migrate the database to Azure PostgreSQL
    • upgrade to Spring Boot 3
    • deploy to Azure Container Apps
  4. Presione Enter para generar el plan.

El agente analiza el código base y genera:

  • Archivo de plan (.github/modernize/{plan-name}/plan.md): estrategia y enfoque detallados.
  • Lista de tareas (.github/modernize/{plan-name}/tasks.json): desglose de los pasos ejecutables.

Sugerencia

Puede editar plan.md manualmente para agregar aclaraciones o ajustar los detalles. También puede actualizar tasks.json para modificar, reordenar, agregar o quitar tareas antes de ejecutar el plan.

Paso 3: Ejecutar el plan de modernización

Después de comprobar el plan, confirme que desea ejecutar el 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. Seleccione 1. Ejecute el plan de modernización.
  2. Presione Entrar para ejecutar el plan.
  3. Supervise el progreso a medida que el agente aplique los cambios.

El agente ejecuta cada tarea en orden:

  • Realiza cambios en el código según el plan.
  • Valida las compilaciones después de cada cambio.
  • Escanea y soluciona los CVE.
  • Confirma los cambios.

Paso 4: Revisar los resultados

Una vez finalizada la ejecución, puede revisar todos los cambios realizados por el agente antes de combinarlos:

  1. Revisar los cambios: Compruebe las modificaciones de la rama actual.

    git status
git diff main

  2. Cree una solicitud de incorporación de cambios: si está satisfecho con los cambios, cree una solicitud de incorporación de cambios para la revisión del equipo.

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

Pasos siguientes

Enviar comentarios

¡Tu opinión es importante! Si tiene algún comentario sobre el agente de modernización, cree un problema en el repositorio github-copilot-appmod o use el formulario de comentarios de modernización GitHub Copilot.

  • Last updated on