Memecahkan masalah AWS Toolkit for Visual Studio - AWS Toolkit dengan Amazon Q
Memecahkan masalah praktik terbaikMelihat dan memfilter pemindaian keamanan Amazon QAWS Toolkit tidak diinstal dengan benarPengaturan firewall dan proxy

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memecahkan masalah AWS Toolkit for Visual Studio

Bagian berikut berisi informasi pemecahan masalah umum tentang AWS Toolkit for Visual Studio dan bekerja dengan AWS layanan dari toolkit.

catatan

Informasi set-up-specific penginstalan dan pemecahan masalah tersedia di topik Masalah penginstalan Pemecahan Masalah, yang terdapat di Panduan Pengguna ini.

Memecahkan masalah praktik terbaik

Berikut ini adalah praktik terbaik yang disarankan saat memecahkan masalah AWS Toolkit for Visual Studio .

  • Perbaiki Visual Studio dan restart sistem Anda

  • Cobalah untuk membuat ulang masalah atau kesalahan Anda sebelum mengirim laporan.

  • Buat catatan rinci dari setiap langkah, pengaturan, dan pesan kesalahan selama proses rekreasi.

  • Kumpulkan AWS Log Toolkit. Untuk penjelasan rinci tentang cara menemukan log AWS Toolkit Anda, lihat prosedur Cara menemukan AWS log Anda, yang terletak di topik panduan ini.

  • Periksa permintaan terbuka, solusi yang diketahui, atau laporkan masalah Anda yang belum terselesaikan di bagian AWS Toolkit for Visual Studio Masalah di AWS Toolkit for Visual Studio GitHub repositori.

Perbaiki Visual Studio dan Restart sistem Anda

  1. Tutup semua instance Visual Studio yang sedang berjalan.

  2. Dari menu mulai Windows, Luncurkan Visual Studio Installer.

  3. Jalankan Perbaikan pada instalasi Visual Studio yang terpengaruh. Ini memungkinkan Visual Studio untuk membangun kembali indeks ekstensi yang diinstal.

  4. Mulai ulang Windows sebelum meluncurkan kembali Visual Studio.

Cara menemukan log AWS Toolkit Anda

  1. Dari menu utama Visual Studio, perluas Ekstensi.

  2. Pilih AWS Toolkit untuk memperluas menu AWS Toolkit, lalu pilih View Toolkit Logs.

  3. Saat folder log AWS Toolkit terbuka di Sistem Operasi Anda, urutkan file berdasarkan tanggal dan temukan file log apa pun yang berisi informasi yang relevan dengan masalah Anda saat ini.

Melihat dan memfilter pemindaian keamanan Amazon Q

Untuk melihat pemindaian keamanan Amazon Q Anda di Visual Studio, buka Daftar Kesalahan Visual Studio dengan memperluas judul Tampilan di menu utama Visual Studio dan memilih Daftar Kesalahan.

Secara default, Daftar Kesalahan Visual Studio menampilkan semua peringatan dan kesalahan untuk basis kode Anda. Untuk memfilter temuan pemindaian keamanan Amazon Q Anda dari Daftar Kesalahan Visual Studio, buat filter dengan menyelesaikan prosedur berikut.

catatan

Temuan pemindaian keamanan Amazon Q hanya terlihat setelah pemindaian keamanan berjalan dan mendeteksi masalah.

Temuan pemindaian keamanan Amazon Q muncul sebagai peringatan di Visual Studio. Untuk melihat temuan pemindaian keamanan Amazon Q dari Daftar Kesalahan Anda, opsi Peringatan di judul Daftar Kesalahan harus dipilih.

  1. Dari menu utama Visual Studio, perluas judul Tampilan dan pilih Daftar Kesalahan untuk membuka panel Daftar Kesalahan.

  2. Dari panel Daftar Kesalahan, klik kanan baris header untuk membuka menu konteks.

  3. Dari menu konteks, perluas Tampilkan Kolom, lalu pilih Alat di menu yang diperluas.

  4. Kolom Alat ditambahkan ke Daftar Kesalahan Anda.

  5. Dari header kolom Alat, pilih ikon Filter dan pilih Amazon Q untuk memfilter temuan pemindaian keamanan Amazon Q.

AWS Toolkit tidak diinstal dengan benar

Masalah:

Dalam satu menit setelah memulai Visual Studio, pesan berikut muncul di panel output dan bilah info, masing-masing: 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.

Solusi:

Ada kemungkinan bahwa memperbarui atau menginstal ekstensi menyebabkan beberapa file cache internal Visual Studio pergi out-of-sync. Prosedur berikut menjelaskan cara membuat file-file ini dibangun kembali saat Anda meluncurkan Visual Studio berikutnya.

catatan

Ada kemungkinan bahwa solusi ini dapat memengaruhi penyesuaian Visual Studio Anda. Setelah menyelesaikan prosedur ini, ekstensi AWS Toolkit harus terdaftar sebagai diinstal dan tidak lagi melaporkan pesan kesalahan. Jika Anda terus mengalami masalah ini setelah menyelesaikan langkah-langkah berikut, silakan lihat Masalah #452 di AWS Toolkit for Visual Studio GitHub repositori untuk informasi tambahan.

  1. Instal versi terbaru Visual Studio 2022.

    catatan

    Versi minimum yang diperlukan adalah 17.11.5.

  2. Tutup semua instance Visual Studio yang sedang berjalan.

  3. Dari Windows, buka Prompt Perintah Pengembang sebagai Administrator.

  4. Dari Developer Command Prompt, jalankan perintah berikut:devenv /updateconfiguration /resetExtensions, lalu tunggu sampai perintah selesai.

  5. Setelah perintah selesai, restart Visual Studio.

  6. Di Visual Studio AWS ekstensi sekarang terdaftar sebagai diinstal dan tidak lagi melaporkan pesan kesalahan yang tercantum di bagian atas masalah ini.

Pengaturan firewall dan proxy

Memecahkan masalah firewall dan pengaturan proxy

Perangkat lunak pemindaian keamanan dapat mengganggu kemampuan Anda untuk mengunduh file dari server bahasa AWS Toolkit dengan menghapus file dari unduhan atau mencegah unduhan sama sekali.

Untuk memeriksa pengaturan firewall dan proxy Anda, navigasikan ke https://aws-toolkit-language-servers.amazonaws.com/codewhisperer/0/manifest.json dari browser internet yang diinstal pada sistem yang sama dengan instance Visual Studio Anda. Jika Anda mengalami kesalahan atau halaman tidak dapat dimuat, maka mungkin ada firewall atau filter proxy yang mencegah Anda menjangkauaws-toolkit-language-servers.amazonaws.com.

Sertifikat kustom

AWS Toolkit for Visual Studio Menggunakan server bahasa yang berjalan pada runtime Node.js. Untuk informasi terperinci tentang cara memeriksa apakah jaringan Anda menggunakan sertifikat kustom, lihat pengaturan Konfigurasi dan file kredensi dalam AWS CLI topik di Panduan AWS Command Line InterfacePengguna untuk Versi 1.

Untuk mengonfigurasi pengaturan proxy Anda dan menentukan sertifikat, Anda harus mengonfigurasi variabel HTTPS_PROXY env Anda dan membuat Variabel Lingkungan Windows untuk NODE_EXTRA_CA_CERTS kunci NODE_OPTIONS dan.

Untuk mengonfigurasi variabel HTTPS_PROXY env Anda, selesaikan langkah-langkah berikut.

  1. Dari menu utama Visual Studio, pilih Tools, lalu pilih Options.

  2. Dari menu Options, perluas AWS Toolkit, lalu pilih Proxy.

  3. Dari menu Proxy, tentukan Host dan Port Anda.

catatan

Untuk informasi tentang mengonfigurasi HTTPS_PROXY dari AWS CLI, lihat Menggunakan proxy HTTP untuk AWS CLI topik di Panduan AWS Command Line InterfacePengguna.

Buat Variabel Lingkungan Windows untuk kunci berikut.

  • NODE_OPTIONS = --use-openssl-ca

  • NODE_EXTRA_CA_CERTS = Path/To/Corporate/Certs

catatan

Untuk informasi selengkapnya tentang mengekstrak sertifikat akar perusahaan, lihat artikel Ekspor sertifikat dengan kunci privatnya di learn.microsoft.com. Untuk informasi rinci tentang kunci Variabel Lingkungan Windows, lihat dokumentasi Node.js v23.3.0 di nodejs.org.

Izinkan daftar dan langkah-langkah tambahan

Selain mengganggu server bahasa AWS Toolkit, pengaturan firewall dapat mencegah Amazon Q mengunggah ke Amazon S3 dan memanggil API layanan. Untuk meminimalkan potensi kesalahan ini, sebaiknya izinkan akses internet keluar pada port 443 (HTTPS) untuk titik akhir berikut:

  • 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

Untuk daftar detail titik akhir, lihat topik Memperbarui firewall dan gateway untuk mengizinkan akses dalam Panduan Pengguna ini. Jika Anda terus mengalami masalah firewall dan proxy, kumpulkan Log AWS Toolkit Anda dan hubungi AWS Toolkit for Visual Studio tim melalui bagian AWS Toolkit for Visual Studio masalah di AWS Toolkit for Visual Studio GitHub repositori. Untuk detail tentang mengumpulkan Log AWS Toolkit Anda, tinjau informasi di bagian Pemecahan Masalah praktik terbaik dari topik Panduan Pengguna ini.