Solução de problemas do AWS Toolkit for Visual Studio - AWS Kit de ferramentas com Amazon Q
Práticas recomendadas de solução de problemasVisualizar e filtrar as verificações de segurança do Amazon QO AWS kit de ferramentas não está instalado corretamenteConfigurações de firewall e proxy

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solução de problemas do AWS Toolkit for Visual Studio

As seções a seguir contêm informações gerais sobre solução de problemas AWS Toolkit for Visual Studio e como trabalhar com AWS os serviços do kit de ferramentas.

nota

As informações sobre instalação e set-up-specific solução de problemas estão disponíveis no tópico Solução de problemas de instalação, localizado neste Guia do usuário.

Práticas recomendadas de solução de problemas

As práticas recomendadas a seguir são sugeridas para a solução problemas do AWS Toolkit for Visual Studio .

  • Repare o Visual Studio e reinicie o sistema.

  • Tente recriar seu problema ou erro antes de enviar um relatório.

  • Faça anotações detalhadas de cada etapa, configuração e mensagem de erro durante o processo de recriação.

  • Colete registros AWS do kit de ferramentas. Para obter uma descrição detalhada de como localizar seus registros do AWS Toolkit, consulte o procedimento Como localizar seus AWS registros, localizado neste tópico do guia.

  • Verifique se há solicitações abertas, soluções conhecidas ou relate seu problema não resolvido na seção AWS Toolkit for Visual Studio Problemas do AWS Toolkit for Visual Studio GitHub repositório.

Reparar o Visual Studio e reiniciar o sistema

  1. Feche todas as instâncias em execução do Visual Studio.

  2. No menu Iniciar do Windows, execute o instalador do Visual Studio.

  3. Execute a ação de reparo nas instalações afetadas do Visual Studio. Isso permitirá que o Visual Studio recompile seu índice de extensões instaladas.

  4. Reinicie o Windows antes de reiniciar o Visual Studio.

Como localizar seus registros do AWS Toolkit

  1. No menu principal do Visual Studio, expanda Extensões.

  2. Escolha o AWS kit de ferramentas para expandir o menu do kit de AWS ferramentas e, em seguida, escolha Exibir registros do kit de ferramentas.

  3. Quando a pasta de registros do AWS Toolkit abrir em seu sistema operacional, classifique os arquivos por data e localize qualquer arquivo de log que contenha informações relevantes ao seu problema atual.

Visualizar e filtrar as verificações de segurança do Amazon Q

Para ver as verificações de segurança do Amazon Q no Visual Studio, abra a Lista de erros do Visual Studio expandindo o cabeçalho Exibir no menu principal do Visual Studio e selecionando Lista de erros.

Por padrão, a Lista de erros do Visual Studio exibe todos os avisos e erros da sua base de código. Para filtrar as descobertas da verificação de segurança do Amazon Q da Lista de erros do Visual Studio, crie um filtro concluindo o procedimento a seguir.

nota

As descobertas da verificação de segurança do Amazon Q só ficam visíveis após a execução de uma verificação de segurança e a detecção de problemas.

As descobertas da verificação de segurança do Amazon Q aparecem como avisos no Visual Studio. Para visualizar as descobertas da verificação de segurança do Amazon Q na Lista de erros, a opção Avisos no cabeçalho da Lista de erros deve ser selecionada.

  1. No menu principal do Visual Studio, expanda o cabeçalho Exibir e selecione Lista de erros para abrir o painel Lista de erros.

  2. No painel Lista de erros, clique com o botão direito da linha do cabeçalho e abra o menu de contexto.

  3. No menu de contexto, expanda Mostrar colunas e selecione Ferramenta no menu expandido.

  4. A coluna Ferramenta é adicionada à sua Lista de erros.

  5. No cabeçalho da coluna Ferramenta, selecione o ícone Filtro e escolha Amazon Q para filtrar as descobertas da verificação de segurança do Amazon Q.

O AWS kit de ferramentas não está instalado corretamente

Problema:

Dentro de um minuto após iniciar o Visual Studio, AWS Toolkit for Visual Studio as seguintes mensagens aparecem no painel de saída e na barra de informações, respectivamente:

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

The AWS Toolkit is not properly installed.

Solução:

É possível que a atualização ou instalação de uma extensão tenha causado o desaparecimento de alguns dos arquivos de cache internos do Visual Studio out-of-sync. O procedimento a seguir descreve como recompilar esses arquivos na próxima vez que você inicializar o Visual Studio.

nota

É possível que essa solução tenha impacto nas suas personalizações do Visual Studio. Depois de concluir esse procedimento, a extensão do AWS Toolkit deve ser listada como instalada e não reportar mais uma mensagem de erro. Se você continuar enfrentando esse problema depois de concluir as etapas a seguir, consulte o Problema #452 no AWS Toolkit for Visual Studio GitHub repositório para obter informações adicionais.

  1. Instale a versão mais recente do Visual Studio 2022.

    nota

    A versão mínima exigida é 17.11.5.

  2. Feche todas as instâncias em execução do Visual Studio.

  3. No Windows, abra o Prompt de Comando do Desenvolvedor como Administrador.

  4. No Prompt de Comando do Desenvolvedor, execute o comando devenv /updateconfiguration /resetExtensions e aguarde sua conclusão.

  5. Depois que o comando for concluído, reinicie o Visual Studio.

  6. No Visual Studio, a AWS extensão agora está listada como instalada e não relata mais as mensagens de erro listadas na parte superior desse problema.

Configurações de firewall e proxy

Solucionar problemas nas configurações de firewall e proxy

O software de verificações de segurança pode interferir na sua capacidade de baixar arquivos dos servidores de linguagens do kit de ferramentas da AWS , removendo arquivos dos downloads ou impedindo completamente os downloads.

Para verificar suas configurações de firewall e proxy, navegue até https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json em um navegador da Internet instalado no mesmo sistema da sua instância do Visual Studio. Se você encontrar um erro ou se a página não carregar, poderá haver um firewall ou filtro de proxy impedindo que você acesse aws-toolkit-language-servers.amazonaws.com.

Certificados personalizados

O AWS Toolkit for Visual Studio utiliza um servidor de linguagem que é executado no tempo de execução do Node.js. Para obter informações detalhadas sobre como verificar se a sua rede usa um certificado personalizado, consulte o tópico Definições de configuração e arquivo de credenciais na AWS CLI no Guia do usuário da AWS Command Line Interface versão 1.

Para definir configurações de proxy e um certificado, você deve configurar a variável de ambiente HTTPS_PROXY e criar variáveis de ambiente do Windows para as chaves NODE_OPTIONS e NODE_EXTRA_CA_CERTS.

Para configurar a variável de ambiente HTTPS_PROXY, conclua as etapas a seguir.

  1. No menu principal do Visual Studio, selecione Ferramentas e Opções.

  2. No menu Opções, expanda Kit de ferramentas da AWS e escolha Proxy.

  3. No menu Proxy, defina o Host e a Porta.

nota

Para obter informações sobre como configurar o a HTTPS_PROXY partir do AWS CLI, consulte o AWS CLI tópico Usando um proxy HTTP no Guia do AWS Command Line InterfaceUsuário.

Crie variáveis de ambiente do Windows para as chaves a seguir.

  • NODE_OPTIONS = --use-openssl-ca

  • NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs

nota

Para obter mais informações sobre como extrair certificados-raiz corporativos, consulte o artigo Exportar um certificado com sua chave privada em learn.microsoft.com. Para obter informações detalhadas sobre as chaves de variáveis de ambiente do Windows, consulte a documentação do Node.js v23.3.0 em nodejs.org.

Inclusão na lista de permissões e etapas adicionais

Além de interferir nos servidores de linguagem do AWS Toolkit, as configurações do firewall podem impedir que o Amazon Q faça o upload para o Amazon S3 e chame a API do serviço. Para minimizar o potencial desses erros, recomendamos permitir o acesso de saída à internet na porta 443 (HTTPS) para os seguintes endpoints:

  • 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 obter uma lista detalhada dos endpoints, consulte o tópico Atualizar firewalls e gateways para permitir o acesso neste Guia do usuário. Para obter informações detalhadas sobre como configurar um proxy corporativo para o Amazon Q, consulte o tópico Configurar um proxy corporativo no Amazon Q no Guia do usuário do Amazon Q Developer. Se você continuar enfrentando problemas de firewall e proxy, colete os registros do AWS kit de ferramentas e entre em contato com a AWS Toolkit for Visual Studio equipe por meio da seção de AWS Toolkit for Visual Studio problemas do AWS Toolkit for Visual Studio GitHub repositório. Para obter detalhes sobre como coletar os registros do AWS kit de ferramentas, consulte as informações na seção de melhores práticas de solução de problemas deste tópico do Guia do usuário.