Solución de problemas con el Amazon Q Developer Agent for code transformation - Amazon Q Developer
¿Por qué Amazon Q no puede subir mi proyecto?¿Por qué son mis Maven ¿Los comandos fallan?¿Cómo agrego Maven a mi? PATH¿Por qué Amazon Q no puede crear mi código?¿Por qué falló mi transformación después de 55 minutos?¿Por qué no puedo descargar mi código transformado?¿Cómo accedo a los registros de transformación de código?¿Cómo puedo encontrar el ID de mi trabajo de transformación?

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Solución de problemas con el Amazon Q Developer Agent for code transformation

La siguiente información puede ayudarle a solucionar problemas comunes con el Amazon Q Developer Agent for code transformation.

¿Por qué Amazon Q no puede subir mi proyecto?

Si tu proyecto no se carga, es probable que se deba a uno de los siguientes problemas. Consulta el tema correspondiente al error que ves en Amazon Q.

Reduce el tamaño del proyecto

Para transformar el código, Amazon Q genera un artefacto del proyecto, que incluye el código fuente, las dependencias del proyecto y los registros de compilación. El tamaño máximo del artefacto del proyecto para un trabajo de transformación es de 2 GB. Si recibes un error relacionado con el tamaño del artefacto del proyecto, debes reducir el tamaño del proyecto o intentar transformar un proyecto más pequeño. Puedes ver el tamaño del archivo de artefactos de tu proyecto en los registros de transformación de código. Para obtener más información, consulte ¿Cómo accedo a los registros de transformación de código?

Configure los ajustes de proxy en su IDE

Para transformar el código, Amazon Q carga el artefacto del proyecto en un bucket de Amazon S3 propiedad del servicio. Parte del proceso de carga implica el uso SSL de TLS nuestros certificados para establecer la comunicación entre Amazon S3 y su IDE Si utilizas un servidor proxy, el SSL o los TLS certificados utilizados por tu servidor proxy deben ser de confianza; de lo contrario, Amazon Q no podrá cargar tu proyecto.

Si recibe un error relacionado con su proxy o sus certificados, es probable que necesite configurar su sistema operativo IDE o su sistema operativo para que confíe en sus certificados o actualizar otros ajustes del proxy.

nota

También es posible que encuentres problemas no relacionados con los certificados si estás protegido por el servidor proxy o el firewall de tu organización. Si sigue los siguientes procedimientos para configurar sus certificados y sigue teniendo problemas, póngase en contacto con el administrador de la red para asegurarse de que puede comunicarse con Amazon S3 desde su IDE Para obtener más información, consulte Permitir el acceso a Amazon S3.

Configure los certificados en JetBrains

Para configurar su JetBrains IDEJava Runtime Environment (JRE) para confiar en los TLS certificados SSL o utilizados por su servidor proxy, debe importar los TLS certificados SSL o al cacerts archivo delJRE. El cacerts archivo es un archivo que contiene certificados raíz de confianza para conexiones seguras, como HTTPS ySSL, y forma parte de la configuración de seguridad JRE del mismo. Para importar un certificado, complete el siguiente procedimiento.

nota

Se recomienda hacer una copia de seguridad del cacerts archivo antes de modificarlo, ya que cualquier error puede provocar problemas con las conexiones seguras.

  1. Determine la ruta al cacerts archivo en suJRE. La ruta del cacerts archivo interno que se JRE envía con su JetBrains IDEdepende del sistema operativo y de la versión del JetBrains IDEque estás usando.

    A continuación se muestran ejemplos de rutas al cacerts archivo en los sistemas operativos más comunes. Seleccione su sistema operativo para ver ejemplos.

    nota

    <JetBrains Installation Folder>hace referencia al directorio donde JetBrains los productos están instalados. Este directorio se elige normalmente durante el proceso de instalación.

    La jbr carpeta representa el JRE paquete con JetBrains IDEs, que es una versión específica de la JRE diseñada para su uso con JetBrains IDEs.

    Windows

    La ruta cacerts del archivo de un JetBrains IDEinstalado en Windows es:

    <JetBrains Installation Folder>\jbr\bin\cacerts

    Por ejemplo, si instaló un JetBrains IDEen Windows en la ubicación predeterminada, la ruta podría ser:

    C:\Program Files\JetBrains\jbr\bin\cacerts
    macOS

    La ruta cacerts del archivo de un JetBrains IDEinstalado en macOS es:

    /Applications/JetBrains Toolbox/<version>/JetBrains Toolbox.app/Contents/jbr/Contents/Home/lib/security/cacerts

    Por ejemplo, si ha instalado un JetBrains IDEen macOS en la ubicación predeterminada, la ruta podría ser:

    /Applications/JetBrains Toolbox/2022.3.4/JetBrains Toolbox.app/Contents/jbr/Contents/Home/lib/security/cacerts
    Linux

    La ruta cacerts del archivo de un JetBrains IDEinstalado en Linux es:

    /opt/jetbrains/jbr/lib/security/cacerts

  2. Determine el certificado que necesita importar al cacerts archivo. El archivo de certificado suele tener una extensión de .der archivo .cer.crt, o. Si no está seguro de qué certificados debe agregar, póngase en contacto con el administrador de la red.

  3. Importe el certificado al cacerts almacén de claves. Puede hacerlo con el keytool comando Java.

    1. Abra una línea de comandos e introduzca el siguiente comando:

      keytool -import -alias <alias> -file <certificate_file> -keystore <path_to_cacerts>

    2. Para ello<alias>, puede añadir un nombre al certificado que va a importar para consultarlo más adelante. Esta opción es opcional.

    3. Para<certificate_file>, especifique la ruta al certificado que va a importar. Debe ser una ruta al .der archivo.cer,.crt, o que contiene el certificado.

    4. Para<path_to_cacerts>, especifique la ruta al archivo del cacerts almacén de claves que guardó en el paso 1. Este es el archivo en el que va a importar el certificado.

    Por ejemplo, si desea importar un certificado con su nombre my_certificate.cer al cacerts almacén de claves del paquete JRE IntelliJ IDEA en Windows y desea asignar el alias myalias al certificado, el comando podría ser:

    keytool -import -alias myalias -file my_certificate.cer -keystore "C:\Program Files\JetBrains\IntelliJ IDEA 2022.3.2\jbr\bin\cacerts"

  4. Durante el proceso de importación, se le pedirá que introduzca la contraseña del almacén de claves. La contraseña predeterminada para el cacerts almacén de claves es. changeit

  5. Tras ejecutar el comando, se le pedirá que confíe en el certificado. Para confirmar que el certificado es de confianza y completar la importación, introduzcayes.

  6. Es posible que también necesite añadir los certificados al IDE propio certificado, además delJRE. Para obtener más información, consulte Certificados de servidor en el JetBrains .

Mostrar másMostrar menos

Configure los certificados en Visual Studio Code

Para configurar Visual Studio Code para confiar en los SSL TLS certificados utilizados por su servidor proxy, asegúrese de haber configurado los siguientes ajustes de proxy para su sistema operativo.

Configure los siguientes ajustes de proxy para Visual Studio Code en macOS.

Agrega certificados a tu llavero de macOS

Si aún no lo ha hecho, debe añadir los certificados que utiliza su servidor proxy a su macOS llavero. Para obtener información sobre cómo añadir certificados a tu llavero, consulta Añadir certificados a un llavero mediante Keychain Access en Mac en la Guía del usuario de Keychain Access.

Instala la extensión CA para Mac VSCode

La VSCodeextensión CA para Mac permite a Amazon Q acceder a los certificados que has añadido a Keychain Access en tu Mac.

Para instalar la extensión:

  1. Busque mac-ca-vscode en el VS Code panel de extensiones y selecciona Instalar.

  2. Restart (Reiniciar) VS Code.

Actualice la configuración del proxy en VS Code en macOS

Actualice la siguiente configuración para asegurarse VS Code está configurado correctamente para su proxy.

  1. Abra la configuración en VS Code.

  2. Escriba proxy en la barra de búsqueda.

  3. En el campo Http: Proxy, añade tu proxyURL.

  4. Deseleccione Http: Proxy Strict SSL.

  5. En la lista desplegable Http: Proxy Support, selecciona Activar.

  6. En la barra de búsqueda de ajustes, ingresahttp.experimental.systemCertificatesV2. Seleccione Http › Experimental: System Certificates V2.

Configure los siguientes ajustes de proxy para Visual Studio Code en Windows.

Agregue el certificado como certificado raíz de confianza en Windows

Si aún no lo ha hecho, debe agregar los certificados utilizados por su servidor proxy a la tienda de autoridades de certificación raíz de confianza en Windows. Para agregar un certificado, complete el siguiente procedimiento:

  1. Abra la herramienta de búsqueda o una ventana de comandos de ejecución.

  2. Introduzca lo siguiente para abrir la herramienta Certificate Manager:

    certmgr.msc

  3. Elija el almacén Trusted Root Certification Authorities.

  4. Haga clic con el botón derecho en Certificados, seleccione Todas las tareas y, a continuación, elija Importar... .

  5. Siga las instrucciones que se indican para importar su certificado de proxy.

  6. Después de importar el certificado, confirme que se agregó.

    En la tienda Trusted Root Certification Authorities, haga doble clic en Certificados. Haga clic con el botón derecho en el certificado que ha agregado y seleccione Propiedades. En Propósitos del certificado, debe seleccionarse la opción Habilitar todos los propósitos de este certificado.

Instale la extensión Win-CA VSCode

La VSCodeextensión Win-CA permite a Amazon Q acceder a los certificados que ha añadido a los certificados raíz de confianza en Windows.

Para instalar la extensión:

  1. Busque win-ca en el VS Code panel de configuración.

  2. En la lista desplegable Inyectar, seleccione anexar.

Actualice la configuración del proxy en VS Code en Windows

Actualice la siguiente configuración para asegurarse VS Code está configurado correctamente para su proxy.

  1. Abra la configuración en VS Code.

  2. Escriba proxy en la barra de búsqueda.

  3. En el campo Http: Proxy, añade tu proxyURL.

  4. Deseleccione Http: Proxy Strict SSL.

  5. En la lista desplegable Http: Proxy Support, selecciona Activar.

  6. En la barra de búsqueda de ajustes, ingresahttp.experimental.systemCertificatesV2. Seleccione Http › Experimental: System Certificates V2.

  7. Restart (Reiniciar) VS Code.

Permitir el acceso a Amazon S3

Durante una transformación, el Amazon Q Developer Agent for code transformation carga el código en un bucket de Amazon S3 propiedad del servicio. Si su red u organización no ha configurado el acceso a Amazon S3, Amazon Q no podrá cargar su proyecto.

Para garantizar que Amazon Q pueda cargar su proyecto, asegúrese de que la configuración del proxy y otros componentes de la red, como las políticas de prevención de pérdida de datos (DLP), estén configurados para permitir el acceso a Amazon S3. Es posible que también tengas que incluir en la lista de permitidos el bucket de Amazon S3 en el que Amazon Q carga tu proyecto. Para obtener más información, consulte Perímetros de datos para los recursos de Amazon Q.

Si transformas un proyecto grande, DLP las políticas u otros componentes de la red podrían provocar demoras e impedir que la carga se realice correctamente si no están configurados para incluir en la lista de permitidos el bucket de Amazon S3. Si eliges no incluir el bucket en la lista, es posible que tengas que transformar un proyecto más pequeño para que Amazon Q pueda subirlo.

¿Por qué son mis Maven ¿Los comandos fallan?

Los siguientes son Maven problemas de configuración que pueden aparecer en el JetBrains y Visual Studio Code IDEs. Si abordas los problemas y sigues viendo Maven errores, es posible que haya un problema con tu proyecto. Usa la información de los registros de errores para solucionar cualquier problema relacionado con tu proyecto y, a continuación, intenta transformarlo de nuevo.

Actualización Maven configuración en JetBrains

Si se produce un error en una transformación JetBrains debido a Maven problemas con los comandos, los registros de errores aparecen en la pestaña Ejecutar. Utilice la información de los registros para solucionar el problema. A continuación, se muestran algunos problemas que puede que tengas que solucionar:

  • Asegúrese de que su Maven la ruta de inicio está configurada como Bundled. Vaya a Configuración y, a continuación, expanda la sección Creación, Ejecución e Implementación. Amplíe la sección Herramientas de compilación y, a continuación, expanda Maven. En la lista desplegable de rutas de inicio de Maven, selecciona Empaquetado.

  • Asegúrese de que el Java runtime environment (JRE) está utilizando su proyectoJDK. Vaya a Configuración y, a continuación, expanda la sección Creación, Ejecución e Implementación. Expandir Maveny elige Runner. En la lista JREdesplegable, selecciona Usar proyecto JDK.

  • Asegúrese de que Maven está activado. Ve a Configuración y selecciona Plugins. Busca Maven y elige el Maven el complemento. Si ve el botón Activar, selecciónelo para activarlo Maven.

Actualización Maven configuración en Visual Studio Code

Si se produce un error en una transformación VS Code debido a Maven problemas con los comandos, se abre un archivo de texto que contiene los registros de errores en una nueva pestaña. Utilice la información de los registros para solucionar el problema.

Asegúrese de haber configurado una de las siguientes opciones:

  • Su proyecto contiene un Maven contenedor en la carpeta raíz del proyecto

  • Una versión de Maven compatible con Amazon Q está disponible en su PATH

Para obtener más información, consulte ¿Cómo agrego Maven a mi? PATH

¿Cómo agrego Maven a mi? PATH

Para transformar tu código en VS Code sin usar un Maven envoltorio, debes instalar Maven y agréguelo a su PATH variable.

Para comprobar si tienes Maven si ya está instalado correctamente, ejecútelo mvn -v en un nuevo terminal de sistema operativo fuera de Visual Studio Code. Deberías ver una salida con tu Maven versión.

Si obtiene un resultado en su Visual Studio Code terminal pero no en la terminal de su sistema operativo, o si no encuentra el comando, debe agregar Maven a tuPATH.

Para añadir Maven a la suyaPATH, siga las instrucciones de su máquina.

macOS

Para añadir Maven en tu macOSPATH, sigue estos pasos.

  1. Localiza tu Maven el directorio de instalación o la carpeta en la que lo instaló Maven, y guarde la ruta a esa carpeta.

  2. Abra el archivo de configuración de su shell en el editor que prefiera. Para las versiones recientes de macOS, el shell predeterminado es zsh y el archivo de configuración predeterminado se encuentra en~/.zshrc.

    Añada las siguientes líneas al final del archivo de configuración. Defina el valor de M2_HOME la ruta que guardó en el paso 1:

    export M2_HOME="your Maven installation directory"
export PATH="${M2_HOME}/bin:${PATH}"

    Estos comandos hacen que el mvn comando esté disponible en todos los terminales.

  3. Cierre todas las ventanas de los terminales del sistema operativo y cierre todas Visual Studio Code instancias.

  4. Para comprobar que Maven se agregó a la suyaPATH, abra una nueva terminal del sistema operativo y ejecute el siguiente comando:

    mvn -v

    Deberías ver un resultado con tu Maven versión.

  5. Después de ver tu Maven salida, reinicia Visual Studio Code. Es posible que también necesite reiniciar el equipo. Abre una nueva Visual Studio Code terminal y ejecuta el siguiente comando: 

    mvn -v

    La salida debe ser idéntica a la salida del paso 4. Si el archivo de Visual Studio Code la salida es diferente, intente lo siguiente para asegurarse de que la configuración es correcta:

    • Marque su PATH variable en Visual Studio Code. Es posible que una IDE extensión esté alterando la variable de PATH tal manera que difiera de la PATH variable local. Desinstale la extensión para eliminarla de suPATH.

    • Comprueba tu shell predeterminado en Visual Studio Code. Si está configurado en algo diferente azsh, repite estos pasos para tu caparazón.

Windows

Para añadir Maven a tu Windows PATH, complete los siguientes pasos:

  1. Localice su Maven el directorio de instalación o la carpeta en la que lo instaló Maven, y guarde la ruta a esa carpeta.

  2. Abra la ventana Variables de entorno:

    1. Elija el icono Windows botón para abrir la barra de búsqueda.

    2. Entra Edit environment variables for your account y elígelo.

  3. En la ventana Variables de entorno, busque la variable Path. Si ya tiene una variable de ruta, elija Editar... para actualizarla. Si no ve ninguna variable de ruta, elija Nuevo... para añadir una.

  4. En la ventana Editar variable de entorno que aparece, haga doble clic en la ruta existente para editarla o seleccione Nueva para añadir una nueva entrada de ruta.

    Sustituya la existente Maven la entrada de ruta por la ruta que guardó en el paso 1 o añada la ruta como una entrada nueva. Al final de la ruta, añada \bin un sufijo, como en el siguiente ejemplo:

    C:\Users\yourusername\Downloads\apache-maven-3.9.6-bin\apache-maven-3.9.6\bin

  5. Pulse Aceptar para guardar la entrada de la ruta y, a continuación, vuelva a pulsar Aceptar en la ventana Variables de entorno.

  6. Abra una nueva línea de comandos y ejecute el siguiente comando:

    mvn -v

    Debería ver un resultado con su Maven versión.

¿Por qué Amazon Q no puede crear mi código?

Si la transformación falla cuando Amazon Q está creando el código, es posible que el proyecto no esté configurado correctamente para el entorno en el que Amazon Q crea el código. Es posible que necesite actualizar la configuración de compilación o la implementación del código.

Revise el resultado del registro de compilación que proporciona Amazon Q para determinar si hay cambios que pueda realizar en su proyecto. A continuación, se muestran algunos problemas comunes que pueden impedir que Amazon Q cree su código.

Elimine las rutas absolutas en pom.xml

Si tienes una ruta absoluta en tu archivo pom.xml, Amazon Q no podrá encontrar los archivos relevantes y, como resultado, es posible que no pueda compilar el código.

A continuación se muestra un ejemplo de una ruta absoluta que podría tener en su pom.xml archivo:

<toolspath>
    <path>/Library/Java/JavaVirtualMachines/jdk-11.0.11.jdk/Contents/Home/lib/tools.jar</path>
</toolspath>

En lugar de utilizar una ruta absoluta, puede crear una ruta relativa con un puntero. A continuación se muestra un ejemplo de cómo puede reemplazar la ruta absoluta anterior por una ruta relativa:

<toolspath>
    <path>${java.home}/../lib/tools.jar</path>
</toolspath>

Elimine las bases de datos locales o externas en las pruebas unitarias

Amazon Q ejecuta todas las pruebas unitarias del proyecto cuando compila el código. Si una prueba unitaria llama a una base de datos local o externa, Amazon Q no tendrá acceso a la base de datos, lo que provocará un error en la compilación. Para evitar que la compilación falle, debe eliminar la llamada a la base de datos de la prueba unitaria o eliminar la prueba unitaria antes de enviar la transformación.

¿Por qué falló mi transformación después de 55 minutos?

Si el trabajo de transformación de código falla después de 55 minutos, es probable que el tiempo de compilación del código supere el límite de tiempo de compilación. Actualmente, existe un límite de tiempo de 55 minutos para compilar el código.

Si el tiempo de compilación local es de 55 minutos o más, reduce el tiempo de compilación de tu proyecto para transformar el código. Si tu compilación local es más rápida que la compilación con Code Transformation, revisa tu proyecto para ver si hay tareas que puedan estar fallando o que requieran más tiempo en un entorno diferente. Considera la posibilidad de deshabilitar los casos de prueba de larga duración. Considere también la posibilidad de utilizar los tiempos de espera para intentar acceder a recursos que podrían no estar disponibles en el IDE entorno seguro o en Internet.

¿Por qué no puedo descargar mi código transformado?

Si no puedes descargar el código una vez finalizada la transformación, es probable que se deba a uno de los siguientes problemas. Consulta el tema correspondiente al error que ves en Amazon Q.

Reduce el tamaño del proyecto

Una vez completada la transformación, Amazon Q genera un artefacto de salida que contiene una diferencia con el código actualizado y un resumen de la transformación con información sobre los cambios realizados. El artefacto de salida debe tener 1 GB o menos para poder IDE descargarlo.

Si el artefacto de salida supera el límite, no podrás descargar el código actualizado ni el resumen de la transformación. Intenta transformar un proyecto más pequeño para evitar que se produzca un artefacto de gran tamaño. Si el problema persiste, ponte en contacto con AWS Support. Para obtener información sobre cómo ponerse en contacto AWS Support con Amazon Q, consulteUso de Amazon Q Developer para chatear con AWS Support.

Descarga el código diff en 24 horas

El archivo de diferencias de códigos con el código actualizado solo estará disponible 24 horas después de que se complete la transformación. Si han pasado más de 24 horas desde que se completó la transformación, reiníciela para descargar el archivo diff.

Configure los ajustes de proxy en su IDE

La Amazon Q Developer Agent for code transformation descarga el código actualizado de un bucket de Amazon S3 propiedad del servicio. Parte del proceso de descarga implica el uso SSL de TLS nuestros certificados para establecer la comunicación entre Amazon S3 y suIDE. Si utilizas un servidor proxy, el SSL o los TLS certificados utilizados por tu servidor proxy deben ser de confianza; de lo contrario, Amazon Q no podrá cargar tu proyecto.

Para descargar el código, puede que tengas que configurar tus IDE certificados de confianza o actualizar otros ajustes del proxy. Para obtener más información sobre cómo actualizar la configuración del proxy, consulteConfigure los ajustes de proxy en su IDE.

Elimine los caracteres comodín en JetBrains configuración de proxy

Si ha configurado los ajustes de proxy en su JetBrains IDE, es posible que aparezca el siguiente error al descargar el código actualizado: 

software.amazon.awssdk.core.exception.SdkClientException: 
Unable to execute HTTP request: Dangling meta character '*' near index 0

Es probable que esto se deba a la presencia de un carácter comodín (*) en el campo Sin proxy para de la configuración IDE del proxy. El Java SDK utilizado por Amazon Q Developer Agent for code transformation no admite entradas con caracteres comodín en este campo.

Para descargar el código, elimine los caracteres comodín del campo Sin proxy para y, a continuación, reinicie su. IDE Si necesita especificar los hosts que deben omitir el proxy, utilice una expresión regular en lugar de un comodín. Para actualizar la configuración del proxy en su sitio JetBrains IDE, consulte HTTPProxy en el JetBrains .

¿Cómo accedo a los registros de transformación de código?

Acceda a los inicios de sesión JetBrains

Para obtener información sobre cómo acceder JetBrains archivos de registro, consulte Ubicación de los archivos de IDE registro en JetBrains .

Para buscar los registros emitidos por Amazon Q Developer Agent for code transformation in JetBrains, busque en los IDE registros la siguiente cadena:

software.aws.toolkits.jetbrains.services.codemodernizer

Los registros de transformación de código comienzan con la cadena anterior. Los registros generados por Maven se muestran en la pestaña Ejecutar y tienen la cadena anterior antes y después de la entrada del registro.

Access inicia sesión Visual Studio Code

Para buscar los registros emitidos por el Amazon Q Developer Agent for code transformation in VS Code, complete los siguientes pasos:

  1. Seleccione Ver en la barra de navegación superior y, a continuación, elija Paleta de comandos.

  2. Busque Amazon Q: View Logs en la paleta de comandos que aparece.

  3. Los registros se abren enIDE. Para buscar en los archivos de registroCodeTransformation, utilice CMD + F oControl + F.

La transformación de código inicia sesión VS Code llevan el prefijo. CodeTransformation: A continuación se muestra un ejemplo de un registro generado en VS Code para un Maven error de copia de dependencias:

2024-02-12 11:29:16 [ERROR]: CodeTransformation: Error in running Maven copy-dependencies command mvn = /bin/sh: mvn: command not found

¿Cómo puedo encontrar el ID de mi trabajo de transformación?

Encuentra tu ID de trabajo en JetBrains

Para encontrar un identificador de trabajo de transformación en JetBrains, vaya a la pestaña Detalles de la transformación en el Centro de Transformaciones y elija el icono Mostrar estado del trabajo (reloj).

Busque su ID de trabajo en Visual Studio Code

Para encontrar un ID de trabajo de transformación en VS Code, vaya al Centro de Transformación y elija el icono Mostrar estado del trabajo (reloj).