のトラブルシューティング AWS Toolkit for Visual Studio - AWS Amazon Q を使用したツールキット
トラブルシューティングのベストプラクティスAmazon Q セキュリティスキャンの表示とフィルタリングAWS ツールキットが正しくインストールされていないファイアウォールとプロキシの設定

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

のトラブルシューティング AWS Toolkit for Visual Studio

以下のセクションでは、 に関する一般的なトラブルシューティング情報 AWS Toolkit for Visual Studio と、 ツールキットの AWS サービスの使用について説明します。

注記

インストールおよびセットアップ固有のトラブルシューティング情報については、このユーザーガイドの「インストールに関する問題のトラブルシューティング」トピックを参照してください。

トラブルシューティングのベストプラクティス

AWS Toolkit for Visual Studio に関する問題のトラブルシューティングに推奨されるベストプラクティスを以下に示します。

  • Visual Studio を修復してシステムを再起動する

  • レポートを送信する前に、問題またはエラーの再現を試してください。

  • 再現プロセス中に、各ステップ、設定、エラーメッセージを詳細にメモしてください。

  • AWS Toolkit Logs を収集します。Toolkit ログの検索 AWS 方法の詳細については、このガイドトピックにあるAWS ログの検索方法の手順を参照してください。

  • 未解決のリクエストや既知の解決策がないかを確認するか、 AWS Toolkit for Visual Studio GitHub リポジトリのAWS Toolkit for Visual Studio 「問題」セクションで未解決の問題を報告します。

Visual Studio を修復してシステムを再起動する

  1. Visual Studio で実行中のすべてのインスタンスを閉じます。

  2. Windows のスタートメニューから、Visual Studio インストーラー を起動します。

  3. 影響を受けている Visual Studio のインストールで修復を実行します。これにより、Visual Studio はインストールされた拡張機能のインデックスを再構築できます。

  4. Visual Studio を再起動する前に、Windows を再起動してください。

Toolkit AWS ログを見つける方法

  1. Visual Studio のメインメニューから [Extensions] を展開します。

  2. Toolkit AWS を選択して AWS Toolkit メニューを展開し、View Toolkit Logs を選択します。

  3. AWS Toolkit Logs フォルダがオペレーティングシステムで開いたら、ファイルを日付でソートし、現在の問題に関連する情報を含むログファイルを見つけます。

Amazon Q セキュリティスキャンの表示とフィルタリング

Visual Studio で Amazon Q セキュリティスキャンを表示するには、Visual Studio のメインメニューで [表示] の見出しを展開し、[エラー一覧] を選択して、Visual Studio の [エラー一覧] を開きます。

デフォルトでは、Visual Studio の [エラー一覧] には、コードベースのすべての警告とエラーが表示されます。Visual Studio の [エラー一覧] で Amazon Q セキュリティスキャンの検出結果をフィルタリングするには、次の手順を実行してフィルターを作成します。

注記

Amazon Q セキュリティスキャンの検出結果は、セキュリティスキャンが実行され、問題が検出された後にのみ表示されます。

Amazon Q セキュリティスキャンの検出結果は、Visual Studio では警告として表示されます。[エラー一覧] で Amazon Q セキュリティスキャンの検出結果を表示するには、[エラー一覧] の見出しの [警告] オプションを選択する必要があります。

  1. Visual Studio のメインメニューで [表示] の見出しを展開し、次に [エラー一覧] を選択して [エラー一覧] ペインを開きます。

  2. [エラー一覧] ペインで、ヘッダー行を右クリックしてコンテキストメニューを開きます。

  3. コンテキストメニューから [列の表示] を展開し、展開したメニューで [ツール] を選択します。

  4. [ツール] 列が [エラー一覧] に追加されます。

  5. [ツール] 列ヘッダーで [フィルター] アイコンをクリックし、[Amazon Q] を選択して Amazon Q セキュリティスキャンの検出結果をフィルタリングします。

AWS ツールキットが正しくインストールされていない

問題:

Visual Studio を起動してから 1 分以内に、出力ペインと情報バーにそれぞれ AWS Toolkit for Visual Studio 次のメッセージが表示されます。

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

The AWS Toolkit is not properly installed.

解決策:

拡張機能の更新またはインストールによって、Visual Studio の内部キャッシュファイルの一部が同期しなくなった可能性があります。次の手順で、次回 Visual Studio を起動するときにこれらのファイルを再構築する方法について説明します。

注記

この解決策は、Visual Studio のカスタマイズに影響を与える可能性があります。この手順を完了すると、 AWS Toolkit 拡張機能はインストール済みとしてリストされ、エラーメッセージは報告されなくなります。次のステップを完了した後もこの問題が解決しない場合は、 AWS Toolkit for Visual Studio GitHub リポジトリの「問題 #452」を参照してください。

  1. Visual Studio 2022 の最新バージョンをインストールします。

    注記

    最小必須バージョンは 17.11.5 です。

  2. Visual Studio で実行中のすべてのインスタンスを閉じます。

  3. Windows で、管理者として [Developer Command Prompt] を開きます。

  4. [Developer Command Prompt] から、devenv /updateconfiguration /resetExtensions コマンドを実行し、コマンドが完了するのを待ちます。

  5. コマンドが完了したら、Visual Studio を再起動します。

  6. Visual Studio では、 AWS 拡張機能がインストール済みとしてリストされ、この問題の上部にリストされているエラーメッセージは報告されなくなりました。

ファイアウォールとプロキシの設定

ファイアウォールとプロキシの設定のトラブルシューティング

セキュリティスキャンソフトウェアは、ダウンロードフォルダからファイルを削除したり、ダウンロード自体をブロックしたりすることで、 AWS Toolkit 言語サーバーからのファイルのダウンロードを妨げる可能性があります。

ファイアウォールとプロキシの設定を確認するには、Visual Studio のインスタンスと同じシステムにインストールされているインターネットブラウザから https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json に移動します。エラーが発生したり、ページが読み込まれない場合は、ファイアウォールまたはプロキシフィルターによって aws-toolkit-language-servers.amazonaws.com に到達できない可能性があります。

カスタム証明書

は、Node.js ランタイムで実行される言語サーバー AWS Toolkit for Visual Studio を使用します。ネットワークでカスタム証明書が使用されているかどうかを確認する方法の詳細については 「AWS Command Line Interface ユーザーガイド」バージョン 1 の「AWS CLIの設定と認証情報ファイルの設定」のトピックを参照してください。

プロキシ設定を構成して証明書を定義するには、HTTPS_PROXY 環境変数を設定し、NODE_OPTIONS キーと NODE_EXTRA_CA_CERTS キー用の Windows 環境変数を作成する必要があります。

HTTPS_PROXY 環境変数を構成するには、次の手順を実行します。

  1. Visual Studio のメインメニューで、[ツール]、[オプション] の順に選択します。

  2. [オプション] メニューで、[AWS Toolkit] を展開して、[プロキシ] を選択します。

  3. [プロキシ] メニューから、[ホスト] と [ポート] を定義します。

注記

HTTPS_PROXY から を設定する方法については AWS CLI、「 AWS Command Line Interfaceユーザーガイド」の「 の HTTP プロキシ AWS CLIの使用」を参照してください。

次のキーの Windows 環境変数を作成します。

  • NODE_OPTIONS = --use-openssl-ca

  • NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs

注記

企業のルート証明書の抽出方法の詳細については、learn.microsoft.com の「Export a certificate with its private key」の記事をご覧ください。Windows 環境変数のキーの詳細については、nodejs.org の Node.js v23.3.0 のドキュメントをご覧ください。

許可リストへの登録と追加ステップ

Toolkit AWS 言語サーバーとの干渉に加えて、ファイアウォール設定により、Amazon Q が Amazon S3 にアップロードしてサービス API を呼び出すことを防ぐことができます。これらのエラーの可能性を最小限に抑えるため、以下のエンドポイントに対して、ポート 443 (HTTPS) でのアウトバウンドインターネットアクセスを許可することをお勧めします。

  • 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

エンドポイントの詳細なリストについては、このユーザーガイドの「アクセスを許可するファイアウォールとゲートウェイの更新」のトピックを参照してください。Amazon Q の企業プロキシの設定の詳細については、「Amazon Q Developer ユーザーガイド」の「Amazon Q での企業プロキシの設定」のトピックを参照してください。ファイアウォールとプロキシの問題が引き続き発生する場合は、 AWS Toolkit Logs を収集し、 AWS Toolkit for Visual Studio GitHub リポジトリAWS Toolkit for Visual Studio の問題セクションを通じて AWS Toolkit for Visual Studio チームに連絡してください。 AWS Toolkit Logs の収集の詳細については、このユーザーガイドトピックの「トラブルシューティングのベストプラクティス」セクションの情報を参照してください。