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

PDFRSS

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 seu 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.

Repare o Visual Studio e reinicie seu sistema

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

2. No menu Iniciar do Windows, inicie o Visual Studio Installer.

3. Execute o Repair na (s) instalação (ões) afetada (s) do Visual Studio. Isso permite que o Visual Studio reconstrua 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 AWS kit de ferramentas e 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.

Visualizando e filtrando os escaneamentos de segurança do Amazon Q

Para visualizar suas verificações de segurança do Amazon Q no Visual Studio, abra a Lista de erros do Visual Studio expandindo o título Exibir no menu principal do Visual Studio e escolhendo 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 na Lista de erros do Visual Studio, crie um filtro concluindo o procedimento a seguir.

nota

Os resultados da verificação de segurança do Amazon Q só são visíveis após a execução da 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 os resultados da verificação de segurança do Amazon Q na sua 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 título Exibir e escolha 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 do escaneamento 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 reconstruir esses arquivos na próxima vez que você iniciar o Visual Studio.

nota

É possível que essa solução possa afetar 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 seguinte comando: devenv /updateconfiguration /resetExtensions e aguarde a conclusão do comando.

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

Solução de problemas nas configurações de firewall e proxy

O software de verificação de segurança pode interferir na sua capacidade de baixar arquivos dos servidores de idiomas do AWS Toolkit, 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 conseguir carregar, pode haver um firewall ou filtro de proxy impedindo que você acesseaws-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 sua rede usa um certificado personalizado, consulte a configuração e a configuração do arquivo de credencial no AWS CLI tópico AWS Command Line Interfacedo Guia do usuário da versão 1.

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

Para configurar sua variável HTTPS_PROXY env, conclua as etapas a seguir.

1. No menu principal do Visual Studio, escolha Ferramentas e, em seguida, escolha Opções.

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

3. No menu Proxy, defina seu host e 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 seguintes chaves.

• 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 das variáveis de ambiente do Windows, consulte a documentação do Node.js v23.3.0 em nodejs.org.

Permitir listagem 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

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.