Inicio rápido: Evaluación y migración de un proyecto de Java mediante la modernización de aplicaciones de GitHub Copilot

En este inicio rápido se muestra cómo usar la modernización de aplicaciones de GitHub Copilot para evaluar y migrar un proyecto de Java. En este inicio rápido, instalará y configurará la extensión y, a continuación, evaluará y migrará un proyecto de ejemplo. Por ejemplo, se usa una tarea predefinida para actualizar una conexión de base de datos de Azure SQL para usar la identidad administrada de Azure en lugar de un nombre de usuario y una contraseña.

En el vídeo siguiente se muestra cómo la modernización de aplicaciones de Copilot de GitHub usa AppCAT para ayudar a evaluar un proyecto de Java para la migración a Azure:

Prerequisites

• Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.

• Una cuenta de GitHub con una suscripción activa de GitHub Copilot en cualquier plan.
• Uno de los siguientes IDEs:
  • Versión más reciente de Visual Studio Code. Debe ser la versión 1.101 o posterior.
    • GitHub Copilot en Visual Studio Code. Para obtener instrucciones de configuración, consulte Configuración de GitHub Copilot en Visual Studio Code. Asegúrese de iniciar sesión en su cuenta de GitHub en Visual Studio Code.
    • Modernización de aplicaciones de Copilot de GitHub. Reinicie Visual Studio Code después de la instalación.
  • La versión más reciente de IntelliJ IDEA. Debe ser la versión 2023.3 o posterior.
    • GitHub Copilot. Debe ser la versión 1.5.59 o posterior. Para obtener más instrucciones, consulte Configuración de GitHub Copilot en IntelliJ IDEA. Asegúrese de iniciar sesión en su cuenta de GitHub en IntelliJ IDEA.
    • Modernización de aplicaciones de Copilot de GitHub. Reinicie IntelliJ IDEA después de la instalación. Si no tiene instalado GitHub Copilot, puede instalar directamente la modernización de la aplicación de GitHub Copilot.
• Java 21 o posterior.
• Maven o Gradle para compilar proyectos de Java.

Nota:

Si usa Gradle, solo se admite la versión 5+ del contenedor de Gradle. No se admite el lenguaje específico del dominio de Kotlin (DSL).

La función My Tasks aún no se admite para IntelliJ IDEA.

Actualización de JDK y versiones de dependencia

Hay dos maneras de actualizar la versión de JDK. Ambas maneras usan el panel de modernización de aplicaciones de Copilot de GitHub en Visual Studio Code, al que puede acceder desde la barra lateral.

Una manera de actualizar la versión de JDK es seleccionar Upgrade Runtime & Frameworks en la sección QUICKSTART . Otra manera es ejecutar la tarea Tiempo de ejecución de Java actualizado en la sección TASKS - Upgrade Tasks ( Tareas de actualización). Para obtener más información, consulte Inicio rápido: Actualización de un proyecto de Java con modernización de aplicaciones de GitHub Copilot.

Para actualizar spring framework o una dependencia de terceros, ejecute la tarea Actualizar Java Framework en la sección TAREAS: Actualizar tareas . Para obtener más información, consulte Actualizar un marco de Java o una dependencia de terceros mediante la modernización de aplicaciones con GitHub Copilot.

Evaluación de la preparación para la nube

Siga estos pasos para iniciar el proceso de migración con la evaluación de la solución. Esta evaluación le ayuda a comprender cuáles son los desafíos de preparación de la nube y su impacto. También proporciona soluciones recomendadas. Una recomendación de solución incluye referencias para configurar recursos de Azure, agregar configuraciones y realizar cambios en el código.

1. Clone el repositorio de ejemplos de copilot de migración de Java y, a continuación, cambie a la rama source.

2. En Visual Studio Code, abra la carpeta del proyecto mi-sql-public-demo en el repositorio de ejemplos.

3. En la barra lateral, seleccione el panel de modernización de aplicaciones de GitHub Copilot , donde puede seleccionar Migrar a Azure o Ejecutar evaluación en la sección EVALUACIÓN .

   

4. Se abre la ventana de chat de GitHub Copilot con el modo de agente para llamar al evaluador de modernización para ejecutar la evaluación de modernización de la aplicación. Seleccione Continuar para confirmar.

5. El evaluador de modernización ahora abre appcat.log. Este archivo muestra los registros para ejecutar AppCAT, que realiza la evaluación de la aplicación. Seleccione Continuar para confirmar de nuevo.

6. El evaluador de modernización comprueba primero el entorno local. Si appCAT y sus dependencias no están instaladas, el agente le ayuda a instalarlas. Después de la instalación, el agente llama a AppCAT para evaluar el proyecto actual. Este paso puede tardar varios minutos en completarse.

7. Tras completar el análisis, el evaluador de modernización genera una vista categorizada de los problemas de preparación de la nube en un informe de evaluación abierto.

   

8. Al revisar el informe de resumen, puede seleccionar Migrar a Azure SQL Database (Spring) en la lista de soluciones en el problema Migración de bases de datos (Microsoft SQL). A continuación, seleccione Ejecutar tarea para pasar a la fase de corrección de código.

   

Aplicar una tarea predefinida

Para la migración, Copilot proporciona tareas predefinidas para escenarios comunes de migración que podría enfrentar al migrar a Azure. Por ejemplo, con el ejemplo mi-sql-public-demo , la tarea Database Migration (Microsoft SQL) cambia la conexión de la base de datos de Azure SQL para usar la identidad administrada de Azure en lugar de un nombre de usuario y una contraseña.

Para aplicar una tarea predefinida, siga estos pasos:

1. En el Informe de evaluación, seleccione Ejecutar tarea. La ventana de chat de Copilot se abre con el modo de agente seleccionado.

2. El agente de Copilot usa varias herramientas para la modernización de aplicaciones y cada herramienta puede requerir confirmación para continuar. plan.md y progress.md se generan primero, y puede revisar plan.md y realizar cambios allí, si es necesario.

3. Introduzca manualmente continue para confirmar e iniciar el proceso de migración.

4. Antes de realizar cambios en el código, el agente comprueba el estado del sistema de control de versiones y comprueba una nueva rama para la migración.

5. Seleccione o escriba repetidamente Continuar para confirmar el uso de herramientas o comandos y esperar a que finalicen los cambios de código.

Nota:

En Visual Studio Code, la modernización de aplicaciones usa el AppModernization agente personalizado con Claude Sonnet 4.5 de forma predeterminada para obtener los mejores resultados al actualizar el código Java para migrar a Azure. Vuelve al modelo "auto" si Sonnet 4.5 no está disponible para usted. Puede configurar el agente personalizado para modificar la opción "modelo" seleccionando Configurar agentes personalizados en el menú Agente . Como alternativa, puede usar el selector de modelos de lenguaje en la ventana de chat para cambiar los modelos de la sesión de chat actual.

Iteración de validación

Una vez finalizados los cambios de código, introduzca manualmente continue para proceder con la validación y la iteración de corrección de errores. Este bucle incluye las cinco partes siguientes:

• Aplique la Validate-CVEs herramienta. Esta herramienta intenta detectar vulnerabilidades comunes y exposiciones (CVE) en las dependencias actuales y las corrige.
• Aplique la Build-Project herramienta. Esta herramienta intenta resolver los errores de compilación.
• Aplique la Consistency-Validation herramienta. Esta herramienta analiza los códigos para la coherencia funcional.
• Aplique la Run-Test herramienta. Esta herramienta analiza el proyecto para detectar errores de prueba unitaria y genera automáticamente un plan para corregirlos. La Run-Test herramienta ejecuta de forma iterativa pruebas unitarias y corrige los errores.
• Aplique la Completeness-Validation herramienta. Esta herramienta detecta los elementos de migración que faltan en la migración de código inicial y los corrige.

Una vez completados todos los procesos, introduce continue para generar el resumen de migración como último paso. Revise los cambios en el código y confírmelos seleccionando Mantener.

Generación de casos de prueba unitaria

Para generar casos de prueba unitaria, siga estos pasos:

1. En la barra lateral, seleccione el panel de modernización de aplicaciones de GitHub Copilot .

2. En la sección TAREAS , abra Tareas de calidad y seguridad y, a continuación, seleccione Generar casos de prueba unitaria.

El agente genera pruebas unitarias y crea un TestReport para mostrar los resultados de las pruebas antes y después de la generación. Para obtener más información, consulte Inicio rápido: Generación de pruebas unitarias con la modernización de aplicaciones de GitHub Copilot.

Pasos siguientes

• Trabajar con la evaluación
• Inicio rápido: creación y aplicación de sus propias tareas