Azure App Service için ASP.NET uygulaması yapılandırma

Uyarı

ASP.NET Core için bkz Azure Uygulama Servisi için ASP.NET Core uygulaması yapılandırma. ASP.NET uygulamanız özel bir Windows veya Linux kapsayıcısında çalışıyorsa bkz. Azure Uygulaması Hizmeti için özel kapsayıcı yapılandırma.

ASP.NET uygulamaların derlenmiş ikili dosyalar olarak Azure Uygulaması Hizmetine dağıtılması gerekir. Visual Studio yayımlama aracı çözümü oluşturur ve derlenmiş ikili dosyaları doğrudan dağıtır. App Service dağıtım motoru önce kod deposunu dağıtır ve ardından binaries dosyalarını derler.

Bu kılavuz, ASP.NET geliştiriciler için önemli kavramlar ve yönergeler sağlar. Bu makale Azure App Service'le ilk deneyiminizse, önce ASP.NET web uygulaması dağıtma ve Azure SQL veritabanı ile ASP.NET uygulaması dağıtma adımlarını izleyin.

Desteklenen .NET Framework çalışma zamanı sürümlerini göster

App Service'te Windows örneklerinde desteklenen tüm .NET Framework sürümleri zaten yüklüdür. Kullanabileceğiniz .NET Framework çalışma zamanı ve SDK sürümlerini göstermek için Azure portalında uygulamanıza gidin. Geliştirme Araçları> seçin. Git'i seçin. Kudu'da CMD veya PowerShell için hata ayıklama konsolu'nu seçin. Tarayıcı tabanlı konsolda uygun komutu çalıştırın:

CLR 4 çalışma zamanı sürümleri için (.NET Framework 4 ve üzeri):

ls "D:\Program Files (x86)\Reference Assemblies\Microsoft\Framework\.NETFramework"

En son .NET Framework sürümü hemen kullanılamayabilir.

CLR 2 çalışma zamanı sürümleri için (.NET Framework 3.5 ve üstü):

ls "D:\Program Files (x86)\Reference Assemblies\Microsoft\Framework"

Uygulamanızın gerektirdiği çalışma zamanı desteklenmiyorsa, özel bir kapsayıcıyla dağıtabilirsiniz.

Geçerli .NET Framework çalışma zamanı sürümünü göster

Cloud Shell'de aşağıdaki komutu çalıştırın:

az webapp config show --resource-group <resource-group-name> --name <app-name> --query netFrameworkVersion

değeri v4.0 , en son CLR 4 sürümünün (.NET Framework 4.x) kullanıldığı anlamına gelir. değeri v2.0 , CLR 2 sürümünün (.NET Framework 3.5) kullanıldığı anlamına gelir.

.NET Framework çalışma zamanı sürümünü ayarlama

App Service, ASP.NET uygulamanızı çalıştırmak için varsayılan olarak desteklenen en son .NET Framework sürümünü kullanır. Bunun yerine uygulamanızı .NET Framework 3.5 kullanarak çalıştırmak için Cloud Shell'de aşağıdaki komutu çalıştırın (v2.0, CLR 2'yi gösterir):

az webapp config set --resource-group <resource-group-name> --name <app-name> --net-framework-version v2.0

App Service'te eski çalışma zamanlarına ne olur?

Eski çalışma zamanları, bakım kuruluşu tarafından kullanım dışı bırakılır veya önemli güvenlik açıklarına sahiptir. Buna göre, portaldaki oluşturma ve yapılandırma sayfalarından kaldırılırlar. Süresi geçmiş bir çalışma zamanı portaldan gizlendiğinde, bu çalışma zamanını kullanmaya devam eden tüm uygulamalar çalışmaya devam eder.

Portalda artık gösterilmemiş bir eski çalışma zamanı sürümüne sahip bir uygulama oluşturmak istiyorsanız Azure CLI' yı, ARM şablonunu veya Bicep'i kullanın. Bu dağıtım alternatifleri, portaldan kaldırılan ancak hala desteklenmeye devam eden kullanım dışı çalışma zamanları oluşturmanıza olanak tanır.

Bir çalışma zamanı App Service platformundan tamamen kaldırılırsa, Azure aboneliği sahibiniz kaldırmadan önce bir e-posta bildirimi alır.

Ortam değişkenlerine erişme

App Service'te uygulama kodunuzun dışında uygulama ayarlarını ve bağlantı dizesi ayarlayabilirsiniz. Ardından standart ASP.NET desenini kullanarak bunlara herhangi bir sınıfta erişebilirsiniz:

using System.Configuration;
...
// Get an app setting
ConfigurationManager.AppSettings["MySetting"];
// Get a connection string
ConfigurationManager.ConnectionStrings["MyConnection"];
}

App Service'te ve web.config'de aynı ada sahip bir uygulama ayarı yapılandırırsanız, App Service değeri web.config değerinden önceliklidir. Yerel web.config değeri, uygulamada yerel olarak hata ayıklamanıza olanak tanır. App Service değeri, üretim ayarlarıyla uygulamayı üründe çalıştırmanıza olanak tanır. Bağlantı stringleri aynı şekilde çalışmaktadır. Bu şekilde uygulama gizli dizilerinizi kod deponuzun dışında tutabilir ve kodunuzu değiştirmeden uygun değerlere erişebilirsiniz.

Uyarı

Bağlantı güvenlik bilgilerini gerektirmeyen daha güvenli bağlantı seçeneklerini göz önünde bulundurun. Daha fazla bilgi için bkz. Azure Uygulaması Hizmetinden Azure hizmetlerine ve veritabanlarına güvenli bağlantı.

Birden çok proje içeren çözümleri dağıtma

Visual Studio çözümü birden çok proje içerdiğinde, Visual Studio yayımlama işlemi dağıtılacak projeyi seçmeyi içerir. Git gibi App Service dağıtım altyapısına veya derleme otomasyonu etkin zip dağıtımıyla dağıtım yaptığınızda, App Service dağıtım altyapısı App Service uygulaması olarak bulduğu ilk Web Sitesini veya Web Uygulaması Projesini seçer. Uygulama ayarını belirterek PROJECT App Service'in kullanması gereken projeyi belirtebilirsiniz. Örneğin, Cloud Shell'de aşağıdaki komutu çalıştırın:

az webapp config appsettings set --resource-group <resource-group-name> --name <app-name> --settings PROJECT="<project-name>/<project-name>.csproj"

Ayrıntılı özel durum sayfası görüntüleme

ASP.NET uygulamanız Visual Studio hata ayıklayıcısında bir özel durum oluşturduğunda, tarayıcı ayrıntılı bir özel durum sayfası görüntüler. App Service'te bu sayfanın yerini genel bir hata iletisi alır. App Service'te ayrıntılı hata sayfasını görüntülemek için web.config dosyasını açın ve <customErrors mode="Off"/> öğesinin altına <system.web> öğesini ekleyin. Örneğin:

<system.web>
    <customErrors mode="Off"/>
</system.web>

Uygulamanızı güncelleştirilmiş web.configile yeniden dağıtın. Şimdi aynı ayrıntılı özel durum sayfasını görmeniz gerekir.

Tanılama günlüklerine erişim

System.Diagnostics.Trace kullanarak uygulama kodunuza tanılama iletileri ekleyebilirsiniz. Örneğin:

Trace.TraceError("Record not found!"); // Error trace
Trace.TraceWarning("Possible data loss"); // Warning trace
Trace.TraceInformation("GET /Home/Index"); // Information trace

App Service'te uygulama kodunuzun içinden oluşturulan konsol günlüklerine erişmek için cloud shell aşağıdaki komutu çalıştırarak tanılama günlüğünü açın:

az webapp log config --resource-group <resource-group-name> --name <app-name> --docker-container-logging filesystem --level Verbose

--level için olası değerler Error, Warning, Infove Verbose'dır. Her düzey kendisinden önceki düzeyi içerir. Örneğin, Error yalnızca hata iletilerini içerir. Verbose tüm iletileri içerir.

Tanılama günlüğünü açtıktan sonra, günlük akışını görmek için aşağıdaki komutu çalıştırın:

az webapp log tail --resource-group <resource-group-name> --name <app-name>

Konsol günlükleri hemen görünmüyorsa 30 saniye içinde yeniden denetleyin.

Günlük akışını istediğiniz zaman durdurmak için Ctrl+C tuşlarına basın.

İlgili içerik

  • Last updated on