View a markdown version of this page

Risoluzione dei problemi di AWS Toolkit for Visual Studio - AWS Toolkit con Amazon Q
Le migliori pratiche per la risoluzione dei problemiVisualizzazione e filtraggio delle scansioni di sicurezza di Amazon QIl AWS Il toolkit non è installato correttamenteImpostazioni del firewall e del proxy

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risoluzione dei problemi di AWS Toolkit for Visual Studio

Le sezioni seguenti contengono informazioni generali sulla risoluzione dei problemi AWS Toolkit for Visual Studio e sull'utilizzo dei AWS servizi del toolkit.

Nota

Informazioni specifiche sulla risoluzione dei problemi di installazione e configurazione sono disponibili nell'argomento Risoluzione dei problemi di installazione, disponibile in questa Guida per l'utente.

Le migliori pratiche per la risoluzione dei problemi

Di seguito sono riportate le best practice consigliate per la risoluzione dei AWS Toolkit for Visual Studio problemi.

  • Ripara Visual Studio e riavvia il sistema

  • Tenta di ricreare il problema o l'errore prima di inviare un rapporto.

  • Prendi nota dettagliata di ogni passaggio, impostazione e messaggio di errore durante il processo di ricreazione.

  • Raccogli i AWS log del Toolkit. Per una descrizione dettagliata di come localizzare i log del AWS Toolkit, consulta la procedura Come localizzare i AWS log, disponibile in questo argomento della guida.

  • Verifica la presenza di richieste aperte, soluzioni note o segnala il problema irrisolto nella sezione AWS Toolkit for Visual Studio Problemi del AWS Toolkit for Visual Studio GitHub repository.

Ripara Visual Studio e riavvia il sistema

  1. Chiudi tutte le istanze in esecuzione di Visual Studio.

  2. Dal menu di avvio di Windows, avvia Visual Studio Installer.

  3. Esegui Repair sulle installazioni interessate di Visual Studio. Ciò consente a Visual Studio di ricostruire l'indice delle estensioni installate.

  4. Riavvia Windows prima di riavviare Visual Studio.

Come localizzare il tuo AWS Log del Toolkit

  1. Dal menu principale di Visual Studio, espandi Estensioni.

  2. Scegli il AWS Toolkit per espandere il menu AWS Toolkit, quindi scegli Visualizza i log del Toolkit.

  3. Quando la cartella AWS Toolkit logs si apre nel tuo sistema operativo, ordina i file per data e individua qualsiasi file di registro che contenga informazioni pertinenti al problema attuale.

Visualizzazione e filtraggio delle scansioni di sicurezza di Amazon Q

Per visualizzare le scansioni di sicurezza di Amazon Q in Visual Studio, apri l'elenco degli errori di Visual Studio espandendo l'intestazione Visualizza nel menu principale di Visual Studio e scegliendo Elenco errori.

Per impostazione predefinita, l’Elenco degli errori di Visual Studio mostra tutti gli avvisi e gli errori relativi alla codebase. Per filtrare i risultati delle scansioni di sicurezza di Amazon Q dall'elenco degli errori di Visual Studio, crea un filtro completando la procedura seguente.

Nota

I risultati della scansione di sicurezza di Amazon Q sono visibili solo dopo che la scansione di sicurezza è stata eseguita e ha rilevato problemi.

I risultati della scansione di sicurezza di Amazon Q vengono visualizzati come avvisi in Visual Studio. Per visualizzare i risultati della scansione di sicurezza di Amazon Q dall'elenco degli errori, è necessario selezionare l'opzione Avvertenze nell'intestazione Elenco degli errori.

  1. Dal menu principale di Visual Studio, espandi l'intestazione Visualizza e scegli Elenco errori per aprire il riquadro Elenco errori.

  2. Dal riquadro Elenco errori, fai clic con il pulsante destro del mouse sulla riga di intestazione per aprire il menu contestuale.

  3. Dal menu contestuale, espandi Mostra colonne, quindi seleziona Strumento nel menu espanso.

  4. La colonna Strumento viene aggiunta all’Elenco errori.

  5. Dall'intestazione della colonna Tool, seleziona l'icona Filtro e scegli Amazon Q per filtrare i risultati delle scansioni di sicurezza di Amazon Q.

Il AWS Il toolkit non è installato correttamente

Problema:

Entro un minuto dall'avvio di Visual Studio, AWS Toolkit for Visual Studio i seguenti messaggi vengono visualizzati rispettivamente nel riquadro di output e nella barra delle informazioni:

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

The AWS Toolkit is not properly installed.

Soluzione::

È possibile che l'aggiornamento o l'installazione di un'estensione abbiano causato la mancata sincronizzazione di alcuni file di cache interni di Visual Studio. La procedura seguente descrive come ricreare questi file al successivo avvio di Visual Studio.

Nota

È possibile che questa soluzione influisca sulle personalizzazioni di Visual Studio. Dopo aver completato questa procedura, l'estensione AWS Toolkit dovrebbe essere elencata come installata e non riportare più un messaggio di errore. Se continui a riscontrare questo problema dopo aver completato i seguenti passaggi, consulta il problema #452 nel AWS Toolkit for Visual Studio GitHub repository per ulteriori informazioni.

  1. Installa la versione più recente di Visual Studio 2022.

    Nota

    La versione minima richiesta è la 17.11.5.

  2. Chiudi tutte le istanze in esecuzione di Visual Studio.

  3. Da Windows, apri il prompt dei comandi per gli sviluppatori come amministratore.

  4. Dal Developer Command Prompt, esegui il seguente comando:devenv /updateconfiguration /resetExtensions, quindi attendi che il comando finisca.

  5. Al termine del comando, riavvia Visual Studio.

  6. In Visual Studio l' AWS estensione è ora elencata come installata e non riporta più i messaggi di errore elencati all'inizio di questo problema.

Impostazioni del firewall e del proxy

Risoluzione dei problemi relativi alle impostazioni del firewall e del proxy

Security-scanning il software può interferire con la capacità di scaricare file dai server linguistici di AWS Toolkit rimuovendo i file dai download o impedendone del tutto i download.

Per verificare le impostazioni del firewall e del proxy, accedi https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json da un browser Internet installato sullo stesso sistema dell'istanza di Visual Studio. Se riscontri un errore o la pagina non può essere caricata, è possibile che sia presente un firewall o un filtro proxy che ti impedisce di accedereaws-toolkit-language-servers.amazonaws.com.

Certificati personalizzati

AWS Toolkit for Visual Studio Utilizza un server di lingua che viene eseguito in Node.js fase di esecuzione. Per informazioni dettagliate su come verificare se la rete utilizza un certificato personalizzato, consulta l'impostazione dei file di configurazione e credenziali nell' AWS CLIargomento della Guida per l'AWS Command Line Interfaceutente della versione 1.

Per configurare le impostazioni del proxy e definire un certificato, è necessario configurare la variabile HTTPS_PROXY env e creare variabili di ambiente Windows per le chiavi NODE_OPTIONS eNODE_EXTRA_CA_CERTS.

Per configurare la variabile HTTPS_PROXY env, completa i passaggi seguenti.

  1. Dal menu principale di Visual Studio, scegli Strumenti, quindi scegli Opzioni.

  2. Dal menu Opzioni, espandi AWS Toolkit, quindi scegli Proxy.

  3. Dal menu Proxy, definisci l'host e la porta.

Nota

Per informazioni sulla configurazione HTTPS_PROXY da AWS CLI, consulta l' AWS CLIargomento Utilizzo di un proxy HTTP nella Guida per l'AWS Command Line Interfaceutente.

Crea variabili di ambiente Windows per le seguenti chiavi.

  • NODE_OPTIONS = --use-openssl-ca

  • NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs

Nota

Per ulteriori informazioni sull'estrazione dei certificati principali aziendali, vedere l'articolo Esportare un certificato con la sua chiave privata all'indirizzo learn.microsoft.com. Per informazioni dettagliate sulle chiavi delle variabili di ambiente Windows, consulta la documentazione della versione 23.3.0 all'indirizzo nodejs.org Node.js .

Consenti l'elenco e i passaggi aggiuntivi

Oltre a interferire con i server linguistici di AWS Toolkit, le impostazioni del firewall possono impedire il caricamento di Amazon Q su Amazon S3 e la chiamata all'API del servizio. Per ridurre al minimo il rischio di questi errori, consigliamo di consentire l'accesso a Internet in uscita sulla porta 443 (HTTPS) per i seguenti endpoint:

  • 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

Per un elenco dettagliato degli endpoint, consulta l'argomento Aggiornamento di firewall e gateway per consentire l'accesso in questa Guida per l'utente. Per informazioni dettagliate sulla configurazione di un proxy aziendale per Amazon Q, consulta l'argomento Configurazione di un proxy aziendale in Amazon Q nella Amazon Q Developer User Guide. Se continui a riscontrare problemi con firewall e proxy, raccogli i log del AWS Toolkit e contatta il AWS Toolkit for Visual Studio team tramite la sezione relativa ai AWS Toolkit for Visual Studio problemi del repository. AWS Toolkit for Visual Studio GitHub Per informazioni dettagliate sulla raccolta dei log del AWS Toolkit, consulta le informazioni nella sezione sulle best practice per la risoluzione dei problemi di questo argomento della Guida per l'utente.