Memasang debugger jarak jauh

Dokumen ini menjelaskan cara memasang debugger jarak jauh Visual Studio ke proses pada Mesin Virtual Compute Engine yang menjalankan Windows.

Prasyarat

Sebelum memulai, pastikan mesin virtual Anda memenuhi prasyarat berikut:

  • Menjalankan sistem operasi Windows

  • Memiliki alamat IP publik

  • Telah menginstal dan mengaktifkan Remote PowerShell

    • Jika tidak ingin mengaktifkan koneksi Remote PowerShell, atau jika tidak diinstal pada VM, Anda dapat menemukan langkah-langkah untuk menginstal Visual Studio Debugger Remote Tools secara manual dengan menelusuri MSDN Visual Studio Remote Debugging.

    • Anda juga dapat menambahkan aturan firewall untuk berhenti memblokir port Debugger Remote Tool.

Anda dapat men-deploy image framework ASP.NET yang memenuhi semua prasyarat ini.

Memasang debugger jarak jauh

Untuk memasang debugger jarak jauh:

  1. Pilih Tools > Google Cloud Tools > Show Google Cloud Explorer untuk meluncurkan Cloud Explorer.

  2. Klik kanan instance VM Compute Engine yang ingin Anda pasang debugger jarak jauh, lalu pilih Attach debugger.

    Wizard debugger ditampilkan.

  3. Klik OK saat diminta untuk menambahkan aturan firewall guna mengizinkan traffic ke port yang diperlukan.

    1. Link Pelajari lebih lanjut dalam dialog akan mengarahkan Anda ke bagian Membuka port firewall untuk mengetahui informasi selengkapnya.

  4. Pilih proses yang akan di-debug, lalu klik OK.

Perhatikan hal-hal berikut:

  • Saat pertama kali terhubung ke instance VM jarak jauh, wizard menginstal Alat Jarak Jauh Debugger Visual Studio untuk Anda. Instalasi ini membutuhkan waktu jika VM berada di region yang berbeda.

  • Alat debugger diinstal di Program Files\VisualStudioRemoteTools pada mesin target.

  • Anda harus memuat simbol secara manual jika mengoptimalkan build rilis:

    1. Saat men-debug aplikasi, pilih Debug > Windows > Modules.

    2. Temukan assembly debuggee Anda.

    3. Klik kanan entri yang sesuai dan pilih Load Symbols.

Membuka port firewall

Untuk mengaktifkan proses debug jarak jauh, Anda harus menambahkan aturan firewall untuk mengizinkan traffic ke mesin target dan mengaktifkan koneksi ke Alat Jarak Jauh Debugging. Untuk Visual Studio 2017, port-nya adalah 4022.

Cloud Tools for Visual Studio dapat menginstal dan memulai alat jarak jauh secara otomatis menggunakan koneksi PowerShell jarak jauh. Anda harus mengaktifkan port PowerShell HTTPs jarak jauh terlebih dahulu 5986.

Setelah selesai melakukan proses debug, hapus aturan firewall:

  1. Pilih Tools > Google Cloud Tools > Show Google Cloud Explorer untuk meluncurkan Cloud Explorer.

  2. Klik kanan instance VM Compute Engine, lalu pilih Firewall Options....

  3. Kosongkan kotak centang untuk Allow Visual Studio Debugger connections to the instance dan Allow Remote PowerShell HTTPs traffic to the instance.

  4. Klik Save untuk menghapus aturan firewall.