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 en ejecución.

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

  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 sus escaneos de seguridad de Amazon Q en Visual Studio, abra la Lista de errores de Visual Studio expandiendo 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 del análisis de seguridad de Amazon Q de la lista de errores de Visual Studio, cree un filtro siguiendo este procedimiento.

nota

Los resultados del análisis de seguridad de Amazon Q solo son visibles después de ejecutar el 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 de los escaneos de seguridad de Amazon Q de tu lista de errores, debes 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, expanda Mostrar columnas y, a continuación, seleccione Herramienta en el menú expandido.

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

  5. En el encabezado de la columna Herramienta, selecciona el icono Filtrar y elige Amazon Q para filtrar los resultados de los escaneos 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 pasos siguientes, consulte el problema #452 en el AWS Toolkit for Visual Studio GitHub repositorio para obtener más información.

  1. Instale la última versión de Visual Studio 2022.

    nota

    La versión mínima requerida es 17.11.5.

  2. Cierre todas las instancias de Visual Studio en ejecución.

  3. Desde Windows, abra la línea de comandos del desarrollador como administrador.

  4. Desde la línea de comandos del desarrollador, 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 de la configuración del firewall y el proxy

El software de escaneo de seguridad puede interferir con la capacidad de descargar archivos de los servidores lingüísticos de AWS Toolkit al eliminar archivos de las descargas o impedir por completo las descargas.

Para comprobar la configuración del firewall y del 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 encuentras un error o la página no se puede cargar, es posible que haya un firewall o un filtro de proxy que te impida acceder a ella. 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 la configuración del archivo de credenciales y de configuración en el AWS CLI tema de la Guía del AWS Command Line Interfaceusuario de la versión 1.

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

Para configurar la variable HTTPS_PROXY env, complete los siguientes pasos.

  1. En el menú principal de Visual Studio, elija Herramientas y, a continuación, Opciones.

  2. En el menú de opciones, expanda el AWS kit de herramientas y, a continuación, elija 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 tema Uso de un proxy HTTP correspondiente a AWS CLI este tema en 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 las variables de entorno de Windows, consulte la documentación de la versión 23.3.0 de Node.js en nodejs.org.

Permita enumerar y seguir 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 saliente a Internet 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 los firewalls y las puertas de enlace para permitir el acceso de esta Guía del usuario. 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.