Debug Jarak Jauh ASP.NET Core di Azure App Service (Windows)

Artikel ini menjelaskan cara melampirkan debugger Visual Studio ke aplikasi ASP.NET Core yang berjalan di Azure App Service. Langkah-langkah berikut memungkinkan Anda untuk men-debug aplikasi seolah-olah berjalan secara lokal.

Prasyarat

• Visual Studio 2022 dengan ASP.NET dan pengembangan web serta beban kerja pengembangan Azure terinstal.

• Anda harus terlebih dahulu menyebarkan aplikasi ASP.NET Core ke Azure App Service (Windows) dari Visual Studio, dan aplikasi harus berjalan.

  Untuk pelatihan langsung yang menyertakan penyebaran App Service, lihat Debug jarak jauh ASP.NET Core di Azure.

• Profil publikasi Anda di Visual Studio harus diatur ke Debug alih-alih Rilis sebelum menerbitkan.

Mengaktifkan penelusuran kesalahan jarak jauh

Sebelum Anda dapat mendebug masalah ini dengan Visual Studio, Anda harus mengaktifkan fitur penelusuran kesalahan jarak jauh di App Service. Pengaturan ini memungkinkan debugger Visual Studio untuk terhubung ke proses hosting web App Service utama.

1. Masuk ke portal Azure Anda sendiri.

   Temukan aplikasi yang Anda sebarkan di portal Microsoft Azure. Anda dapat menemukan aplikasi dengan menelusuri ke halaman App Services lalu memilih instans App Service. Anda juga dapat mencari instans App Service secara langsung berdasarkan nama di bilah pencarian di bagian atas. (Dalam contoh ini, instans App Service diberi nama GitHubBrowser123.)

   

2. Pada halaman pengaturan untuk instans App Service, pilih Konfigurasi di navigasi kiri, lalu pilih tab Pengaturan Umum.

3. Di bagian bawah halaman, pastikan untuk mengatur fitur Penelusuran Kesalahan Jarak Jauh ke Aktif dan pilih Visual Studio 2022 sebagai versi Visual Studio Jarak Jauh.

   

4. Pilih Simpan di bagian atas halaman untuk menyimpan perubahan Anda.

Instans layanan aplikasi Anda sekarang mendukung penelusuran kesalahan jarak jauh melalui Visual Studio.

Mengonfigurasi pengaturan debug

1. Buat aplikasi Anda tanpa kesalahan. Hentikan aplikasi Anda jika berjalan secara lokal.

   Catatan

   Pastikan status kode lokal Anda cocok dengan apa yang disebarkan ke Azure. Hal ini memastikan bahwa file simbol lokal dan kode sumber sejalan dengan aplikasi yang disebarkan.

2. Pilih Opsi Debug > dari menu Visual Studio atas. Pastikan bahwa Aktifkan Hanya Kode saya tidak dicentang (seperti yang ditunjukkan di bawah), lalu pilih OK.

   Mengubah pengaturan ini memungkinkan Visual Studio men-debug kode yang dioptimalkan yang disebarkan ke Azure menggunakan file simbol yang diperlukan dari folder bin lokal Anda. File simbol digunakan oleh debugger sebagai jembatan antara kode yang dikompilasi dan mengeksekusi dan kode sumber di Visual Studio. File simbol yang cocok diperlukan untuk penelusuran kesalahan jarak jauh.

   

Melampirkan debugger ke App Service

1. Dari menu utama di bagian atas Visual Studio, pilih Lampirkan Debug > untuk diproses untuk membuka dialog yang sesuai. Dengan menggunakan jendela ini Anda dapat menghubungkan dan melampirkan ke target yang berbeda. Dalam hal ini, Anda akan terhubung ke instans App Service yang Anda buat di langkah sebelumnya.

2. Pilih drop down Tipe Koneksi dan pilih opsi Microsoft Azure App Services.

3. Pilih Temukan.. di sebelah bidang Target Koneksi untuk membuka dialog yang memungkinkan Anda menelusuri langganan Azure dan layanan aplikasi.

   Jika Anda belum masuk dengan langganan Azure Anda, pilih Temukan... lalu Anda bisa masuk.

4. Temukan dan pilih instans App Service yang Anda buat di langkah sebelumnya, lalu pilih OK.

5. Proses w3wp.exe akan muncul dalam daftar proses yang tersedia untuk disambungkan. w3wp.exe adalah proses utama Azure App Service yang menghosting aplikasi yang disebarkan. Pilih proses lalu w3wp.exe pilih Lampirkan di kanan bawah.

   

6. Dalam file aplikasi C# seperti Index.cshtml.cs, atur titik henti dengan mengklik di margin kiri. Atau, klik kanan dan pilih Titik Henti>Sisipkan titik henti.

7. Di aplikasi web, navigasikan ke titik akhir dengan titik henti. Jika Anda dilampirkan ke proses tetapi tidak dapat mencapai titik henti, pastikan profil publikasi Anda di Visual Studio diatur ke konfigurasi Debug alih-alih konfigurasi Rilis.

8. Opsional: Untuk memverifikasi bahwa Visual Studio telah memuat file simbol untuk sesi penelusuran kesalahan Anda. Navigasikan ke Debug > Windows> Modul untuk membuka jendela modul. Jendela ini menunjukkan bahwa file simbol berhasil dimuat setelah perubahan konfigurasi Just my code yang Anda buat sebelumnya.

   

Catatan

Untuk penelusuran kesalahan layanan aplikasi berikutnya, pilih pilih Debug Lampirkan>Ulang untuk w3wp.exe atau gunakan tombol panas Shift+Alt+P.