Compartir a través de

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 Copilot de GitHub y su uso para modernizar una aplicación de ejemplo.

Prerrequisitos

  • Una suscripción a GitHub Copilot: plan Gratis, Pro, Pro+, Empresa o Enterprise. Consulta los planes de Copilot.
  • CLI de GitHub: instale la CLI de GitHub (gh) para la autenticación. 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.

En PowerShell, ejecute el siguiente comando:

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

Como alternativa, descargue y ejecute el instalador msi desde la página de versiones de GitHub.

Nota:

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:

○ 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

Paso 1: Evaluación de la aplicación

  1. Seleccione 1. Evaluar la aplicación.
  2. Siga las indicaciones para configurar las opciones de evaluación (o presione Entrar para usar los valores predeterminados).
  3. Revise las selecciones y presione Entrar para iniciar la evaluación.
  4. 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

¡Valoramos su entrada! 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 de GitHub Copilot.

  • Last updated on