View a markdown version of this page

Problembehandlung bei AWS Toolkit for Visual Studio - AWS Toolkit mit Amazon Q
Bewährte Methoden zur FehlerbehebungAmazon Q-Sicherheitsscans anzeigen und filternDas Tool AWS Das Toolkit ist nicht richtig installiertFirewall- und Proxy-Einstellungen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Problembehandlung bei AWS Toolkit for Visual Studio

Die folgenden Abschnitte enthalten allgemeine Informationen zur Problembehandlung mit den AWS Diensten aus dem Toolkit AWS Toolkit for Visual Studio und der Arbeit mit ihnen.

Anmerkung

Installations- und einrichtungsspezifische Informationen zur Problembehandlung finden Sie im Thema Problembehandlung bei Installationsproblemen in diesem Benutzerhandbuch.

Bewährte Methoden zur Fehlerbehebung

Im Folgenden werden bewährte Methoden zur Behebung von AWS Toolkit for Visual Studio Problemen empfohlen.

  • Reparieren Sie Visual Studio und starten Sie Ihr System neu

  • Versuchen Sie, Ihr Problem oder Ihren Fehler zu reproduzieren, bevor Sie einen Bericht senden.

  • Machen Sie sich während des Neuerstellungsvorgangs detaillierte Notizen zu jedem Schritt, jeder Einstellung und jeder Fehlermeldung.

  • Sammeln Sie AWS Toolkit-Protokolle. Eine ausführliche Beschreibung, wie Sie Ihre AWS Toolkit-Logs finden, finden Sie in der Prozedur So finden Sie Ihre AWS Logs, die Sie in diesem Handbuch finden.

  • Suchen Sie nach offenen Anfragen und bekannten Lösungen oder melden Sie Ihr ungelöstes Problem im Abschnitt AWS Toolkit for Visual Studio Probleme des AWS Toolkit for Visual Studio GitHub Repositorys.

Reparieren Sie Visual Studio und starten Sie Ihr System neu

  1. Schließen Sie alle laufenden Instanzen von Visual Studio.

  2. Starten Sie den Visual Studio Installer über das Windows-Startmenü.

  3. Führen Sie Repair für die betroffenen Installationen von Visual Studio aus. Dadurch kann Visual Studio seinen Index der installierten Erweiterungen neu erstellen.

  4. Starten Sie Windows neu, bevor Sie Visual Studio neu starten.

So finden Sie Ihre AWS Toolkit-Protokolle

  1. Erweitern Sie im Visual-Studio-Hauptmenü die Option Erweiterungen.

  2. Wählen Sie das AWS Toolkit, um das Toolkit-Menü zu erweitern, und wählen Sie dann AWS Toolkit-Logs anzeigen.

  3. Wenn der AWS Toolkit-Protokollordner in Ihrem Betriebssystem geöffnet wird, sortieren Sie die Dateien nach Datum und suchen Sie nach jeder Protokolldatei, die Informationen enthält, die für Ihr aktuelles Problem relevant sind.

Amazon Q-Sicherheitsscans anzeigen und filtern

Um Ihre Amazon Q-Sicherheitsscans in Visual Studio anzuzeigen, öffnen Sie die Visual Studio-Fehlerliste, indem Sie im Hauptmenü von Visual Studio die Überschrift Ansicht erweitern und Fehlerliste auswählen.

In der Fehlerliste von Visual Studio werden standardmäßig alle Warnungen und Fehler für Ihre Codebasis angezeigt. Um die Ergebnisse Ihrer Amazon Q-Sicherheitsscans aus der Visual Studio-Fehlerliste zu filtern, erstellen Sie einen Filter, indem Sie das folgende Verfahren ausführen.

Anmerkung

Die Ergebnisse des Amazon Q-Sicherheitsscans sind erst sichtbar, nachdem der Sicherheitsscan ausgeführt und Probleme festgestellt wurden.

Die Ergebnisse des Amazon Q-Sicherheitsscans werden in Visual Studio als Warnungen angezeigt. Um die Ergebnisse der Amazon Q-Sicherheitsscans aus Ihrer Fehlerliste anzuzeigen, muss die Option „Warnungen“ in der Überschrift „Fehlerliste“ ausgewählt werden.

  1. Erweitern Sie im Hauptmenü von Visual Studio die Überschrift Ansicht und wählen Sie Fehlerliste, um den Bereich Fehlerliste zu öffnen.

  2. Klicken Sie im Bereich Fehlerliste mit der rechten Maustaste auf die Kopfzeile, um das Kontextmenü zu öffnen.

  3. Erweitern Sie im Kontextmenü die Option „Spalten anzeigen“ und wählen Sie dann im erweiterten Menü die Option Tool aus.

  4. Die Spalte Tool wird Ihrer Fehlerliste hinzugefügt.

  5. Wählen Sie in der Tool-Spaltenüberschrift das Filtersymbol aus und wählen Sie Amazon Q aus, um nach den Ergebnissen der Amazon Q-Sicherheitsscans zu filtern.

Das Tool AWS Das Toolkit ist nicht richtig installiert

Problem:

Innerhalb einer Minute nach dem Start von Visual Studio werden AWS Toolkit for Visual Studio die folgenden Meldungen im Ausgabebereich bzw. in der Infoleiste angezeigt:

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

The AWS Toolkit is not properly installed.

Lösung:

Es ist möglich, dass das Aktualisieren oder Installieren einer Erweiterung dazu geführt hat, dass einige der internen Cachedateien von Visual Studio nicht mehr synchronisiert wurden. Das folgende Verfahren beschreibt, wie Sie diese Dateien beim nächsten Start von Visual Studio neu erstellen lassen.

Anmerkung

Es ist möglich, dass sich diese Lösung auf Ihre Visual Studio-Anpassungen auswirkt. Nach Abschluss dieses Verfahrens sollte die AWS Toolkit-Erweiterung als installiert aufgeführt werden und keine Fehlermeldung mehr melden. Wenn dieses Problem nach Abschluss der folgenden Schritte weiterhin auftritt, finden Sie weitere Informationen in Ausgabe #452 im AWS Toolkit for Visual Studio GitHub Repository.

  1. Installieren Sie die neueste Version von Visual Studio 2022.

    Anmerkung

    Die erforderliche Mindestversion ist 17.11.5.

  2. Schließen Sie alle laufenden Instanzen von Visual Studio.

  3. Öffnen Sie unter Windows die Entwickler-Eingabeaufforderung als Administrator.

  4. Führen Sie in der Entwickler-Befehlszeile den folgenden Befehl aus:devenv /updateconfiguration /resetExtensions, und warten Sie dann, bis der Befehl abgeschlossen ist.

  5. Starten Sie Visual Studio neu, nachdem der Befehl abgeschlossen ist.

  6. In Visual Studio wird die AWS Erweiterung jetzt als installiert aufgeführt und meldet nicht mehr die oben in diesem Problem aufgeführten Fehlermeldungen.

Firewall- und Proxy-Einstellungen

Problembehandlung bei Firewall- und Proxyeinstellungen

Security-scanning Software kann Ihre Fähigkeit beeinträchtigen, Dateien von AWS Toolkit-Sprachservern herunterzuladen, indem Dateien aus Downloads entfernt oder Downloads ganz verhindert werden.

Um Ihre Firewall- und Proxyeinstellungen zu überprüfen, navigieren Sie https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json von einem Internetbrowser aus, der auf demselben System wie Ihre Visual Studio-Instanz installiert ist. Wenn Sie auf einen Fehler stoßen oder die Seite nicht geladen werden kann, verhindert möglicherweise eine Firewall oder ein Proxyfilter, dass Sie die Seite nicht erreichen könnenaws-toolkit-language-servers.amazonaws.com.

Benutzerdefinierte Zertifikate

Der AWS Toolkit for Visual Studio verwendet einen Sprachserver, der auf der Node.js Runtime läuft. Ausführliche Informationen darüber, wie Sie überprüfen können, ob Ihr Netzwerk ein benutzerdefiniertes Zertifikat verwendet, finden Sie unter den Einstellungen für die Konfiguration und Anmeldeinformationsdatei im AWS CLI Thema im AWS Command Line Interface Benutzerhandbuch für Version 1.

Um Ihre Proxyeinstellungen zu konfigurieren und ein Zertifikat zu definieren, müssen Sie Ihre HTTPS_PROXY env-Variable konfigurieren und Windows-Umgebungsvariablen für die Schlüssel NODE_OPTIONS und NODE_EXTRA_CA_CERTS erstellen.

Gehen Sie wie folgt vor, um Ihre HTTPS_PROXY env-Variable zu konfigurieren.

  1. Wählen Sie im Visual-Studio-Hauptmenü Tools und anschließend Optionen aus.

  2. Erweitern Sie im Optionsmenü die Option AWS Toolkit und wählen Sie dann Proxy.

  3. Definieren Sie im Proxy-Menü Ihren Host und Port.

Anmerkung

Informationen zur Konfiguration des HTTPS_PROXY AWS CLI von finden Sie unter Verwenden eines HTTP-Proxys für das AWS CLI Thema im AWS Command Line Interface Benutzerhandbuch.

Erstellen Sie Windows-Umgebungsvariablen für die folgenden Schlüssel.

  • NODE_OPTIONS = --use-openssl-ca

  • NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs

Anmerkung

Weitere Informationen zum Extrahieren von Unternehmensstammzertifikaten finden Sie im Artikel Exportieren eines Zertifikats mit seinem privaten Schlüssel auf learn.microsoft.com. Detaillierte Informationen zu den Schlüsseln der Windows-Umgebungsvariablen finden Sie in der Dokumentation zu Node.js Version 23.3.0 auf nodejs.org.

Erlaube das Auflisten und zusätzliche Schritte

Firewall-Einstellungen stören nicht nur die AWS Toolkit-Sprachserver, sondern können auch verhindern, dass Amazon Q auf Amazon S3 hochlädt und die Service-API aufruft. Um das Potenzial dieser Fehler zu minimieren, empfehlen wir, den ausgehenden Internetzugang über Port 443 (HTTPS) für die folgenden Endpunkte zuzulassen:

  • 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

Eine ausführliche Liste der Endpunkte finden Sie im Thema Aktualisieren von Firewalls und Gateways, um den Zugriff zu ermöglichen, in diesem Benutzerhandbuch. Detaillierte Informationen zur Konfiguration eines Unternehmens-Proxys für Amazon Q finden Sie im Thema Konfiguration eines Unternehmens-Proxys in Amazon Q im Amazon Q Developer User Guide. Wenn Sie weiterhin auf Firewall- und Proxy-Probleme stoßen, sammeln Sie Ihre AWS Toolkit-Logs und wenden Sie sich über den AWS Toolkit for Visual Studio Problembereich des AWS Toolkit for Visual Studio GitHub Repositorys an das AWS Toolkit for Visual Studio Team. Einzelheiten zur Erfassung Ihrer AWS Toolkit-Logs finden Sie im Abschnitt „Bewährte Methoden zur Fehlerbehebung“ in diesem Thema im Benutzerhandbuch.