Memasang debugger jarak jauh

Dokumen ini menjelaskan cara melampirkan debugger jarak jauh Visual Studio ke proses di Virtual Machine 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 Anda tidak ingin mengaktifkan koneksi Remote PowerShell, atau jika tidak diinstal di VM, Anda dapat menemukan langkah-langkah untuk menginstal Alat Jarak Jauh Debugger Visual Studio secara manual dengan menelusuri MSDN Visual Studio Remote Debugging.

    • Anda juga dapat menambahkan aturan firewall untuk membuka blokir port Alat Jarak Jauh Debugger.

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

Memasang debugger jarak jauh

Untuk melampirkan 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 hubungkan ke debugger jarak jauh, lalu pilih Attach debugger.

    Wizard attach debugger akan 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 berikut:

  • Saat pertama kali Anda terhubung ke instance VM jarak jauh, wizard akan menginstal Visual Studio Debugger Remote Tools untuk Anda. Penginstalan ini dapat memakan waktu beberapa saat 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 Anda men-debug aplikasi, pilih Debug > Windows > Modules.

    2. Temukan assembly yang sedang di-debug.

    3. Klik kanan entri yang sesuai, lalu pilih Load Symbols.

Membuka port firewall

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

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

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. Hapus centang pada kotak centang untuk aturan firewall Allow Visual Studio Debugger connections to the instance dan Allow Remote PowerShell HTTPs traffic to the instance.

  4. Klik Simpan untuk menghapus aturan firewall.