Yerel Docker kapsayıcısında uygulamalarda hata ayıklama

Visual Studio, Docker kapsayıcıları geliştirmek ve uygulamanızı yerel olarak doğrulamak için tutarlı bir yol sağlar. Docker yüklü olarak yerel Windows masaüstünüzde çalışan Linux veya Windows kapsayıcılarında uygulamalarınızı çalıştırabilir ve hatalarını ayıklayabilirsiniz ve her kod değişikliği yaptığınızda kapsayıcıyı yeniden başlatmanız gerekmez.

Bu makalede visual studio kullanarak yerel docker kapsayıcısında uygulama başlatma, değişiklik yapma ve ardından değişiklikleri görmek için tarayıcıyı yenileme işlemleri gösterilmektedir. Bu makalede, kapsayıcılı uygulamalar için hata ayıklama için kesme noktalarının nasıl ayarlanacağı da gösterilir. Desteklenen proje türleri arasında web uygulaması, konsol uygulaması ve .NET Framework ile .NET Core'un hedeflendiği Azure işlevi bulunur. Bu makalede sunulan örnekler, ASP.NET Core Web App türünde bir proje ve Konsol Uygulaması (.NET Framework) türünde bir projedir.

Desteklenen türde bir projeniz zaten varsa, Visual Studio bir Dockerfile oluşturabilir ve projenizi bir kapsayıcıda çalışacak şekilde yapılandırabilir. Bkz. Visual Studio'da Kapsayıcı Araçları.

Önkoşullar

Yerel Docker kapsayıcısında uygulamaların hatalarını ayıklamak için aşağıdaki araçların yüklenmesi gerekir:

Docker kapsayıcılarını yerel olarak çalıştırmak için yerel bir Docker istemciniz olmalıdır. Windows 10 veya üzerini gerektiren Docker Desktop'ı kullanabilirsiniz.

Web uygulaması oluşturma

Bir projeniz varsa ve genel bakış bölümünde açıklandığı gibi Docker desteği eklediyseniz bu bölümü atlayın.

Razor sayfalarınızı düzenleme ve yenileme

Razor sayfalarınızdaki değişiklikleri hızla yinelemek için uygulamanızı bir kapsayıcıda başlatabilirsiniz. Ardından, internet Information Services (IIS) Express ile yaptığınız gibi değişiklikleri yapmaya devam edin.

1. Docker'ın, kullanmakta olduğunuz kapsayıcı türünü (Linux veya Windows) kullanacak şekilde ayarlandığından emin olun. Görev Çubuğunda Docker simgesine sağ tıklayın ve Linux kapsayıcılarına geç'i veya Uygun şekilde Windows kapsayıcılarına geçiş yap'ı seçin.

2. Bu bölümde açıklandığı gibi kodunuzu düzenleme ve çalışan siteyi yenileme, .NET Core ve .NET 5 ve sonraki sürümlerdeki varsayılan şablonlarda etkinleştirilmez. Etkinleştirmek için Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation NuGet paketini ekleyin. Yöntemindeki koda Startup.ConfigureServices AddRazorRuntimeCompilation uzantı yöntemine bir çağrı ekleyin. Bunun yalnızca HATA AYıKLAMA modunda etkinleştirilmesi gerekir, bu nedenle yönteminde aşağıdaki gibi kodlayın Main :

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

   Daha fazla bilgi için bkz . ASP.NET Core'da Razor dosya derlemesi. Tam kod, hedef çerçeveye ve kullandığınız proje şablonuna bağlı olarak değişebilir.

3. Çözüm Yapılandırmasını Hata Ayıklama olarak ayarlayın. Ardından Docker görüntünüzü oluşturmak ve yerel olarak çalıştırmak için Ctrl+F5 tuşlarına basın.

   Kapsayıcı görüntüsü bir Docker kapsayıcısında derlenip çalıştırıldığında, Visual Studio web uygulamasını varsayılan tarayıcınızda başlatır.

4. Dizin sayfasına gidin. Bu sayfada değişiklikler yapacağız.

5. Visual Studio'ya dönün ve Index.cshtml dosyasını açın.

6. Dosyanın sonuna aşağıdaki HTML içeriğini ekleyin ve değişiklikleri kaydedin.

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

7. Çıkış penceresinde, .NET derlemesi tamamlandığında ve aşağıdaki satırları gördüğünüzde tarayıcınıza dönün ve sayfayı yenileyin:

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

Değişiklikleriniz uygulandı!

Kesme noktalarıyla hata ayıklama

Değişiklikler genellikle daha fazla inceleme gerektirir. Bu görev için Visual Studio'nun hata ayıklama özelliklerini kullanabilirsiniz.

1. Visual Studio'da Index.cshtml.cs açın.

2. OnGet yönteminin içeriğini aşağıdaki kodla değiştirin:

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

3. Kod satırının solunda bir kesme noktası ayarlayın.

4. Hata ayıklamayı başlatmak ve kesme noktasına gitmek için F5 tuşuna basın.

5. Kesme noktasını görüntülemek için Visual Studio'ya geçin. Değerleri inceleyin.

   

   

.NET Framework konsol uygulaması oluşturma

Bu bölümde, yerel bir Docker kapsayıcısında bir .NET Framework konsol uygulaması projesinde hata ayıklama işlemi yapılırken önce projeye Docker desteğinin nasıl ekleneceği gösterilir. Farklı proje türlerinin farklı Docker desteği düzeylerine sahip olduğunu bilmek önemlidir. .NET Core (.NET 5 ve üzeri dahil) konsol uygulaması projeleri ve .NET Framework konsol uygulaması projeleri için farklı Docker desteği düzeyleri bile vardır.

.NET Framework konsol uygulaması projesi oluşturulduğunda Docker desteğini etkinleştirme seçeneği yoktur. Böyle bir proje oluşturduktan sonra, docker desteğini projeye açıkça eklemenin bir yolu yoktur. .NET Framework konsol uygulaması projesi için kapsayıcı düzenleme desteği eklemek mümkündür. .NET Framework konsol uygulaması projesine düzenleme desteği eklemenin bir yan etkisi, projeye Docker desteği eklemesidir.

Aşağıdaki yordam, daha sonra projeye Docker desteği ekleyen ve projenin yerel bir Docker kapsayıcısında hata ayıklamasına izin veren bir .NET Framework konsol uygulaması projesine düzenleme desteği eklemeyi gösterir.

1. Yeni bir .NET Framework Konsol uygulaması projesi oluşturun.
2. Çözüm Gezgini proje düğümüne sağ tıklayın ve kapsayıcı düzenleme desteği ekle'yi>seçin. Görüntülenen iletişim kutusunda Docker Compose'u seçin. Projenize bir Dockerfile ve ilişkili destek dosyaları içeren bir Docker Compose projesi eklenir.

Kesme noktalarıyla hata ayıklama

1. Çözüm Gezgini'da Program.cs açın.

2. Main yönteminin içeriğini aşağıdaki kodla değiştirin:

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

3. Kod satırının solunda bir kesme noktası ayarlayın.

4. Hata ayıklamayı başlatmak için F5 tuşuna basın ve kesme noktasına basın.

5. Kesme noktasını görüntülemek ve değerleri incelemek için Visual Studio'ya geçin.

   

# 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

Kapsayıcı yeniden kullanımı

Visual Studio'nun normalde Hata Ayıklama yapılandırması için kullandığı Hızlı Modu kullandığınızda, Dockerfile'ı değiştirdiğinizde Visual Studio yalnızca kapsayıcı görüntülerinizi ve kapsayıcının kendisini yeniden oluşturur. Dockerfile'ı değiştirmezseniz, Visual Studio önceki bir çalıştırmadan kapsayıcıyı yeniden kullanır.

Kapsayıcınızı el ile değiştirdiyseniz ve temiz bir kapsayıcı görüntüsüyle yeniden başlatmak istiyorsanız Visual Studio'da Temiz Derle>komutunu kullanın ve normal şekilde derleyin.

Yayın yapılandırması için tipik olan Hızlı Modu kullanmadığınızda Visual Studio, proje her oluşturulduğunda kapsayıcıyı yeniden oluşturur.

Hızlı Mod kullanıldığında yapılandırabilirsiniz; Bkz. Visual Studio Kapsayıcı Araçları'nı yapılandırma.

Sorun giderme

Visual Studio Docker geliştirme sorunlarını gidermeyi öğrenin.

İlgili içerik

Visual Studio kapsayıcılı uygulamaları nasıl derler? bölümünü okuyarak daha fazla ayrıntıya ulaşın.

Visual Studio, Windows ve Azure ile Docker hakkında daha fazla bilgi

• Visual Studio ile kapsayıcı geliştirme hakkında daha fazla bilgi edinin.
• Docker kapsayıcısı oluşturmak ve dağıtmak için bkz . Azure Pipelines için Docker tümleştirmesi.
• Windows Server ve Nano Sunucu makalelerinin dizini için bkz . Windows kapsayıcı bilgileri.
• Azure Kubernetes Service hakkında bilgi edinin ve Azure Kubernetes Service belgelerini gözden geçirin.