Bagikan melalui


Debug Jarak Jauh ASP.NET Core di IIS menggunakan Azure VM dari Visual Studio

Panduan ini menjelaskan cara menyiapkan dan mengonfigurasi aplikasi Visual Studio ASP.NET Core, menyebarkannya ke IIS menggunakan Azure VM, dan melampirkan debugger jarak jauh dari Visual Studio.

Untuk skenario IIS, Linux tidak didukung.

Untuk men-debug IIS di Azure VM, ikuti langkah-langkah dalam artikel ini. Dengan menggunakan metode ini, Anda dapat menggunakan konfigurasi IIS yang disesuaikan, tetapi langkah-langkah penyiapan dan penyebaran lebih rumit. Jika Anda tidak perlu menyesuaikan IIS untuk skenario Anda, Anda dapat memilih metode yang lebih sederhana untuk menghosting dan men-debug aplikasi di Azure App Service sebagai gantinya.

Untuk Azure VM, Anda harus menyebarkan aplikasi dari Visual Studio ke Azure dan Anda juga perlu menginstal peran IIS dan debugger jarak jauh secara manual, seperti yang ditunjukkan dalam ilustrasi berikut.

diagram memperlihatkan hubungan antara Visual Studio, Azure VM, dan aplikasi ASP.NET. IIS dan Remote Debugger diwakili dengan garis solid.

Peringatan

Pastikan untuk menghapus sumber daya Azure yang Anda buat ketika Anda telah menyelesaikan langkah-langkah dalam tutorial ini. Dengan begitu Anda dapat menghindari dikenakan biaya yang tidak perlu.

Prosedur ini telah diuji pada konfigurasi server ini:

  • Windows Server 2022 dan IIS 10
  • Windows Server 2019 dan IIS 10
  • Windows Server 2016 dan IIS 10

Prasyarat

Visual Studio 2019 atau versi yang lebih baru diperlukan untuk mengikuti langkah-langkah yang ditampilkan dalam artikel ini.

Persyaratan jaringan

Pemecahan masalah (debugging) antara dua komputer yang terhubung melalui proksi tidak didukung. Debugging melalui koneksi dengan latensi tinggi atau bandwidth rendah, seperti Internet dialup, atau melalui Internet yang melintasi negara/wilayah, tidak disarankan dan mungkin gagal atau tidak dapat diterima jika lambat. Untuk daftar lengkap persyaratan, lihat persyaratan .

Aplikasi sudah berjalan di IIS di Azure VM?

Artikel ini mencakup langkah-langkah dalam menyiapkan konfigurasi dasar IIS di server Windows dan menyebarkan aplikasi dari Visual Studio. Langkah-langkah ini disertakan untuk memastikan bahwa server telah menginstal komponen yang diperlukan, bahwa aplikasi dapat berjalan dengan benar, dan Anda siap untuk debug jarak jauh.

  • Jika aplikasi Anda berjalan di IIS dan Anda hanya ingin mengunduh debugger jarak jauh dan mulai debugging, lanjutkan ke Unduh dan Instal alat jarak jauh di Windows Server.

  • Jika Anda ingin membantu memastikan aplikasi Anda disiapkan, disebarkan, dan berjalan dengan benar di IIS sehingga Anda dapat men-debug, ikuti semua langkah dalam artikel ini.

    • Sebelum memulai, ikuti semua langkah yang dijelaskan di Membuat windows Virtual Machine, yang mencakup langkah-langkah untuk menginstal server web IIS.

    • Pastikan Anda membuka port 80 di grup keamanan Azure Network. Saat Anda memverifikasi bahwa port 80 terbuka, buka juga port benar untuk debugger jarak jauh (4026, 4024, atau 4022). Dengan begitu, Anda tidak perlu membukanya nanti. Jika Anda menggunakan Web Deploy, buka juga port 8172.

Membuat aplikasi ASP.NET Core di komputer Visual Studio

  1. Buat aplikasi web ASP.NET Core baru.

    Di Visual Studio, pilih jendela File>Mulai untuk membuka jendela Mulai, lalu pilih Buat proyek baru. Dalam kotak pencarian, ketik aplikasi web , lalu pilih C# sebagai bahasa, lalu pilih ASP.NET Core Web Application (Model-View-Controller), lalu pilih Next. Pada layar berikutnya, beri nama proyek myASPApp, lalu pilih Berikutnya.

    Pilih kerangka kerja target yang direkomendasikan atau .NET 8, lalu pilih Buat. Versi harus cocok dengan versi yang diinstal pada server.

  2. Buka file HomeController.cs di folder Pengontrol dan atur titik henti dalam pernyataan return View; dalam metode Privacy.

    Di templat yang lebih lama, buka file Privacy.cshtml.cs dan atur titik henti dalam metode OnGet.

Memperbarui pengaturan keamanan browser di Windows Server

Jika Anda menggunakan versi Windows Server yang lebih lama, Anda mungkin perlu menambahkan beberapa domain sebagai situs tepercaya untuk memungkinkan Anda mengunduh beberapa komponen server web. Tambahkan situs tepercaya dengan membuka Opsi Internet > Keamanan > Situs Tepercaya > Situs. Tambahkan domain berikut.

  • microsoft.com
  • go.microsoft.com
  • download.microsoft.com
  • iis.net

Saat mengunduh perangkat lunak, Anda mungkin mendapatkan permintaan untuk memberikan izin untuk memuat berbagai skrip dan sumber daya situs web. Beberapa sumber daya ini tidak diperlukan, tetapi untuk menyederhanakan proses, pilih Tambahkan saat diminta.

Menginstal ASP.NET Core di Windows Server

  1. Instal .NET Core Hosting Bundle pada sistem hosting. Bundel menginstal .NET Core Runtime, .NET Core Library, dan ASP.NET Core Module. Untuk petunjuk lebih mendalam, lihat bagian Penerbitan ke IIS.

    Untuk bundel hosting .NET Core saat ini, instal ASP.NET Core Hosting Bundle.

    Nota

    Jika sebelumnya Anda menginstal IIS, Modul IIS Inti ASP.NET akan diinstal dengan ASP.NET Core. Jika tidak, instal Modul IIS Inti ASP.NET secara manual.

    Untuk .NET Core 2, instal .NET Core Windows Server Hosting.

    Nota

    Jika sistem tidak memiliki koneksi Internet, dapatkan dan instal Microsoft Visual C++ 2015 Redistributable sebelum menginstal bundel Hosting Windows Server .NET Core.

  2. Hidupkan ulang sistem (atau jalankan net stop adalah /y diikuti oleh net start w3svc dari prompt perintah untuk mengambil perubahan pada PATH sistem).

Pilih opsi penyebaran

Jika Anda memerlukan bantuan untuk menyebarkan aplikasi ke IIS, pertimbangkan opsi berikut:

  • Sebarkan dengan membuat file pengaturan penerbitan di IIS dan mengimpor pengaturan di Visual Studio. Dalam beberapa skenario, pendekatan ini adalah cara cepat untuk menyebarkan aplikasi Anda. Saat Anda membuat file pengaturan penerbitan, izin secara otomatis disiapkan di IIS.

  • Sebarkan dengan menerbitkan ke folder lokal dan menyalin output dengan metode pilihan ke folder aplikasi yang disiapkan di IIS.

(Opsional) Menyebarkan menggunakan file pengaturan penerbitan

Anda dapat menggunakan opsi ini membuat file pengaturan penerbitan dan mengimpornya ke Visual Studio.

Nota

Metode penyebaran ini menggunakan Web Deploy, yang harus diinstal pada server. Jika Anda ingin mengonfigurasi Web Deploy secara manual alih-alih mengimpor pengaturan, Anda dapat menginstal Web Deploy 3.6 alih-alih Web Deploy 3.6 untuk Server Hosting. Namun, jika Anda mengonfigurasi Web Deploy secara manual, Anda harus memastikan bahwa folder aplikasi di server dikonfigurasi dengan nilai dan izin yang benar (lihat Mengonfigurasi situs Web ASP.NET).

Mengonfigurasi situs web ASP.NET Core

  1. Di Manajer IIS, di panel kiri di bawah koneksi , pilih Kumpulan Aplikasi. Buka DefaultAppPool dan atur versi .NET CLR ke Tanpa Kode Terkelola. Ini diperlukan untuk ASP.NET Core. Situs Web Default menggunakan DefaultAppPool.

  2. Hentikan dan mulai ulang DefaultAppPool.

Menginstal dan mengonfigurasi Web Deploy di Windows Server

Web Deploy menyediakan fitur konfigurasi tambahan yang memungkinkan pembuatan file pengaturan penerbitan dari UI.

Nota

Penginstal Platform Web mencapai Akhir Masa Pakai pada 7/1/22. Untuk informasi selengkapnya, lihat Penginstal Platform Web - Akhir dukungan dan penghentian aliran produk/aplikasi. Anda dapat langsung menginstal Web Deploy 4.0 untuk membuat file pengaturan penerbitan.

  1. Jika Anda belum menginstal IIS Management Scripts and Tools, instal sekarang.

    Buka Pilih peran server>Web Server (IIS)>Alat Manajemen, lalu pilih peran Skrip dan Alat Manajemen IIS, klik Berikutnya, lalu instal peran tersebut.

    Menginstal Skrip dan Alat Manajemen IIS

    Skrip dan alat diperlukan untuk mengaktifkan pembuatan file pengaturan penerbitan.

    Pastikan Anda juga menginstal Management Service dan IIS Management Console (mungkin sudah terinstal).

  2. Di Windows Server, mengunduh Web Deploy 4.0.

  3. Jalankan program penginstalan Web Deploy, dan pastikan Anda memilih Selesaikan penginstalan alih-alih penginstalan umum.

    Dengan penginstalan lengkap, Anda mendapatkan komponen yang Anda butuhkan untuk membuat file pengaturan penerbitan. (Jika Anda memilih Kustom, Anda dapat melihat daftar komponen, sebagaimana diperlihatkan dalam ilustrasi berikut.)

    Cuplikan layar memperlihatkan komponen Web Deploy 4.0

  4. (Opsional) Verifikasi bahwa Penyebaran Web berjalan dengan benar dengan membuka Control Panel > System and Security > Administrative Tools > Services, lalu pastikan bahwa:

    • Layanan Agen Penyebaran Web berjalan (nama layanan berbeda dalam versi yang lebih lama).

    • Layanan Manajemen Web sedang berjalan.

    Jika salah satu layanan agen tidak berjalan, restart (mulai ulang) layanan Layanan Agen Penyebaran Web.

    Jika Layanan Agen Penyebaran Web tidak ada sama sekali, buka Control Panel > Program > Hapus instalan program, temukan Microsoft Web Deploy versi <>. Pilih untuk Ubah penginstalan dan pastikan Anda memilih Akan diinstal ke hard drive lokal untuk komponen Web Deploy. Selesaikan langkah-langkah penginstalan perubahan.

Membuat file pengaturan penerbitan di IIS di Windows Server

  1. Tutup dan buka kembali Konsol Manajemen IIS untuk menampilkan opsi konfigurasi yang diperbarui di UI.

  2. Di IIS, klik kanan Situs Web Default, pilih Penyebaran>Mengonfigurasi Penyebaran Penerbitan Web.

    Mengonfigurasi konfigurasi Web Deploy

    Jika Anda tidak melihat menu Sebarkan, lihat bagian sebelumnya untuk memverifikasi bahwa Penyebaran Web sedang berjalan.

  3. Dalam kotak dialog Pengonfigurasian Penerbitan Web Deploy, periksa pengaturan.

  4. Klik Penyetelan.

    Di panel Hasil, output menunjukkan bahwa hak akses diberikan kepada pengguna yang ditentukan, dan bahwa file dengan .publishsettings ekstensi file telah dihasilkan di lokasi yang ditampilkan dalam kotak dialog.

    <?xml version="1.0" encoding="utf-8"?>
    <publishData>
      <publishProfile
        publishUrl="https://myhostname:8172/msdeploy.axd"
        msdeploySite="Default Web Site"
        destinationAppUrl="http://myhostname:80/"
        profileName="Default Settings"
        publishMethod="MSDeploy"
        userName="myhostname\myusername" />
    </publishData>
    

    Bergantung pada konfigurasi Windows Server dan IIS, Anda akan melihat nilai yang berbeda dalam file XML. Berikut adalah beberapa detail tentang nilai yang Anda lihat:

    • File msdeploy.axd yang dirujuk dalam atribut publishUrl adalah file handler HTTP yang dihasilkan secara dinamis untuk Web Deploy. (Untuk tujuan pengujian, http://myhostname:8172 umumnya juga berfungsi.)

    • Port publishUrl diatur ke port 8172, yang merupakan default untuk Web Deploy.

    • Port destinationAppUrl diatur ke port 80, yang merupakan default untuk IIS.

    • Jika, di langkah selanjutnya, Anda tidak dapat tersambung ke host jarak jauh dari Visual Studio menggunakan nama host, uji alamat IP server sebagai pengganti nama host.

      Nota

      Jika Anda menerbitkan ke IIS yang berjalan di Azure VM, Anda harus membuka port masuk untuk Web Deploy dan IIS di grup Keamanan Jaringan. Untuk informasi terperinci, lihat Buka port ke komputer virtual.

  5. Salin file ini ke komputer tempat Anda menjalankan Visual Studio.

Impor pengaturan penerbitan di Visual Studio dan sebarkan

  1. Di komputer tempat Anda membuka proyek ASP.NET di Visual Studio, klik kanan proyek di Penjelajah Solusi, dan pilih Terbitkan.

    Jika sebelumnya Anda telah mengonfigurasi profil penerbitan apa pun, panel Terbitkan akan muncul. Klik Baru atau Buat profil baru.

  2. Pilih opsi untuk mengimpor profil.

    Dalam kotak dialog Terbitkan, klik Impor Profil.

    Pilih Terbitkan

  3. Navigasi ke lokasi file pengaturan penerbitan yang Anda buat di bagian sebelumnya.

  4. Dalam dialog Impor File Pengaturan Terbitkan, navigasikan ke profil yang Anda buat di bagian sebelumnya, lalu pilih, dan klik Buka.

    Klik Selesai untuk menyimpan profil penerbitan, lalu klik Terbitkan.

    Visual Studio memulai proses penyebaran, dan jendela Output menampilkan kemajuan dan hasil.

    Jika Anda mengalami kesalahan penyebaran, klik Tindakan Lainnya>Edit untuk mengedit pengaturan. Ubah pengaturan dan klik Validasi untuk menguji pengaturan baru. Jika nama host tidak ditemukan, coba alamat IP alih-alih nama host di Server dan URL Tujuan.

    Sunting pengaturan di alat penerbitan

Nota

Jika Anda menghidupkan ulang Azure VM, alamat IP mungkin berubah.

Setelah aplikasi berhasil disebarkan, aplikasi akan dimulai secara otomatis.

  • Jika aplikasi tidak dimulai setelah penyebaran, mulai aplikasi di IIS untuk memverifikasi bahwa aplikasi berjalan dengan benar.
  • Untuk ASP.NET Core, pastikan bidang Kumpulan Aplikasi untuk DefaultAppPool diatur ke Tanpa Kode Terkelola.

Saat Anda siap, beralihlah ke konfigurasi debug.

Penting

Jika Anda memilih untuk men-debug konfigurasi Rilis, Anda menonaktifkan penelusuran kesalahan di file web.config saat Menerbitkan.

  1. Pilih Opsi Lainnya>Edit untuk mengedit profil, lalu pilih Pengaturan .
  2. Pilih Simpan lalu terbitkan ulang aplikasi.
  3. Pilih konfigurasi Debug, lalu pilih Hapus file tambahan di tujuan di bawah opsi Terbitkan File.
  1. Pilih Edit untuk mengedit profil, lalu pilih Pengaturan .
  2. Pilih Simpan lalu terbitkan ulang aplikasi.
  3. Pilih konfigurasi Debug, lalu pilih Hapus file tambahan di tujuan di bawah opsi Terbitkan File.

Peringatan

Menggunakan kredensial nama pengguna dan kata sandi (autentikasi dasar) bukanlah metode autentikasi yang paling aman. Jika memungkinkan, gunakan metode alternatif. Misalnya, pertimbangkan untuk menerbitkan ke paket dari Visual Studio, lalu gunakan WebDeploy.exe dari baris perintah untuk menyebarkan paket. Dengan metode tersebut, Anda dapat menggunakan IIS Manager untuk mengonfigurasi pengguna Windows resmi yang dapat menerbitkan ke server web, dan menjalankan WebDeploy.exe di bawah akun pengguna Windows tersebut. Lihat Menginstal dan Mengonfigurasi Penyebaran Web di IIS 8.0 atau yang lebih baru. Jika Anda menggunakan kredensial kata sandi, pastikan untuk menggunakan kata sandi yang kuat, dan amankan kata sandi agar tidak bocor atau dibagikan.

(Opsional) Menyebarkan dengan menerbitkan ke folder lokal

Anda dapat menggunakan opsi ini untuk menyebarkan aplikasi jika ingin menyalin aplikasi ke IIS menggunakan PowerShell, RoboCopy, atau Anda ingin menyalin file secara manual.

Mengonfigurasi situs Web ASP.NET Core pada komputer Windows Server

Jika Anda mengimpor pengaturan penerbitan, Anda bisa melewati bagian ini.

  1. Buka Manajer Layanan Informasi Internet (IIS) dan buka situs .

  2. Klik kanan pada node Situs Web Default dan pilih Tambahkan Aplikasi.

  3. Atur bidang Alias ke MyASPApp dan bidang Kumpulan aplikasi ke Tanpa Kode Terkelola. Atur jalur fisik ke C:\Publish (tempat Anda kemudian menyebarkan proyek ASP.NET Core).

  4. Dengan situs yang dipilih di Manajer IIS, pilih Edit Izin, dan pastikan bahwa IUSR, IIS_IUSRS, atau pengguna yang dikonfigurasi untuk Kumpulan Aplikasi adalah pengguna yang berwenang dengan hak Baca & Jalankan.

    Jika Anda tidak melihat salah satu pengguna ini dengan akses, lakukan langkah-langkah untuk menambahkan IUSR sebagai pengguna dengan hak Baca & Jalankan.

Penting

Untuk informasi keamanan yang terkait dengan akun bawaan, lihat Memahami Akun Pengguna dan Grup Built-In di IIS 7.

(Opsional) Menerbitkan dan Menyebarkan aplikasi dengan menerbitkan ke folder lokal dari Visual Studio

Jika Anda tidak menggunakan Web Deploy, Anda harus menerbitkan dan menyebarkan aplikasi menggunakan sistem file atau alat lainnya. Anda dapat memulai dengan membuat paket menggunakan sistem file, lalu menyebarkan paket secara manual atau menggunakan alat lain seperti PowerShell, Robocopy, atau XCopy. Di bagian ini, kami berasumsi Anda menyalin paket secara manual jika Anda tidak menggunakan Web Deploy.

  1. Di Penjelajah Solusi, klik kanan simpul proyek dan pilih Terbitkan (untuk Formulir Web, Terbitkan Aplikasi Web).

    Jika sebelumnya Anda telah mengonfigurasi profil penerbitan apa pun, panel Terbitkan akan muncul. Klik Profil baru.

  2. Dalam kotak dialog Terbitkan, pilih Folder, klik Telusuri, dan buat folder baru, C:\Terbitkan.

    Cuplikan layar dialog Pilih target penerbitan di Visual Studio dengan Folder 'C:\Publish' dipilih sebagai target penerbitan.

    Klik Selesai untuk menyimpan profil publikasi.

    Cuplikan layar dialog Pilih target penerbitan di Visual Studio dengan Folder 'C:\Publish' dipilih sebagai target penerbitan.

    Klik Selesai untuk menyimpan profil publikasi.

  3. Beralih ke konfigurasi debug.

    Pilih Edit untuk mengedit profil, lalu pilih Pengaturan . Pilih konfigurasi Debug, lalu pilih Hapus file tambahan di tujuan di bawah opsi Terbitkan File.

    Cuplikan layar tab Pengaturan dalam kotak dialog Terbitkan. Konfigurasi diatur ke Debug dan tombol Terbitkan dipilih.

    Nota

    Jika Anda menggunakan build Rilis, Anda menonaktifkan penelusuran kesalahan di file web.config saat Anda menerbitkan.

  4. Klik Terbitkan.

    Aplikasi menerbitkan Debug konfigurasi proyek ke folder lokal. Kemajuan ditampilkan di jendela Output.

  5. Salin direktori proyek ASP.NET dari komputer Visual Studio ke direktori lokal yang dikonfigurasi untuk aplikasi ASP.NET (dalam contoh ini, C:\Terbitkan) di komputer Windows Server. Dalam tutorial ini, kami berasumsi Anda menyalin secara manual, tetapi Anda dapat menggunakan alat lain seperti PowerShell, Xcopy, atau Robocopy.

    Perhatian

    Jika Anda perlu membuat perubahan pada kode atau membangun kembali, Anda harus menerbitkan ulang dan mengulangi langkah ini. Executable yang Anda salin ke komputer jarak jauh harus sama persis dengan sumber dan simbol lokal Anda. Jika Anda tidak melakukan ini, Anda akan menerima peringatan cannot find or open the PDB file di Visual Studio saat Anda mencoba men-debug proses.

  6. Di Windows Server, verifikasi bahwa Anda dapat menjalankan aplikasi dengan benar dengan membuka aplikasi di browser Anda.

    Jika aplikasi tidak berjalan dengan benar, mungkin ada ketidakcocokan antara versi ASP.NET yang diinstal di server dan komputer Visual Studio Anda, atau Anda mungkin mengalami masalah dengan konfigurasi situs IIS atau Web Anda. Cek ulang langkah-langkah sebelumnya.

Mengunduh dan Menginstal alat jarak jauh di Windows Server

Unduh versi alat jarak jauh yang cocok dengan versi Visual Studio Anda.

Pada perangkat jarak jauh atau server yang ingin Anda debug, bukan komputer Visual Studio, unduh dan instal versi alat jarak jauh yang benar dari tautan dalam tabel berikut.

  • Unduh pembaruan terbaru alat jarak jauh untuk versi Visual Studio Anda. Versi alat jarak jauh sebelumnya tidak kompatibel dengan versi Visual Studio yang lebih baru. (Misalnya, jika Anda menggunakan Visual Studio 2019, unduh pembaruan terbaru alat jarak jauh untuk Visual Studio 2019. Dalam skenario ini, jangan unduh alat jarak jauh untuk Visual Studio 2022.)
  • Unduh alat jarak jauh dengan arsitektur yang sama dengan komputer tempat Anda menginstalnya. Misalnya, jika Anda ingin men-debug aplikasi x86 di komputer jarak jauh yang menjalankan sistem operasi x64, instal alat jarak jauh x64. Untuk men-debug aplikasi x86, ARM, atau x64 pada sistem operasi ARM64, instal alat jarak jauh ARM64.
Versi Tautan Catatan
Visual Studio 2022 Alat jarak jauh Kompatibel dengan semua versi Visual Studio 2022. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64 (AMD64), atau ARM64). Pada versi Windows Server yang lebih lama, lihat Membuka blokir unduhan file untuk panduan mengunduh alat jarak jauh.
Visual Studio 2019 Alat jarak jauh Alat jarak jauh untuk Visual Studio 2019 tersedia dari My.VisualStudio.com. Jika diminta, bergabunglah dengan program Visual Studio Dev Essentials gratis, atau masuk dengan ID langganan Visual Studio Anda. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64 (AMD64), atau ARM64). Pada versi Windows Server yang lebih lama, lihat Cara membuka blokir unduhan file untuk panduan mengunduh alat-alat jarak jauh.
Visual Studio 2017 Alat jarak jauh Alat jarak jauh untuk Visual Studio 2017 tersedia dari My.VisualStudio.com. Jika diminta, bergabunglah dengan program Visual Studio Dev Essentials gratis, atau masuk dengan ID langganan Visual Studio Anda. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64 (AMD64), atau ARM64). Di Windows Server, lihat Membuka blokir unduhan file untuk mendapatkan bantuan dalam mengunduh alat-alat jarak jauh.
Visual Studio 2015 Alat jarak jauh Alat jarak jauh untuk Visual Studio 2015 tersedia dari My.VisualStudio.com. Jika diminta, bergabunglah dengan program Visual Studio Dev Essentials gratis, atau masuk dengan ID langganan Visual Studio Anda. Di Windows Server, lihat Membuka blokir unduhan alat untuk bantuan mengunduh alat jarak jauh.
Visual Studio 2013 Alat jarak jauh Halaman unduhan di dokumentasi Visual Studio 2013
Visual Studio 2012 Alat jarak jauh Halaman unduhan di dokumentasi Visual Studio 2012
Versi Tautan Catatan
Visual Studio 2019 Alat jarak jauh Kompatibel dengan semua versi Visual Studio 2019. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64 (AMD64), atau ARM64). Di Windows Server, lihat Membuka blokir file unduhan untuk bantuan mengunduh alat-alat jarak jauh. Untuk versi terbaru alat jarak jauh, buka dokumen Visual Studio 2022.
Visual Studio 2017 Alat jarak jauh Kompatibel dengan semua versi Visual Studio 2017. Unduh versi yang cocok dengan sistem operasi perangkat Anda (x86, x64 (AMD64), atau ARM64). Di Windows Server, lihat "Membuka blokir unduhan file" untuk bantuan mengunduh alat-alat kendali jarak jauh.
Visual Studio 2015 Alat jarak jauh Alat jarak jauh untuk Visual Studio 2015 tersedia dari My.VisualStudio.com. Jika diminta, bergabunglah dengan program Visual Studio Dev Essentials gratis, atau masuk dengan ID langganan Visual Studio Anda. Di Windows Server, lihat Membuka blokir unduhan file untuk bantuan mengunduh alat jarak jauh.
Visual Studio 2013 Alat jarak jauh Halaman unduhan di dokumentasi Visual Studio 2013
Visual Studio 2012 Alat jarak jauh Halaman unduhan di dokumentasi Visual Studio 2012

Anda dapat menjalankan debugger jarak jauh dengan menyalin msvsmon.exe ke komputer jarak jauh, daripada menginstal alat jarak jauh. Namun, Panduan Konfigurasi Debugger Jarak Jauh (rdbgwiz.exe) hanya tersedia saat Anda menginstal alat jarak jauh. Anda mungkin perlu menggunakan wizard untuk konfigurasi jika Anda ingin menjalankan debugger jarak jauh sebagai layanan. Untuk informasi selengkapnya, lihat (Opsional) Mengonfigurasi debugger jarak jauh sebagai layanan.

Nota

  • Untuk men-debug aplikasi Windows 10 atau yang lebih baru di perangkat ARM, gunakan ARM64, yang tersedia dengan versi terbaru alat jarak jauh.
  • Untuk men-debug aplikasi Windows 10 di perangkat Windows RT, gunakan ARM, yang hanya tersedia di unduhan alat jarak jauh Visual Studio 2015.
  • Untuk men-debug aplikasi x64 pada sistem operasi ARM64, jalankan msvsmon.exe x64 yang diinstal dengan alat jarak jauh ARM64.

Menyiapkan debugger jarak jauh di Windows Server

  1. Di komputer jarak jauh, temukan dan mulai Remote Debugger dari menu Start.

    Jika Anda tidak memiliki izin administratif di komputer jarak jauh, klik kanan aplikasi Remote Debugger dan pilih Jalankan sebagai administrator. Jika tidak, mulai saja secara normal.

    Jika Anda berencana untuk mengaitkan ke proses yang dijalankan sebagai administrator, atau dijalankan dengan akun pengguna lain (seperti IIS), klik kanan aplikasi Remote Debugger dan pilih Jalankan sebagai administrator. Untuk informasi selengkapnya, lihat Menjalankan debugger jarak jauh sebagai administrator.

  2. Pertama kali Anda memulai debugger jarak jauh (atau sebelum Anda mengonfigurasinya), wizard Konfigurasi Debugging Jarak Jauh muncul.

    Dalam sebagian besar skenario, pilih Berikutnya hingga Anda masuk ke halaman wizard Mengonfigurasi Windows Firewall.

    Cuplikan layar konfigurasi debugger jarak jauh.

    Cuplikan layar konfigurasi debugger jarak jauh.

    Jika WINDOWS Web Services API tidak diinstal, yang hanya terjadi pada Windows Server 2008 R2, pilih tombol Instal.

  3. Pilih setidaknya satu jenis jaringan tempat Anda ingin menggunakan alat jarak jauh. Jika komputer tersambung melalui domain, Anda harus memilih item pertama. Jika komputer tersambung melalui grup kerja atau grup rumah, pilih item kedua atau ketiga yang sesuai.

    Selanjutnya, pilih Selesai untuk memulai debugger jarak jauh.

    Selanjutnya, pilih Konfigurasikan debugging jarak jauh untuk memulai debugger jarak jauh.

  4. Setelah konfigurasi selesai, jendela Remote Debugger akan muncul.

    Cuplikan layar jendela debugger jarak jauh

    Cuplikan layar jendela debugger jarak jauh

    Debugger jarak jauh sekarang menunggu koneksi. Gunakan nama server dan nomor port yang ditampilkan untuk mengatur konfigurasi koneksi jarak jauh di Visual Studio.

Untuk menghentikan debugger jarak jauh, pilih File>Keluar. Anda dapat memulai ulang dari menu Mulai, atau dari baris perintah:

<Remote debugger installation directory>\msvsmon.exe

Nota

Jika Anda perlu menambahkan izin untuk pengguna tambahan, mengubah mode autentikasi, atau nomor port untuk debugger jarak jauh, lihat Mengonfigurasi debugger jarak jauh.

Lampirkan ke aplikasi ASP.NET Core dari komputer Visual Studio

Mulai dari Visual Studio 2022 versi 17.10 Pratinjau 2, kotak dialog Lampirkan ke Proses telah berubah. Jika Anda memerlukan instruksi yang cocok dengan kotak dialog yang lebih lama, beralihlah ke tampilan Visual Studio 2019 (pemilih versi kiri atas dalam artikel).

  1. Di komputer Visual Studio, buka solusi yang coba Anda debug (MyASPApp jika Anda mengikuti semua langkah dalam artikel ini).

  2. Di Visual Studio, pilih Debug > Melampirkan ke Proses (Ctrl + Alt + P).

    Saran

    Di Visual Studio 2017 dan versi yang lebih baru, Anda dapat memasang kembali ke proses yang sama yang sebelumnya Anda lampirkan dengan menggunakan Debug > Pasang Ulang ke Proses... (Shift + Alt + P).

  3. Atur Tipe Koneksi ke Remote (Windows).

    Opsi Target Koneksi muncul.

    Atur Target Koneksi ke>nama komputer jarak jauh<dan tekan Enter.

    Verifikasi bahwa Visual Studio menambahkan port yang diperlukan ke nama komputer, yang muncul dalam format: <nama komputer jarak jauh>:port

    Di Visual Studio 2022, Anda akan melihat nama komputer jarak jauh <>:4026

    Port itu diperlukan. Jika Anda tidak melihat nomor port, tambahkan secara manual.

  1. Di komputer Visual Studio, buka solusi yang coba Anda debug (MyASPApp jika Anda mengikuti semua langkah dalam artikel ini).

  2. Di Visual Studio, pilih Debug > Attach to Process (Ctrl + Alt + P).

    Ujung

    Di Visual Studio 2017 dan versi yang lebih baru, Anda dapat memasang kembali ke proses yang sama yang sebelumnya Anda lampirkan dengan menggunakan Debug > Pasang Ulang ke Proses... (Shift + Alt + P).

  3. Atur kolom Kualifikasi ke <nama komputer jarak jauh> dan tekan tombol Enter.

    Verifikasi bahwa Visual Studio menambahkan port yang diperlukan ke nama komputer, yang muncul dalam format: <nama komputer jarak jauh>:port

    Di Visual Studio 2019, Anda akan melihat nama komputer jarak jauh <>:4024

    Port tersebut diperlukan. Jika Anda tidak melihat nomor port, tambahkan secara manual.

  1. Pilih Refresh.

    Anda akan melihat beberapa proses muncul di jendela Proses Tersedia.

    Jika Anda tidak melihat proses apa pun, coba gunakan alamat IP alih-alih nama komputer jarak jauh (port diperlukan). Anda dapat menggunakan ipconfig di baris perintah untuk mendapatkan alamat IPv4.

    Jika Anda ingin menggunakan tombol Temukan, Anda mungkin perlu membuka port UDP keluar 3702 di server.

  2. Periksa Tampilkan proses dari semua pengguna.

  3. Ketik huruf pertama nama proses Anda untuk menemukan aplikasi Anda dengan cepat.

    • Jika Anda menggunakan model hosting dalam proses di IIS, pilih proses w3wp.exe yang benar. Mulai dari .NET Core 3, proses ini adalah default.

    • Jika tidak, pilih proses dotnet.exe. (Ini adalah model hosting di luar proses.)

    Jika Anda memiliki beberapa proses yang memperlihatkan w3wp.exe atau dotnet.exe, periksa kolom Nama Pengguna. Dalam beberapa skenario, kolom Nama Pengguna menampilkan nama kumpulan aplikasi Anda, seperti IIS APPPOOL\DefaultAppPool. Jika Anda melihat App Pool, tetapi tidak unik, buat App Pool baru yang diberi nama untuk instans aplikasi yang ingin Anda debug, lalu Anda dapat menemukannya dengan mudah di kolom Nama Pengguna.

    Cuplikan layar dialog Lampirkan ke Proses.

    Cuplikan layar dialog Lampirkan ke Proses.

  4. Pilih Lampirkan.

  5. Buka situs web komputer jarak jauh. Di browser, buka http://<nama komputer jarak jauh>.

    Anda akan melihat halaman web ASP.NET.

  6. Di aplikasi ASP.NET yang sedang berjalan, pilih tautan ke halaman Privasi.

    Titik henti harus ditemui di Visual Studio.

    Jika Anda tidak dapat melampirkan atau mencapai titik henti, lihat Memecahkan masalah penelusuran kesalahan jarak jauh.

Pemecahan masalah penyebaran IIS

  • Jika Anda tidak dapat tersambung ke host menggunakan nama host, coba alamat IP sebagai gantinya.
  • Pastikan port yang diperlukan terbuka di server jarak jauh.
  • Untuk ASP.NET Core, Anda perlu memastikan bahwa bidang kumpulan aplikasi untuk DefaultAppPool disetel ke Tanpa Kode Terkelola.
  • Verifikasi bahwa versi ASP.NET yang digunakan di aplikasi Anda sama dengan versi yang Anda instal di server. Untuk aplikasi Anda, Anda dapat melihat dan mengatur versi di halaman Properti. Untuk mengatur aplikasi ke versi yang berbeda, versi tersebut harus diinstal.
  • Jika aplikasi mencoba membuka, tetapi Anda melihat peringatan sertifikat, pilih untuk mempercayai situs. Jika Anda sudah menutup peringatan, Anda dapat mengedit profil penerbitan, file *.pubxml, di proyek Anda dan menambahkan elemen berikut (hanya untuk pengujian): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
  • Setelah disebarkan, mulai aplikasi di IIS untuk menguji bahwa aplikasi disebarkan dengan benar.
  • Periksa jendela Output di Visual Studio untuk informasi status, dan periksa pesan kesalahan Anda.

Membuka port yang diperlukan di Windows Server

Di sebagian besar pengaturan, port yang diperlukan dibuka oleh penginstalan ASP.NET dan debugger jarak jauh. Namun, jika Anda memecahkan masalah penyebaran dan aplikasi dihosting di belakang firewall, Anda mungkin perlu memverifikasi bahwa port yang diperlukan terbuka.

Pada Azure VM, Anda harus membuka port melalui:

Port yang diperlukan:

  • 80 - Diperlukan untuk IIS
  • UDP 3702 - (Opsional) Port Penemuan memungkinkan Anda menggunakan tombol Temukan saat menghubungkan ke debugger jarak jauh di Visual Studio. Ini harus berupa port keluar (aturan keluar).

Selain itu, port ini harus sudah dibuka oleh penginstalan ASP.NET Core:

  • 8172 - (Opsional) Diperlukan untuk Web Deploy untuk menyebarkan aplikasi dari Visual Studio