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 servizi del AWS Toolkit for Visual Studio toolkit e all'utilizzo AWS dei servizi. **Nota** Le informazioni sull'installazione e la set-up-specific risoluzione dei problemi sono disponibili nell'argomento [Risoluzione dei problemi di installazione](https://docs.aws.amazon.com//toolkit-for-visual-studio/latest/user-guide/setup-troubleshoot.html), disponibile in questa Guida per l'utente. **Topics** + [Best practice per la risoluzione dei problemi](#general-troubleshoot-best-practice) + [Visualizzazione e filtraggio delle scansioni di sicurezza di Amazon Q](#general-troubleshoot-Q-securityscan) + [Il AWS Toolkit non è installato correttamente](#general-troubleshoot-component-initilization) + [Impostazioni del firewall e del proxy](#general-troubleshoot-firewall) ## 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](#general-troubleshoot-procedure-logs), 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](https://github.com/aws/aws-toolkit-visual-studio/issues). AWS Toolkit for Visual Studio GitHub **Ripara Visual Studio e riavvia il sistema** 1. Chiudi tutte le istanze in esecuzione di Visual Studio. 1. Dal menu di avvio di Windows, avvia **Visual Studio Installer**. 1. Esegui Repair sulle installazioni interessate di Visual Studio. Ciò consente a Visual Studio di ricostruire l'indice delle estensioni installate. 1. Riavvia Windows prima di riavviare Visual Studio. **Come individuare i log del Toolkit AWS** 1. Dal menu principale di Visual Studio, espandi **Estensioni**. 1. **Scegli il **AWS Toolkit** per espandere il menu AWS Toolkit, quindi scegli Visualizza i registri del Toolkit.** 1. 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 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 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**. 1. Dal riquadro **Elenco errori**, fai clic con il pulsante destro del mouse sulla riga di intestazione per aprire il menu contestuale. 1. Dal menu contestuale, espandi **Mostra colonne**, quindi seleziona **Strumento** nel menu espanso. 1. La colonna **Strumento** viene aggiunta all’**Elenco errori**. 1. 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 \$1452](https://github.com/aws/aws-toolkit-visual-studio/issues/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. 1. Chiudi tutte le istanze in esecuzione di Visual Studio. 1. Da Windows, apri il **Developer Command Prompt** come amministratore. 1. Dal **prompt dei comandi dello sviluppatore**, esegui il seguente comando:`devenv /updateconfiguration /resetExtensions`, quindi attendi il completamento del comando. 1. Al termine del comando, riavvia Visual Studio. 1. 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](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](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-ca_bundle) Guida per l'*AWS Command Line Interface*utente 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` and`NODE_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**. 1. **Dal menu **Opzioni**, espandi **AWS Toolkit**, quindi scegli Proxy.** 1. Dal menu **Proxy**, definisci l'**Host** e la **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](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-proxy.html) l'*AWS Command Line Interface*utente. 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](https://learn.microsoft.com/en-us/windows-server/identity/ad-cs/export-certificate-private-key) all'indirizzo *learn.microsoft.com*. *Per informazioni dettagliate sulle chiavi delle variabili di ambiente Windows, consulta la documentazione di [Node.js](https://nodejs.org/api/cli.html#cli_node_extra_ca_certs_file) 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](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/endpoints.html) 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](https://docs.aws.amazon.com//amazonq/latest/qdeveloper-ug/firewall.html#corp-proxy) *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 [AWS Toolkit for Visual Studio dei problemi del repository](https://github.com/aws/aws-toolkit-visual-studio/issues). 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.