Solución de problemas del AWS Toolkit for Visual Studio - AWS Kit de herramientas con Amazon Q
Solución de problemas y prácticas recomendadasVisualización y filtrado de escaneos de seguridad de Amazon QEl AWS kit de herramientas no está instalado correctamenteConfiguración de firewall y proxy

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 del AWS Toolkit for Visual Studio

Las siguientes secciones contienen información general sobre la solución de problemas relacionados con los AWS servicios del kit de herramientas AWS Toolkit for Visual Studio y su uso.

nota

La información set-up-specific de instalación y solución de problemas está disponible en el tema Solución de problemas de instalación, que se encuentra en esta Guía del usuario.

Solución de problemas y prácticas recomendadas

A continuación se indican las prácticas recomendadas al solucionar problemas con AWS Toolkit for Visual Studio .

  • Repare Visual Studio y reinicie el sistema

  • Intente recrear el problema o error antes de enviar un informe.

  • Tome notas detalladas de cada paso, configuración y mensaje de error durante el proceso de recreación.

  • Recopile los registros del AWS kit de herramientas. Para obtener una descripción detallada de cómo localizar los registros del AWS kit de herramientas, consulte el procedimiento Cómo localizar los AWS registros, que se encuentra en este tema de la guía.

  • Compruebe si hay solicitudes abiertas o soluciones conocidas, o bien notifique el problema no resuelto en la sección AWS Toolkit for Visual Studio Problemas del AWS Toolkit for Visual Studio GitHub repositorio.

Repare Visual Studio y reinicie el sistema

  1. Cierre todas las instancias de Visual Studio que se estén ejecutando.

  2. En el menú de inicio de Windows, inicie el Instalador de Visual Studio.

  3. Ejecute la reparación en las instalaciones afectadas de Visual Studio. Esto permite a Visual Studio reconstruir su índice de extensiones instaladas.

  4. Reinicie Windows antes de volver a iniciar Visual Studio.

¿Cómo localizar los registros del AWS kit de herramientas

  1. En el menú principal de Visual Studio, expanda Extensiones.

  2. Elija el kit de AWS herramientas para expandir el menú del kit de AWS herramientas y, a continuación, elija Ver los registros del kit de herramientas.

  3. Cuando se abra la carpeta de registros del AWS kit de herramientas en su sistema operativo, clasifique los archivos por fecha y busque cualquier archivo de registro que contenga información relevante sobre su problema actual.

Visualización y filtrado de escaneos de seguridad de Amazon Q

Para ver los análisis de seguridad de Amazon Q en Visual Studio, abra la Lista de errores de Visual Studio ampliando el encabezado Ver en el menú principal de Visual Studio y seleccionando Lista de errores.

De forma predeterminada, la Lista de errores de Visual Studio muestra todas las advertencias y errores de su base de código. Para filtrar los resultados de los análisis de seguridad de Amazon Q de la Lista de errores de Visual Studio, cree un filtro siguiendo el siguiente procedimiento.

nota

Los resultados del análisis de seguridad de Amazon Q solo son visibles después de ejecutar un análisis de seguridad y detectar problemas.

Los resultados del análisis de seguridad de Amazon Q aparecen como advertencias en Visual Studio. Para ver los resultados del análisis de seguridad de Amazon Q de la Lista de errores, debe seleccionar la opción Advertencias en el encabezado de la Lista de errores.

  1. En el menú principal de Visual Studio, expanda el encabezado Ver y elija Lista de errores para abrir el panel Lista de errores.

  2. En el panel Lista de errores, haga clic con el botón derecho en la fila del encabezado para abrir el menú contextual.

  3. En el menú contextual, amplíe Mostrar columnas, a continuación, seleccione Herramienta en el menú ampliado.

  4. La columna Herramienta se añade a la Lista de errores.

  5. En el encabezado de la columna Herramienta, seleccione el icono Filtro y elija Amazon Q para filtrar los resultados de los análisis de seguridad de Amazon Q.

El AWS kit de herramientas no está instalado correctamente

Problema:

Un minuto después de iniciar Visual Studio, aparecen los siguientes mensajes en AWS Toolkit for Visual Studio el panel de salida y en la barra de información, respectivamente:

Some Toolkit components could not be initialized. Some functionality may not work during this IDE session.

The AWS Toolkit is not properly installed.

Solución:

Es posible que la actualización o la instalación de una extensión hayan provocado la pérdida de algunos de los archivos de caché internos de Visual Studio out-of-sync. El siguiente procedimiento describe cómo reconstruir estos archivos la próxima vez que inicie Visual Studio.

nota

Es posible que esta solución afecte a las personalizaciones de Visual Studio. Tras completar este procedimiento, la extensión del AWS kit de herramientas debería aparecer como instalada y dejar de mostrar ningún mensaje de error. Si sigue teniendo este problema después de completar los siguientes pasos, consulte el problema #452 en el AWS Toolkit for Visual Studio GitHub repositorio para obtener más información.

  1. Instale la versión más reciente de Visual Studio 2022.

    nota

    La versión mínima requerida es la 17.11.5.

  2. Cierre todas las instancias de Visual Studio que se estén ejecutando.

  3. Desde Windows, abra Símbolo del sistema para desarrolladores como administrador.

  4. Desde el Símbolo del sistema para desarrolladores, ejecute el siguiente comando: devenv /updateconfiguration /resetExtensions y espere a que finalice.

  5. Cuando finalice el comando, reinicie Visual Studio.

  6. En Visual Studio, la AWS extensión ahora aparece como instalada y ya no muestra los mensajes de error que aparecen en la parte superior de este problema.

Configuración de firewall y proxy

Solución de problemas con la configuración del firewall y el proxy

El software de análisis de seguridad puede interferir con la capacidad de descargar archivos de los servidores de lenguaje del Kit de herramientas de AWS al eliminar archivos de las descargas o impedir por completo las descargas.

Para comprobar la configuración del firewall y el proxy, vaya a https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json desde un navegador de Internet instalado en el mismo sistema que su instancia de Visual Studio. Si encuentra un error o la página no se puede cargar, es posible que haya un firewall o un filtro de proxy que le impida acceder a aws-toolkit-language-servers.amazonaws.com.

Certificados personalizados

AWS Toolkit for Visual Studio Utiliza un servidor de idiomas que se ejecuta en el entorno de ejecución de Node.js. Para obtener información detallada sobre cómo comprobar si la red utiliza un certificado personalizado, consulte el tema Configuración del archivo de credenciales y de configuración en la AWS CLI en la AWS Command Line InterfaceGuía del usuario de la versión 1.

Para configurar los ajustes del proxy y definir un certificado, debe configurar la variable env HTTPS_PROXY y crear variables de entorno de Windows para las claves NODE_OPTIONS y NODE_EXTRA_CA_CERTS.

Para configurar la variable env HTTPS_PROXY, siga los pasos que se describen a continuación:

  1. En el menú principal de Visual Studio, elija Herramientas y luego Opciones.

  2. En el menú Opciones, amplíe Kit de herramientas de AWS y luego seleccione Proxy.

  3. En el menú Proxy, defina el Host y el Puerto.

nota

Para obtener información sobre cómo configurar HTTPS_PROXY desde el AWS CLI, consulte el AWS CLI tema Uso de un proxy HTTP de la Guía del AWS Command Line Interfaceusuario.

Cree variables de entorno de Windows para las siguientes claves.

  • NODE_OPTIONS = --use-openssl-ca

  • NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs

nota

Para obtener más información sobre la extracción de certificados raíz corporativos, consulte el artículo Exportar un certificado con su clave privada en learn.microsoft.com. Para obtener información detallada sobre las claves de variables del entorno de Windows, consulte la documentación de Node.js v23.3.0 en nodejs.org.

Permita la inclusión en la lista y los pasos adicionales

Además de interferir con el idioma de los servidores de AWS Toolkit, la configuración del firewall puede impedir que Amazon Q cargue en Amazon S3 y llame a la API del servicio. Para minimizar la posibilidad de que se produzcan estos errores, recomendamos permitir el acceso a Internet de salida por el puerto 443 (HTTPS) para los siguientes puntos de conexión:

  • https://codewhisperer.us-east-1.amazonaws.com/

  • https://amazonq-code-transformation-us-east-1-c6160f047e0.s3.amazonaws.com/

  • https://aws-toolkit-language-servers.amazonaws.com/

  • https://q.us-east-1.amazonaws.com

  • https://client-telemetry.us-east-1.amazonaws.com

  • https://cognito-identity.us-east-1.amazonaws.com

  • https://oidc.us-east-1.amazonaws.com

Para obtener una lista detallada de los puntos de conexión, consulte el tema Actualización de firewalls y puertas de enlace para permitir el acceso de esta Guía del usuario. Para obtener información detallada sobre la configuración de un proxy corporativo para Amazon Q, consulte el tema Configuración de un proxy corporativo en Amazon Q de la Guía del usuario de Amazon Q Developer. Si sigues teniendo problemas con el firewall y el proxy, recopila los registros del AWS kit de herramientas y ponte en contacto con el AWS Toolkit for Visual Studio equipo a través de la sección de AWS Toolkit for Visual Studio problemas del repositorio. AWS Toolkit for Visual Studio GitHub Para obtener más información sobre la recopilación de los registros del AWS kit de herramientas, consulta la información de la sección de prácticas recomendadas para la solución de problemas de este tema de la Guía del usuario.