Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Résolution des problèmes liés au AWS Toolkit for Visual Studio Les sections suivantes contiennent des informations générales de résolution des problèmes concernant AWS Toolkit for Visual Studio les AWS services du kit d'outils et son utilisation. **Note** Les informations d'installation et de set-up-specific dépannage sont disponibles dans la rubrique [Résolution des problèmes d'installation](https://docs.aws.amazon.com//toolkit-for-visual-studio/latest/user-guide/setup-troubleshoot.html), située dans ce guide de l'utilisateur. **Topics** + [Bonnes pratiques de résolution des problèmes](#general-troubleshoot-best-practice) + [Affichage et filtrage des scans de sécurité Amazon Q](#general-troubleshoot-Q-securityscan) + [Le AWS kit d'outils n'est pas correctement installé](#general-troubleshoot-component-initilization) + [Paramètres du pare-feu et du proxy](#general-troubleshoot-firewall) ## Bonnes pratiques de résolution des problèmes Les meilleures pratiques recommandées pour résoudre les AWS Toolkit for Visual Studio problèmes sont les suivantes. + Réparez Visual Studio et redémarrez votre système + Essayez de recréer votre problème ou votre erreur avant d'envoyer un rapport. + Prenez des notes détaillées sur chaque étape, chaque réglage et chaque message d'erreur pendant le processus de recréation. + Collectez les journaux du AWS kit d'outils Pour une description détaillée de la localisation des journaux de votre AWS boîte à outils, consultez la procédure [Comment localiser vos AWS journaux](#general-troubleshoot-procedure-logs), qui se trouve dans cette rubrique du guide. + Vérifiez les demandes ouvertes, les solutions connues ou signalez votre problème non résolu dans la section [AWS Toolkit for Visual Studio Problèmes](https://github.com/aws/aws-toolkit-visual-studio/issues) du AWS Toolkit for Visual Studio GitHub référentiel. **Réparez Visual Studio et redémarrez votre système** 1. Fermez toutes les instances en cours d'exécution de Visual Studio. 1. Dans le menu Démarrer de Windows, lancez **Visual Studio Installer**. 1. Exécutez la réparation sur les installations concernées de Visual Studio. Cela permet à Visual Studio de reconstruire son index des extensions installées. 1. Redémarrez Windows avant de relancer Visual Studio. **Comment localiser les journaux de votre AWS boîte à outils** 1. Dans le menu principal de Visual Studio, développez **Extensions**. 1. Choisissez le **AWS kit d'outils** pour développer le menu du AWS kit d'outils, puis choisissez **Afficher les journaux du kit d'outils**. 1. Lorsque le dossier des journaux du AWS Toolkit s'ouvre dans votre système d'exploitation, triez les fichiers par date et recherchez tout fichier journal contenant des informations relatives à votre problème actuel. ## Affichage et filtrage des scans de sécurité Amazon Q Pour consulter vos scans de sécurité Amazon Q dans Visual Studio, ouvrez la **liste des erreurs** de Visual Studio en développant l'en-tête **Afficher** dans le menu principal de Visual Studio et en choisissant **Liste des erreurs**. Par défaut, la **liste des erreurs** de Visual Studio affiche tous les avertissements et erreurs relatifs à votre base de code. Pour filtrer les résultats de votre analyse de sécurité Amazon Q à partir de la **liste d'erreurs** de Visual Studio, créez un filtre en suivant la procédure suivante. **Note** Les résultats de l'analyse de sécurité Amazon Q ne sont visibles qu'une fois que l'analyse de sécurité a été exécutée et qu'un problème a été détecté. Les résultats du scan de sécurité Amazon Q apparaissent sous forme d'avertissements dans Visual Studio. Pour consulter les résultats du scan de sécurité Amazon Q à partir de votre **liste d'erreurs**, l'option **Avertissements** dans le titre **Liste d'erreurs** doit être sélectionnée. 1. Dans le menu principal de Visual Studio, développez l'en-tête **Afficher** et choisissez **Liste d'erreurs** pour ouvrir le volet **Liste d'erreurs**. 1. Dans le volet **Liste d’erreurs**, cliquez avec le bouton droit sur la ligne d’en-tête pour ouvrir le menu contextuel. 1. Dans le menu contextuel, développez **Afficher les colonnes**, puis sélectionnez **Outil** dans le menu développé. 1. La colonne **Outil** est ajoutée à votre **liste d’erreurs**. 1. Dans l'en-tête de la colonne **Outil**, sélectionnez l'icône **Filtre** et choisissez Amazon Q pour filtrer les résultats du scan de sécurité Amazon Q. ## Le AWS kit d'outils n'est pas correctement installé **Problème** : Dans la minute qui suit le démarrage de Visual Studio, AWS Toolkit for Visual Studio les messages suivants apparaissent respectivement dans le volet de sortie et dans la barre d'informations : `Some Toolkit components could not be initialized. Some functionality may not work during this IDE session.` `The AWS Toolkit is not properly installed.` **Solution :** Il est possible que la mise à jour ou l'installation d'une extension aient entraîné la disparition de certains fichiers de cache internes de Visual Studio out-of-sync. La procédure suivante décrit comment faire reconstruire ces fichiers lors du prochain lancement de Visual Studio. **Note** Il est possible que cette solution ait un impact sur vos personnalisations de Visual Studio. Une fois cette procédure terminée, l'extension AWS Toolkit doit être répertoriée comme étant installée et ne plus signaler de message d'erreur. Si vous continuez à rencontrer ce problème après avoir effectué les étapes suivantes, consultez le [numéro \$1452](https://github.com/aws/aws-toolkit-visual-studio/issues/452) dans le AWS Toolkit for Visual Studio GitHub référentiel pour plus d'informations. 1. Installez la dernière version de Visual Studio 2022. **Note** La version minimale requise est 17.11.5. 1. Fermez toutes les instances en cours d'exécution de Visual Studio. 1. Depuis Windows, ouvrez l'**invite de commande du développeur** en tant qu'administrateur. 1. À partir de l'**invite de commande du développeur**, exécutez la commande suivante :`devenv /updateconfiguration /resetExtensions`, puis attendez que la commande soit terminée. 1. Une fois la commande terminée, redémarrez Visual Studio. 1. Dans Visual Studio, l' AWS extension est désormais répertoriée comme installée et ne signale plus les messages d'erreur répertoriés en haut de ce problème. ## Paramètres du pare-feu et du proxy ### Résolution des problèmes liés aux paramètres du pare-feu et du proxy Les logiciels d'analyse de sécurité peuvent interférer avec votre capacité à télécharger des fichiers depuis les serveurs linguistiques du AWS Toolkit en supprimant des fichiers des téléchargements ou en les empêchant complètement. Pour vérifier les paramètres de votre pare-feu et de votre proxy, accédez à [https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json](https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json) depuis un navigateur Internet installé sur le même système que votre instance de Visual Studio. Si vous rencontrez une erreur ou si la page ne parvient pas à se charger, il se peut qu'un pare-feu ou un filtre proxy vous empêche d'y accéder`aws-toolkit-language-servers.amazonaws.com`. ### Certificats personnalisés AWS Toolkit for Visual Studio utilise un serveur de langue qui s'exécute sur le runtime Node.js. Pour obtenir des informations détaillées sur la façon de vérifier si votre réseau utilise un certificat personnalisé, consultez le [paramètre du fichier de configuration et d'identification dans la AWS CLI rubrique du](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html#cli-config-ca_bundle) Guide de l'*AWS Command Line Interface*utilisateur de la version 1. Pour configurer vos paramètres de proxy et définir un certificat, vous devez configurer votre variable `HTTPS_PROXY` d'environnement et créer des variables d'environnement Windows pour les `NODE_EXTRA_CA_CERTS` clés `NODE_OPTIONS` et. Pour configurer votre `HTTPS_PROXY` variable d'environnement, procédez comme suit. 1. Dans le menu principal de Visual Studio, choisissez **Outils**, puis **Options**. 1. Dans le menu **Options**, développez **AWS Toolkit**, puis choisissez **Proxy**. 1. Dans le menu **Proxy**, définissez votre **hôte** et votre **port**. **Note** Pour plus d'informations sur la configuration du `HTTPS_PROXY` depuis AWS CLI, reportez-vous [à la AWS CLI rubrique Utilisation d'un proxy HTTP du](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-proxy.html) Guide de l'*AWS Command Line Interface*utilisateur. Créez des variables d'environnement Windows pour les clés suivantes. + `NODE_OPTIONS = --use-openssl-ca` + `NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs` **Note** Pour plus d'informations sur l'extraction des certificats racines d'entreprise, consultez l'article [Exporter un certificat avec sa clé privée](https://learn.microsoft.com/en-us/windows-server/identity/ad-cs/export-certificate-private-key) sur *learn.microsoft.com*. *Pour des informations détaillées sur les clés des variables d'environnement Windows, consultez la [documentation Node.js v23.3.0](https://nodejs.org/api/cli.html#cli_node_extra_ca_certs_file) sur nodejs.org.* ### Autoriser la mise en vente et les étapes supplémentaires En plus d'interférer avec les serveurs linguistiques du AWS Toolkit, les paramètres du pare-feu peuvent empêcher Amazon Q de procéder au téléchargement vers Amazon S3 et d'appeler l'API du service. Pour minimiser le risque de ces erreurs, nous recommandons d'autoriser l'accès Internet sortant sur le **port 443 (HTTPS)** pour les points de terminaison suivants : + `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` Pour obtenir une liste détaillée des points de terminaison, consultez la rubrique [Mettre à jour les pare-feux et les passerelles pour autoriser l'accès](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/endpoints.html) dans ce guide de l'utilisateur. Pour obtenir des informations détaillées sur la configuration d'un proxy d'entreprise pour Amazon Q, consultez la rubrique [Configuration d'un proxy d'entreprise dans Amazon Q](https://docs.aws.amazon.com//amazonq/latest/qdeveloper-ug/firewall.html#corp-proxy) du manuel *Amazon Q Developer User Guide*. Si vous continuez à rencontrer des problèmes de pare-feu et de proxy, collectez les journaux de votre AWS boîte à outils et contactez l' AWS Toolkit for Visual Studio équipe via la section des [AWS Toolkit for Visual Studio problèmes](https://github.com/aws/aws-toolkit-visual-studio/issues) du AWS Toolkit for Visual Studio GitHub référentiel. Pour en savoir plus sur la collecte des journaux de votre AWS boîte à outils, consultez les informations de la section **Bonnes pratiques de résolution** des problèmes de cette rubrique du guide de l'utilisateur.