Men-debug aplikasi dalam kontainer Docker lokal

Visual Studio menyediakan cara yang konsisten untuk mengembangkan kontainer Docker dan memvalidasi aplikasi Anda secara lokal. Anda dapat menjalankan dan men-debug aplikasi Anda di kontainer Linux atau Windows yang berjalan di desktop Windows lokal Anda dengan Docker terinstal, dan Anda tidak perlu menghidupkan ulang kontainer setiap kali Anda membuat perubahan kode.

Artikel ini mengilustrasikan cara menggunakan Visual Studio untuk memulai aplikasi di kontainer Docker lokal, membuat perubahan, lalu merefresh browser untuk melihat perubahan. Artikel ini juga menunjukkan cara mengatur titik henti untuk debugging aplikasi yang terkontainerisasi. Jenis proyek yang didukung termasuk aplikasi web, aplikasi konsol, dan fungsi Azure yang menargetkan .NET Framework dan .NET Core. Contoh yang disajikan dalam artikel ini adalah proyek jenis ASP.NET Core Web App dan proyek jenis Aplikasi Konsol (.NET Framework).

Jika Anda sudah memiliki proyek jenis yang didukung, Visual Studio dapat membuat Dockerfile dan mengonfigurasi proyek Anda untuk dijalankan dalam kontainer. Lihat Alat Kontainer di Visual Studio.

Prasyarat

Untuk men-debug aplikasi dalam kontainer Docker lokal, alat berikut harus diinstal:

Untuk menjalankan kontainer Docker secara lokal, Anda harus memiliki klien Docker lokal. Anda dapat menggunakan Docker Desktop, yang memerlukan Windows 10 atau yang lebih baru.

Membuat aplikasi web

Jika Anda memiliki proyek dan telah menambahkan dukungan Docker seperti yang dijelaskan dalam gambaran umum , lewati bagian ini.

Sunting halaman Razor Anda dan segarkan

Untuk menguraikan perubahan dengan cepat di halaman Razor, Anda dapat memulai aplikasi Anda dalam kontainer. Kemudian, lanjutkan membuat perubahan, melihatnya seperti saat Anda menggunakan Internet Information Services (IIS) Express.

1. Pastikan Docker disiapkan untuk menggunakan jenis kontainer (Linux atau Windows) yang Anda gunakan. Klik kanan ikon Docker di Taskbar, dan pilih Beralih ke kontainer Linux atau Beralih ke kontainer Windows yang sesuai.

2. Mengedit kode Anda dan memperbarui situs yang aktif seperti yang dijelaskan di bagian ini tidak didukung dalam templat default di .NET Core dan .NET 5 dan yang lebih baru. Untuk mengaktifkannya, tambahkan paket NuGet Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation. Tambahkan panggilan ke metode ekstensi AddRazorRuntimeCompilation ke kode dalam metode Startup.ConfigureServices. Anda hanya memerlukan ini diaktifkan dalam mode DEBUG, jadi kodekan sebagai berikut dalam metode Main:

   // Add services to the container.
   var mvcBuilder = builder.Services.AddRazorPages();
   #if DEBUG
       if (Env.IsDevelopment())
       {
           mvcBuilder.AddRazorRuntimeCompilation();
       }
   #endif
   

   Untuk informasi selengkapnya, lihat kompilasi file Razor di ASP.NET Core. Kode yang tepat mungkin bervariasi, tergantung pada kerangka kerja target dan templat proyek yang Anda gunakan.

3. Atur Konfigurasi Solusi ke Debug. Kemudian, tekan Ctrl+F5 untuk membangun gambar Docker Anda dan menjalankannya secara lokal.

   Saat gambar kontainer dibangun dan berjalan dalam kontainer Docker, Visual Studio meluncurkan aplikasi web di browser default Anda.

4. Buka halaman Indeks . Kami akan membuat perubahan pada halaman ini.

5. Kembali ke Visual Studio dan buka Index.cshtml .

6. Tambahkan konten HTML berikut ke akhir file, lalu simpan perubahan.

   <h1>Hello from a Docker container!</h1>
   

7. Di jendela output, ketika build .NET selesai dan Anda melihat baris berikut, beralih kembali ke browser Anda dan refresh halaman:

   Now listening on: http://*:80
   Application started. Press Ctrl+C to shut down.
   

Perubahan Anda telah diterapkan!

Debug dengan titik henti

Seringkali, perubahan memerlukan inspeksi lebih lanjut. Anda dapat menggunakan fitur debugging (penelusuran kesalahan) Visual Studio untuk tugas ini.

1. Di Visual Studio, buka Index.cshtml.cs.

2. Ganti konten metode OnGet dengan kode berikut:

       ViewData["Message"] = "Your application description page from within a container";
   

3. Di sebelah kiri baris kode, atur titik henti.

4. Mulai debugging dan tekan titik henti, tekan F5.

5. Beralih ke Visual Studio untuk melihat titik henti. Memeriksa nilai.

   

   

Membuat aplikasi konsol .NET Framework

Bagian ini menyajikan cara men-debug proyek aplikasi konsol .NET Framework di kontainer Docker lokal dengan terlebih dahulu menunjukkan cara menambahkan dukungan Docker ke proyek. Penting untuk mengenali bahwa jenis proyek yang berbeda memiliki tingkat dukungan Docker yang berbeda. Bahkan ada berbagai tingkat dukungan Docker untuk proyek aplikasi konsol .NET Core (termasuk .NET 5 dan yang lebih baru) versus proyek aplikasi konsol .NET Framework.

Saat proyek aplikasi konsol .NET Framework dibuat, tidak ada opsi untuk mengaktifkan dukungan Docker. Setelah membuat proyek seperti itu, tidak ada cara untuk secara eksplisit menambahkan dukungan Docker ke proyek. Untuk proyek aplikasi konsol .NET Framework, Anda dapat menambahkan dukungan untuk orkestrasi kontainer. Efek samping menambahkan dukungan orkestrasi ke proyek aplikasi konsol .NET Framework adalah menambahkan dukungan Docker ke proyek.

Prosedur berikut menunjukkan cara menambahkan dukungan orkestrasi ke proyek aplikasi konsol .NET Framework, yang kemudian menambahkan dukungan Docker ke proyek dan memungkinkan proyek di-debug dalam kontainer Docker lokal.

1. Buat proyek aplikasi .NET Framework Console baru.
2. Di Penjelajah Solusi, klik kanan simpul proyek, lalu pilih Tambahkan Dukungan Orkestrasi Kontainer>. Dalam kotak dialog yang muncul, pilih Docker Compose. Dockerfile ditambahkan ke proyek Anda dan proyek Docker Compose dengan file dukungan terkait ditambahkan.

Debug dengan titik jeda

1. Di Penjelajah Solusi, buka Program.cs.

2. Ganti konten metode Main dengan kode berikut:

       System.Console.WriteLine("Hello, world!");
   

3. Atur titik henti di sebelah kiri baris kode.

4. Tekan F5 untuk memulai penelusuran kesalahan dan tekan titik henti.

5. Beralih ke Visual Studio untuk melihat titik henti dan memeriksa nilai.

   

# This layer is to support debugging, VS's Token Proxy requires the runtime to be installed in the container
FROM mcr.microsoft.com/dotnet/runtime:8.0 AS runtime
FROM base as debug
COPY --from=runtime /usr/share/dotnet /usr/share/dotnet
RUN ln -s /usr/share/dotnet/dotnet /usr/bin/dotnet

# Set the stage to debug to use an image with the .NET runtime in it
services:
  functionappintegrated:
    build:
      target: debug

Penggunaan kembali kontainer

Saat Anda menggunakan Mode Cepat, yang biasanya digunakan Visual Studio untuk konfigurasi Debug, Visual Studio hanya menyusun ulang citra kontainer Anda dan kontainer itu sendiri saat Anda mengubah Dockerfile. Jika Anda tidak mengubah Dockerfile, Visual Studio akan menggunakan kembali kontainer dari proses sebelumnya.

Jika Anda memodifikasi kontainer secara manual dan ingin memulai ulang dengan gambar kontainer yang bersih, gunakan perintah Build>Clean di Visual Studio, lalu buat seperti biasa.

Saat Anda tidak menggunakan Mode Cepat, yang khas untuk konfigurasi Rilis, Visual Studio membangun kembali kontainer setiap kali proyek dibuat.

Anda dapat mengonfigurasi kapan Mode Cepat digunakan; lihat Cara mengonfigurasi Alat Kontainer Visual Studio.

Pemecahan Masalah

Pelajari cara memecahkan masalah pengembangan Visual Studio Docker.

Konten terkait

Dapatkan detail selengkapnya dengan membaca Cara Visual Studio membangun aplikasi kontainer.

Selengkapnya tentang Docker dengan Visual Studio, Windows, dan Azure

• Pelajari selengkapnya tentang pengembangan kontainer dengan Visual Studio.
• Untuk membangun dan menyebarkan kontainer Docker, lihat integrasi Docker untuk Azure Pipelines.
• Untuk indeks artikel Windows Server dan Nano Server, lihat informasi kontainer Windows.
• Pelajari tentang Azure Kubernetes Service dan tinjau dokumentasi Azure Kubernetes Service.