Azure App Service (Windows) üzerinde ASP.NET Core Uzaktan Hata Ayıklama

Bu makalede, Visual Studio hata ayıklayıcısını Azure App Service üzerinde çalışan bir ASP.NET Core uygulamasına ekleme açıklanmaktadır. Aşağıdaki adımlar, uygulamada yerel olarak çalışıyormuş gibi hata ayıklamanızı sağlar.

Önkoşullar

• Visual Studio 2022'nin, ASP.NET ve web geliştirme ile Azure geliştirme iş yüklerinin yüklü olması.

• Önce Visual Studio'dan Azure App Service'e (Windows) bir ASP.NET Core uygulaması dağıtmanız ve uygulamanın çalışıyor olması gerekir.

• Yayımlamadan önce, Visual Studio'daki yayımlama profilinizin Yayın yerine Hata Ayıklama olarak ayarlanması gerekir.

Uzaktan hata ayıklamayı etkinleştirme

Visual Studio'da bu sorunun hatalarını ayıklayabilmeniz için önce App Service'te uzaktan hata ayıklama özelliğini etkinleştirmeniz gerekir. Bu ayar, Visual Studio hata ayıklayıcısının ana App Service web barındırma işlemine bağlanmasına olanak tanır.

1. Kendi Azure portalınızda oturum açın.

   Dağıtılan uygulamanızı Azure portalında bulun. Uygulamanızı, App Services sayfasına gidip App Service örneğini seçerek bulabilirsiniz. App Service örneğini üstteki arama çubuğunda doğrudan adını kullanarak da arayabilirsiniz. (Bu örnekte App Service örneği GitHubBrowser123 olarak adlandırılmıştır.)

   

2. App Service örneğinin ayarlar sayfasında, sol gezinti bölmesinde Yapılandırma'yı ve ardından Genel Ayarlar sekmesini seçin.

3. Sayfanın en altına doğru, Uzaktan Hata Ayıklama özelliğini Açık olarak ayarladığınızdan emin olun ve Uzak Visual Studio sürümü olarak Visual Studio 2022'yi seçin.

   

4. Değişikliklerinizi kalıcı hale getirmek için sayfanın üst kısmındaki Kaydet'i seçin.

App Service örneğiniz artık Visual Studio aracılığıyla uzaktan hata ayıklamayı destekliyor.

Hata ayıklama ayarlarını yapılandırma

1. Uygulamanızı hatasız oluşturun. Yerel olarak çalışıyorsa uygulamanızı durdurun.

   Uyarı

   Yerel kodunuzun durumunun Azure'a dağıtılan kodla eşleştiğinden emin olun. Bu, yerel simge dosyalarının ve kaynak kodunun dağıtılan uygulamayla hizalanmasını sağlar.

2. Üstteki Visual Studio menüsünden Hata Ayıklama > Seçenekleri'ni seçin. Yalnızca Kodumu Etkinleştir seçeneğinin işaretinin kaldırıldığından emin olun (aşağıdaki çizimde gösterildiği gibi) ve ardından Tamam'ı seçin.

   Bu ayarın değiştirilmesi, Visual Studio'nun yerel bin klasörünüzdeki gerekli sembol dosyalarını kullanarak Azure'a dağıtılan iyileştirilmiş kodda hata ayıklamasına olanak tanır. Sembol dosyaları, visual studio'da derlenmiş, yürütülen kod ve kaynak kod arasında bir köprü olarak hata ayıklayıcı tarafından kullanılır. Uzaktan hata ayıklama için eşleşen sembol dosyaları gereklidir.

   

Hata ayıklayıcıyı App Service'e ekleme

1. Visual Studio'nun üst kısmındaki ana menüden Hata Ayıkla > İşleme Bağlan'ı seçerek ilgili iletişim kutusunu açın. Bu pencereyi kullanarak farklı hedeflere bağlanabilir ve ekleyebilirsiniz. Bu durumda, önceki adımda oluşturduğunuz App Service örneğine bağlanacaksınız.

2. Bağlantı Türü açılan listesini seçin ve Microsoft Azure App Services seçeneğini belirleyin.

3. Bağlantı Hedefi alanının yanındaki Bul.. öğesini seçerek Azure aboneliklerinize ve uygulama hizmetlerinize göz atmanızı sağlayan bir iletişim kutusu açın.

   Azure aboneliğinizle henüz oturum açmadıysanız Bul... öğesini seçin ve ardından oturum açabilirsiniz.

4. Önceki adımda oluşturduğunuz App Service örneğini bulup seçin ve ardından Tamam'ı seçin.

5. İşlem w3wp.exe , bağlanılması gereken kullanılabilir işlemler listesinde görünmelidir. w3wp.exe , dağıtılan uygulamayı barındıran Azure App Service'in ana işlemidir. w3wp.exe İşlemi seçin ve ardından sağ alttaki Ekle'yi seçin.

   

6. gibi Index.cshtml.csbir C# uygulama dosyasında, sol kenar boşluğuna tıklayarak bir kesme noktası ayarlayın. Alternatif olarak sağ tıklayıp Kesme noktası ekle> seçin.

7. Web uygulamasında kesme noktası olan uç noktaya gidin. İşleme bağlıysanız ancak kesme noktasına ulaşmadıysanız Visual Studio'daki yayımlama profilinizin Yayın yapılandırması yerine Hata ayıklama yapılandırmasına ayarlandığından emin olun.

8. İsteğe bağlı: Visual Studio'nun hata ayıklama oturumunuz için sembol dosyalarını yüklediğini doğrulamak için. Modüller penceresini açmak için Windows > Modüllerinde Hata Ayıklama'ya > gidin. Bu pencere, daha önce yaptığınız Yalnızca kod yapılandırma değişikliklerinden sonra sembol dosyalarının başarıyla yüklendiğini gösterir.

   

Uyarı

Uygulama hizmetinin sonraki hata ayıklaması için Hata Ayıkla veya w3wp.exe'ye Yeniden Bağlan seçeneğini seçin veya Shift+Alt+P kısayol tuşlarını kullanın.