Risoluzione dei problemi relativi al AWS Toolkit for Visual Studio - AWS Toolkit con Amazon Q
Best practice per la risoluzione dei problemiVisualizzazione e filtraggio delle scansioni di sicurezza di Amazon QIl AWS 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 relativi al AWS Toolkit for Visual Studio

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

Nota

Le informazioni sull'installazione e la set-up-specific risoluzione dei problemi sono disponibili nell'argomento Risoluzione dei problemi di installazione, disponibile in questa Guida per l'utente.

Best practice per la risoluzione dei problemi

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

  • Ripristina Visual Studio e riavvia il sistema

  • Prova a ricreare il problema o l'errore prima di inviare una segnalazione.

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

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

  • Controlla le richieste aperte, le soluzioni note o segnala il problema irrisolto nella sezione AWS Toolkit for Visual Studio Problemi del repository. AWS Toolkit for Visual Studio GitHub

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 individuare i log del Toolkit AWS

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

  2. Scegli il AWS Toolkit per espandere il menu AWS Toolkit, quindi scegli Visualizza i registri 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 corrente.

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 selezionando Elenco errori.

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

Nota

I risultati della scansione di sicurezza di Amazon Q sono visibili solo dopo l'esecuzione della scansione di sicurezza e il rilevamento di problemi.

I risultati delle scansioni di sicurezza di Amazon Q vengono visualizzati come avvisi in Visual Studio. Per visualizzare i risultati delle scansioni di sicurezza di Amazon Q dall'elenco degli errori, è necessario selezionare l'opzione Avvertenze nell'intestazione Elenco 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 Tool viene aggiunta all'elenco degli 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 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 perdita di alcuni file della cache interna di Visual Studio out-of-sync. La procedura seguente descrive come far ricostruire 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ù alcun messaggio di errore. Se continui a riscontrare questo problema dopo aver completato i seguenti passaggi, consulta il numero #452 nell' AWS Toolkit for Visual Studio GitHub archivio per ulteriori informazioni.

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

    Nota

    La versione minima richiesta è 17.11.5.

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

  3. Da Windows, apri il Developer Command Prompt come amministratore.

  4. Dal prompt dei comandi dello sviluppatore, esegui il seguente comando:devenv /updateconfiguration /resetExtensions, quindi attendi il completamento del comando.

  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

Il software di scansione di sicurezza può interferire con la capacità di scaricare file dai server di linguaggio AWS Toolkit rimuovendo i file dai download o impedendo del tutto i download.

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

Certificati personalizzati

AWS Toolkit for Visual Studio utilizza un server di lingua che viene eseguito sul runtime Node.js. Per informazioni dettagliate su come verificare se la rete utilizza un certificato personalizzato, consultate l'impostazione del file di configurazione e delle credenziali nell' AWS CLI argomento 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 andNODE_EXTRA_CA_CERTS.

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

  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 Host e Porta.

Nota

Per informazioni sulla configurazione del modulo HTTPS_PROXY AWS CLI, consultate Utilizzo di un proxy HTTP AWS CLI relativo all'argomento della Guida per l'AWS Command Line Interfaceutente.

Create 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 root aziendali, consulta l'articolo Esportare un certificato con la relativa chiave privata all'indirizzo learn.microsoft.com. Per informazioni dettagliate sulle chiavi delle variabili di ambiente Windows, consulta la documentazione di Node.js v23.3.0 all'indirizzo nodejs.org.

Consenti l'elenco e i passaggi aggiuntivi

Oltre a interferire con i server linguistici AWS Toolkit, le impostazioni del firewall possono impedire ad Amazon Q di caricare su Amazon S3 e richiamare l'API del servizio. Per ridurre al minimo il potenziale 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, consultate l'argomento Aggiornamento dei firewall e dei gateway per consentire l'accesso in questa Guida per l'utente. 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 AWS Toolkit for Visual Studio dei problemi del repository. AWS Toolkit for Visual Studio GitHub Per i dettagli sulla raccolta dei log del AWS Toolkit, consulta le informazioni nella sezione sulle migliori pratiche per la risoluzione dei problemi di questo argomento della Guida per l'utente.