IIS ile Windows'da ASP.NET Core'u barındırma
Uyarı
ASP.NET Core'un bu sürümü artık desteklenmiyor. Daha fazla bilgi için bkz . .NET ve .NET Core Destek İlkesi. Geçerli sürüm için bu makalenin .NET 8 sürümüne bakın.
Internet Information Services (IIS), ASP.NET Core'un da aralarında yer aldığı web uygulamalarını barındırmak için esnek, güvenli ve yönetilebilir bir Web Sunucusudur.
Desteklenen platformlar
Aşağıdaki işletim sistemleri desteklenmektedir:
- Windows 7 veya üzeri
- Windows Server 2012 R2 veya üzeri
32 bit (x86) veya 64 bit (x64) dağıtımı için yayımlanan uygulamalar desteklenir. Aşağıdaki durumlar dışında 32 bit uygulamayı 32 bit (x86) .NET Core SDK'sıyla dağıtabilirsiniz:
- Uygulamaya, 64 bit uygulamaya sağlanan daha büyük sanal bellek adres alanı gerekiyor.
- Uygulamaya daha büyük IIS yığın boyutu gerekiyor.
- Uygulamanın 64 bit yerel bağımlılıkları var.
ASP.NET Core Modülünü/Barındırma Paketini Yükleme
Aşağıdaki bağlantıyı kullanarak en son yükleyiciyi indirin:
Geçerli .NET Core Barındırma Paketi yükleyicisi (doğrudan indirme)
ASP.NET Core Modülünü yüklemeye veya farklı sürümleri yüklemeye yönelik daha ayrıntılı yönergeler için bkz. .NET Core Barındırma Paketini Yükleme.
Barındırma paketinin önceki sürümlerini indirmek için bu GitHub sorununa bakın.
Kullanmaya başlayın
IIS'de web sitesi barındırmaya başlamak için başlangıç kılavuzumuza bakın.
Azure Uygulaması Hizmetleri'nde web sitesi barındırmaya başlamak için Azure App Service'e dağıtım kılavuzumuza bakın.
Yapılandırma
Yapılandırma rehberliği için bkz. Gelişmiş yapılandırma.
IIS yöneticileri için dağıtım kaynakları
- IIS belgeleri
- IIS'de IIS Yöneticisi ile Çalışmaya Başlama
- .NET Core uygulama dağıtımı
- IIS için ASP.NET Core Modülü (ANCM)
- ASP.NET Core dizin yapısı
- ASP.NET Core içeren IIS modülleri
- Azure App Service ve IIS'de ASP.NET Core sorunlarını giderme
- ASP.NET Core ile Azure App Service ve IIS için yaygın hataları giderme
Örtüşen geri dönüşüm
Genel olarak sıfır kapalı kalma süreli dağıtımlar için mavi-yeşil dağıtımları gibi bir desen kullanılmasını öneririz. Örtüşen Geri Dönüşüm gibi özellikler sıfır kapalı kalma süreli bir dağıtım yapabilmenize yardımcı olur ancak bunu garanti etmez. Daha fazla bilgi için bu GitHub konusuna bakın.
İsteğe bağlı istemci sertifikaları
Uygulamanın bir alt kümesini sertifikayla koruması gereken uygulamalar hakkında bilgi için bkz. İsteğe bağlı istemci sertifikaları.
Ek kaynaklar
ASP.NET Core uygulamasını IIS sunucusuna yayımlamaya yönelik bir öğretici deneyimi için bkz. ASP.NET Core uygulamasını IIS'ye yayımlama.
.NET Core Barındırma Paketini Yükleme
Desteklenen işletim sistemleri
Aşağıdaki işletim sistemleri desteklenmektedir:
- Windows 7 veya üzeri
- Windows Server 2012 R2 veya üzeri
HTTP.sys sunucusu (eski adı WebListener) IIS ile bir ters ara sunucu yapılandırmasında çalışmaz. Kestrel sunucusunu kullanın.
Azure'da barındırma hakkında bilgi için bkz. ASP.NET Core uygulamalarını Azure App Service'e dağıtma.
Sorun giderme kılavuzu için bkz. ASP.NET Core projelerinde sorun giderme ve hata ayıklama.
Desteklenen platformlar
32 bit (x86) veya 64 bit (x64) dağıtımı için yayımlanan uygulamalar desteklenir. Aşağıdaki durumlar dışında 32 bit uygulamayı 32 bit (x86) .NET Core SDK'sıyla dağıtabilirsiniz:
- Uygulamaya, 64 bit uygulamaya sağlanan daha büyük sanal bellek adres alanı gerekiyor.
- Uygulamaya daha büyük IIS yığın boyutu gerekiyor.
- Uygulamanın 64 bit yerel bağımlılıkları var.
32 bit (x86) için yayımlanan uygulamaların IIS Uygulama Havuzları için 32 bit etkinleştirilmiş olmalıdır. Daha fazla bilgi için IIS sitesi oluşturma bölümüne bakın.
64 bit uygulamasını yayımlamak için 64 bit (x64) .NET Core SDK'sını kullanın. Konak sisteminde 64 bit çalışma zamanı mevcut olmalıdır.
Barındırma modelleri
İşlem içi barındırma modeli
İşlem içi barındırmayı kullanarak ASP.NET Core uygulaması kendi IIS çalışan işlemiyle aynı işlemde çalıştırılır. İşlem içi barındırma işlem dışı barındırmadan daha gelişmiş performans sağlar çünkü istekler, giden ağ trafiğini aynı makineye geri döndüren bir ağ arabirimi olan geri döngü bağdaştırıcısı üzerinden ara sunucu kullanmaz. IIS işlem yönetimini Windows İşlem Etkinleştirme Hizmeti (WAS) ile işler.
- Uygulama başlatma gerçekleştirir.
- CoreCLR'yi yükler.
Program.Mainçağrısı yapar.
- IIS yerel isteğinin ömrünü işler.
Aşağıdaki diyagramda IIS, ASP.NET Core Modülü ve işlem içinde barındırılan uygulama arasındaki ilişki gösterilir:
- Web'den çekirdek modundaki HTTP.sys sürücüsüne bir istek gelir.
- Sürücü yerel isteği web sitesinin yapılandırılmış bağlantı noktası üzerinden (genellikle 80 (HTTP) veya 443 (HTTPS)) IIS'ye yönlendirir.
- ASP.NET Core Modülü yerel isteği alır ve IIS HTTP Sunucusuna (
IISHttpServer) geçirir. IIS HTTP Sunucusu, IIS için isteği yerelden yönetilene dönüştüren bir işlem içi sunucu uygulamasıdır.
IIS HTTP Sunucusu isteği işledikten sonra:
- İstek ASP.NET Core ara yazılım işlem hattına gönderilir.
- Ara yazılım işlem hattı isteği işler ve bir
HttpContextörneği olarak uygulamanın mantığına geçirir. - Uygulamanın yanıtı IIS HTTP Sunucusu üzerinden geriye IIS'ye geçirilir.
- IIS bu yanıtı, isteği başlatan istemciye gönderir.
İşlem içi barındırma mevcut uygulamalar için kabul edilir. ASP.NET Core web şablonları işlem içi barındırma modelini kullanır.
CreateDefaultBuilder, UseIIS yöntemini çağırıp CoreCLR önyüklemesi yaparak bir IServer örneği ekler ve uygulamayı IIS çalışan işleminin (w3wp.exe veya iisexpress.exe) içinde barındırır. Performans testleri bir .NET Core uygulamasını işlem içinde barındırmanın, uygulamayı işlem dışında barındırıp istekleri Kestrel yoluna ara sunucuyla yönlendirmeye göre önemli ölçüde yüksek bir istek aktarım hızı sağladığını gösterir.
Tek bir yürütülebilir dosya olarak yayımlanan uygulamalar işlem içi barındırma modeliyle yüklenemez.
İşlem dışı barındırma modeli
ASP.NET Core uygulamaları IIS çalışan işleminden ayrı bir işlemde çalıştırıldığından, işlem yönetimini ASP.NET Core Modülü gerçekleştirir. İlk istek geldiğinde modül ASP.NET Core uygulaması için işlemi başlatır ve uygulama kapanırsa veya kilitlenirse uygulamayı yeniden başlatır. Bu temelde, Windows İşlem Etkinleştirme Hizmeti (WAS) tarafından yönetilen, işlem içinde çalıştırılan uygulamalarda görünen davranışla aynıdır.
Aşağıdaki diyagramda IIS, ASP.NET Core Modülü ve işlem dışında barındırılan uygulama arasındaki ilişki gösterilir:
- Web'den çekirdek modundaki HTTP.sys sürücüsüne istekler gelir.
- Sürücü istekleri web sitesinin yapılandırılmış bağlantı noktası üzerinden IIS'ye yönlendirir. Yapılandırılmış bağlantı noktası genellikle 80 (HTTP) veya 443'tür (HTTPS).
- Modül istekleri uygulama için rastgele bir bağlantı noktası üzerinden Kestrel'e iletir. Rastgele bağlantı noktası 80 veya 443 değildir.
ASP.NET Core Modülü başlatma sırasında bir ortam değişkeni yoluyla bağlantı noktasını belirtir. UseIISIntegration uzantısı sunucuyu http://localhost:{PORT} üzerinden dinleyecek şekilde yapılandırır. Ek denetimler gerçekleştirilir ve modülden kaynaklanmayan istekler reddedilir. Modül HTTPS üzerinden iletmeyi desteklemez. IIS istekleri HTTPS üzerinden almış olsa bile istekler HTTP üzerinden iletilir.
Kestrel isteği modülden aldıktan sonra, istek ASP.NET Core ara yazılım işlem hattına iletilir. Ara yazılım işlem hattı isteği işler ve bir HttpContext örneği olarak uygulamanın mantığına geçirir. IIS Tümleştirmesi tarafından eklenen ara yazılım, isteği Kestrel'e iletme işlemini gerçekleştirmek için şemayı, uzak IP'yi ve yol tabanını güncelleştirir. Uygulamanın yanıtı IIS'ye geri geçirilir ve IIS de bunu geriye, isteği başlatan HTTP istemcisine geçirir.
ASP.NET Core Modülü yapılandırma rehberi için bkz. IIS için ASP.NET Core Modülü (ANCM).
Barındırma hakkında daha fazla bilgi için bkz. ASP.NET Core'da barındırma.
Uygulama yapılandırması
IISIntegration bileşenlerini etkinleştirme
CreateHostBuilder yönteminde bir konak oluştururken (Program.cs) IIS tümleştirmesini etkinleştirmek için CreateDefaultBuilder yöntemini çağırın:
public static IHostBuilder CreateHostBuilder(string[] args) =>
Host.CreateDefaultBuilder(args)
...
CreateDefaultBuilder hakkında daha fazla bilgi için bkz. ASP.NET Core'da .NET Genel Konağı.
IIS seçenekleri
İşlem içi barındırma modeli
IIS Sunucusu seçeneklerini yapılandırmak için ConfigureServices yönteminde IISServerOptions için bir hizmet yapılandırması ekleyin. Aşağıdaki örnek AutomaticAuthentication özelliğini devre dışı bırakır:
services.Configure<IISServerOptions>(options =>
{
options.AutomaticAuthentication = false;
});
| Seçenek | Varsayılan | Ayar |
|---|---|---|
AutomaticAuthentication |
true |
true olduğunda, IIS Sunucusu HttpContext.User özelliğini Windows Kimlik Doğrulaması tarafından kimliği doğrulanmış olarak ayarlar. isefalse, sunucu yalnızca için HttpContext.User bir identity sağlar ve tarafından açıkça istendiğinde zorluklara AuthenticationSchemeyanıt verir. AutomaticAuthentication'ın çalışması için IIS'de Windows Kimlik Doğrulaması'nın etkinleştirilmesi gerekir. Daha fazla bilgi için bkz. Windows Kimlik Doğrulaması. |
AuthenticationDisplayName |
null |
Oturum açma sayfalarında kullanıcılara gösterilen görünen adı ayarlar. |
AllowSynchronousIO |
false |
HttpContext.Request ve HttpContext.Response için zaman uyumlu G/Ç'ye izin verilip verilmediği. |
MaxRequestBodySize |
30000000 |
HttpRequest için maksimum istek gövdesi boyutunu alır veya ayarlar. IIS'nin kendi maxAllowedContentLength sınırı olduğunu ve bu sınırın IISServerOptions içinde ayarlanan MaxRequestBodySize özelliğinden önce işleneceğini unutmayın. MaxRequestBodySize özelliğinin değiştirilmesi maxAllowedContentLength sınırını etkilemez. maxAllowedContentLength değerini artırmak için web.config dosyasına bir girdi ekleyerek maxAllowedContentLength için daha yüksek bir değer ayarlayın. Diğer ayrıntılar için bkz. Yapılandırma. |
İşlem dışı barındırma modeli
IIS seçeneklerini yapılandırmak için ConfigureServices yönteminde IISOptions için bir hizmet yapılandırması ekleyin. Aşağıdaki örnek uygulamanın HttpContext.Connection.ClientCertificate özelliğini doldurmasını engeller:
services.Configure<IISOptions>(options =>
{
options.ForwardClientCertificate = false;
});
| Seçenek | Varsayılan | Ayar |
|---|---|---|
AutomaticAuthentication |
true |
true olduğunda, IIS Tümleştirme Ara Yazılımı HttpContext.User özelliğini Windows Kimlik Doğrulaması tarafından kimliği doğrulanmış olarak ayarlar. isefalse, ara yazılım yalnızca için HttpContext.User bir identity sağlar ve tarafından açıkça istendiğinde zorluklara AuthenticationSchemeyanıt verir. AutomaticAuthentication'ın çalışması için IIS'de Windows Kimlik Doğrulaması'nın etkinleştirilmesi gerekir. Daha fazla bilgi için Windows Kimlik Doğrulaması konusuna bakın. |
AuthenticationDisplayName |
null |
Oturum açma sayfalarında kullanıcılara gösterilen görünen adı ayarlar. |
ForwardClientCertificate |
true |
true olduğunda ve MS-ASPNETCORE-CLIENTCERT istek üst bilgisi de mevcut olduğunda HttpContext.Connection.ClientCertificate doldurulur. |
Ara sunucu ve yük dengeleyici senaryoları
IIS Tümleştirme Ara Yazılımı ve ASP.NET Core Modülü şunları iletecek şekilde yapılandırılır:
- Şema (HTTP/HTTPS).
- İsteğin kaynaklandığı uzak IP adresi.
IIS Tümleştirme Ara Yazılımı, İletilen Üst Bilgiler Ara Yazılımını yapılandırır.
Ek ara sunucuların ve yük dengeleyicilerin arkasında barındırılan uygulamalar için ek yapılandırma gerekebilir. Daha fazla bilgi için bkz. ASP.NET Core'u ara sunucular ve yük dengeleyicilerle çalışacak şekilde yapılandırma.
web.config dosyası
web.config dosyası ASP.NET Core Modülü'nü yapılandırır. web.config dosyasını oluşturma, dönüştürme ve yayımlama işlemleri proje yayımlandığında MSBuild hedefi (_TransformWebConfig) tarafından gerçekleştirilir. Bu hedef, Web SDK'sı hedefleri (Microsoft.NET.Sdk.Web) arasında yer alır. SDK, proje dosyasının üst kısmında ayarlanır:
<Project Sdk="Microsoft.NET.Sdk.Web">
Projede web.config dosyası yoksa, dosya ASP.NET Core Modülü'nü yapılandırmak için doğru processPath ve arguments ile oluşturulur ve yayımlanan çıkışa taşınır.
Projede web.config dosyası varsa, dosya ASP.NET Core Modülü'nü yapılandırmak için doğru processPath ve arguments ile dönüştürülür ve yayımlanan çıkışa taşınır. Dönüşüm dosyadaki IIS yapılandırma ayarlarını değiştirmez.
web.config dosyası etkin IIS modüllerini denetleyen ek IIS yapılandırma ayarları sağlayabilir. ASP.NET Core uygulamalarıyla istekleri işleyebilen IIS modülleri hakkında bilgi için IIS modülleri konusuna bakın.
Web SDK'sının web.config dosyasını dönüştürmesini önlemek için proje dosyasındaki <IsTransformWebConfigDisabled> özelliğini kullanın:
<PropertyGroup>
<IsTransformWebConfigDisabled>true</IsTransformWebConfigDisabled>
</PropertyGroup>
Web SDK'sının dosyayı dönüştürmesi devre dışı bırakıldığında processPath ve arguments geliştirici tarafından el ile ayarlanmalıdır. Daha fazla bilgi için bkz. IIS için ASP.NET Core Modülü (ANCM).
web.config dosyasının konumu
ASP.NET Core Modülü'nü doğru ayarlayabilmek için, dağıtılan uygulamanın içerik kökü yolunda (tipik olarak uygulama temel yolu) web.config dosyası mevcut olmalıdır. Bu, IIS'ye sağlanan web sitesi fiziksel yoluyla aynı konumdur. Web Dağıtımı'nı kullanarak birden fazla uygulamanın yayımlanmasını sağlamak için uygulamanın kökünde web.config dosyasının bulunması gereklidir.
Uygulamanın fiziksel yolunda {ASSEMBLY}.runtimeconfig.json, {ASSEMBLY}.xml (XML Belgeleri açıklamaları) ve {ASSEMBLY}.deps.json gibi (burada {ASSEMBLY} yer tutucusu derleme adıdır) gibi hassas dosyalar bulunur. web.config dosyası mevcut olduğunda ve site normal şekilde başlatıldığında, bu hassas dosyalar istenirse ISS bunları kullanıma sunmaz. web.config dosyası yoksa, yanlış adlandırıldıysa veya siteyi normal başlatma için yapılandıramazsa, IIS hassas dosyaları genel kullanıma sunabilir.
web.config dosyası dağıtımda her zaman doğru adlandırılmış olarak ve siteyi normal başlatma için yapılandırabilecek şekilde mevcut olmalıdır. web.config dosyasını hiçbir zaman üretim dağıtımından kaldırmayın.
Web.config’i dönüştürme
Yayımlama sırasında web.config dosyasını dönüştürmeniz gerekirse Web.config'i dönüştürme konusuna bakın. Yapılandırmaya, profile veya ortama bağlı olarak ortam değişkenlerini ayarlamak için yayımlama sırasında web.config dosyasını dönüştürmeniz gerekebilir.
IIS yapılandırması
Windows Server İşletim Sistemleri
Web Sunucusu (IIS) sunucu rolünü etkinleştirin ve rol hizmetlerini oluşturun.
Yönet menüsünden Rol ve Özellik Ekle sihirbazını veya Sunucu Yöneticisi'ndeki bağlantıyı kullanın. Sunucu Rolleri adımında Web Sunucusu (IIS) kutusunu işaretleyin.
Özellikler adımından sonra Web Sunucusu (IIS) için Rol hizmetleri adımı yüklenir. İstenen IIS rol hizmetlerini seçin veya sağlanan varsayılan rol hizmetlerini kabul edin.
Windows Kimlik Doğrulaması (İsteğe Bağlı)
Windows Kimlik Doğrulaması'nı etkinleştirmek için şu düğümleri genişletin: Web Sunucusu>Güvenlik. Windows Kimlik Doğrulaması özelliğini seçin. Daha fazla bilgi için bkz. Windows Kimlik Doğrulaması<windowsAuthentication>ve Windows kimlik doğrulamasını yapılandırma.WebSockets (İsteğe Bağlı)
WebSockets, ASP.NET Core 1.1 veya üzerinde desteklenir. WebSockets'i etkinleştirmek için şu düğümleri genişletin: Web Sunucusu>Uygulama Geliştirme. WebSocket Protokolü özelliğini seçin. Daha fazla bilgi için bkz. WebSockets.Web sunucusu rolünü ve hizmetlerini yüklemek için Onay adımıyla devam edin. Web Sunucusu (IIS) rolü yüklendikten sonra sunucunun/IIS'nin yeniden başlatılması gerekmez.
Windows masaüstü işletim sistemleri
IIS Yönetim Konsolu'nu ve World Wide Web Hizmetleri'ni etkinleştirin.
Denetim Masası>Programlar>Programlar ve Özellikler> gidinWindows özelliklerini aç veya kapat seçeneğine gidin (ekranın sol tarafında).
Internet Information Services düğümünü açın. Web Yönetimi Araçları düğümünü açın.
IIS Yönetim Konsolu kutusunu işaretleyin.
World Wide Web Hizmetleri kutusunu işaretleyin.
World Wide Web Hizmetleri için varsayılan özellikleri seçin veya IIS özelliklerini özelleştirin.
Windows Kimlik Doğrulaması (İsteğe Bağlı)
Windows Kimlik Doğrulaması'nı etkinleştirmek için şu düğümleri genişletin: World Wide Web Hizmetleri>Güvenlik. Windows Kimlik Doğrulaması özelliğini seçin. Daha fazla bilgi için bkz. Windows Kimlik Doğrulaması <windowsAuthentication> ve Windows kimlik doğrulamasını yapılandırma.WebSockets (İsteğe Bağlı)
WebSockets, ASP.NET Core 1.1 veya üzerinde desteklenir. WebSockets'i etkinleştirmek için şu düğümleri genişletin: World Wide Web Hizmetleri>Uygulama Geliştirme Özellikleri. WebSocket Protokolü özelliğini seçin. Daha fazla bilgi için bkz. WebSockets.IIS yüklemesi bir yeniden başlatma gerektiriyorsa sistemi yeniden başlatın.
.NET Core Barındırma Paketini Yükleme
Barındırma sisteminde .NET Core Barındırma Paketi'ni yükleyin. Paket .NET Core Çalışma Zamanı'nı, .NET Core Kitaplığı'nı ve ASP.NET Core Modülü'nü yükler. Modül ASP.NET Core uygulamalarının IIS'nin arkasında çalıştırılmasına olanak tanır.
Önemli
Barındırma Paketi IIS'den önce yüklenirse paket yüklemesinin onarılması gerekir. IIS'yi yükledikten sonra Barındırma Paketi yükleyicisini yeniden çalıştırın.
Barındırma Paketi .NET Core'un 64 bit (x64) sürümü yüklendikten sonra yüklenirse, SDK'lar eksik gibi görünebilir (Hiçbir .NET Core SDK'sı algılanmadı). Sorunu çözmek için bkz. ASP.NET Core projelerinde sorun giderme ve hata ayıklama.
Doğrudan indirme (geçerli sürüm)
Aşağıdaki bağlantıyı kullanarak yükleyiciyi indirin:
Geçerli .NET Core Barındırma Paketi yükleyicisi (doğrudan indirme)
Yükleyicinin önceki sürümleri
Yükleyicinin önceki bir sürümünü edinmek için:
- .NET Core'u indir sayfasına gidin.
- İstediğiniz .NET Core sürümünü seçin.
- Uygulamaları çalıştır - Çalışma Zamanı sütununda istenen .NET Core çalışma zamanı sürümünü bulun.
- Barındırma Paketi bağlantısını kullanarak yükleyiciyi indirin.
Uyarı
Bazı yükleyiciler kullanım ömrünün sonuna (EOL) ulaşmış ve artık Microsoft tarafından desteklenmeyen sürümler içerir. Daha fazla bilgi için destek ilkesi bölümüne bakın.
Barındırma Paketini yükleme
Sunucuda yükleyiciyi çalıştırın. Yönetici komut kabuğundan yükleyiciyi çalıştırırken aşağıdaki parametreler kullanılabilir:
OPT_NO_ANCM=1: ASP.NET Core Modülü'nü yüklemeyi atlayın.OPT_NO_RUNTIME=1: .NET Core çalışma zamanını yüklemeyi atlayın. Sunucu yalnızca kendi içinde dağıtımları (SCD) barındırdığında kullanılır.OPT_NO_SHAREDFX=1: ASP.NET Paylaşılan Çerçevesi'ni (ASP.NET çalışma zamanı) yüklemeyi atlayın. Sunucu yalnızca kendi içinde dağıtımları (SCD) barındırdığında kullanılır.OPT_NO_X86=1: x86 çalışma zamanlarını yüklemeyi atlayın. Bu parametreyi, 32 bit uygulamalar barındırmayacağınızı bildiğiniz durumlarda kullanın. Gelecekte hem 32 bit hem de 64 bit uygulamalar barındırma olasılığınız varsa bu parametreyi kullanmayın ve her iki çalışma zamanını da yükleyin.OPT_NO_SHARED_CONFIG_CHECK=1: Paylaşılan yapılandırma (applicationHost.config) IIS yüklemesiyle aynı makinede yer aldığında IIS Paylaşılan Yapılandırması'nı kullanmak için denetimi devre dışı bırakın. Yalnızca ASP.NET Core 2.2 veya üzeri Barındırma Paketi yükleyicilerinde kullanılabilir. Daha fazla bilgi için bkz. IIS için ASP.NET Core Modülü (ANCM).
IIS yeniden başlatıldığında sistem PATH ortam değişkeninde yükleyici tarafından yapılan bir değişiklik alınır. Web sunucusunu yeniden başlatmak için Windows İşlem Etkinleştirme Hizmeti'ni (WAS) durdurun ve ardından World Wide Web Yayımlama Hizmeti'ni (W3SVC) yeniden başlatın. Sistemi yeniden başlatın veya yükseltilmiş komut kabuğunda aşağıdaki komutları yürütün:
net stop was /y net start w3svc
ASP.NET Core, paylaşılan çerçeve paketlerinin yama sürümleri için ileri sarma davranışını benimsemez. Yeni barındırma paketini yükleyip paylaşılan çerçeveyi yükselttikten sonra sistemi yeniden başlatın veya yükseltilmiş komut kabuğunda aşağıdaki komutları yürütün:
net stop was /y
net start w3svc
Not
IIS Paylaşılan Yapılandırması hakkında bilgi için bkz. IIS Paylaşılan Yapılandırması ile ASP.NET Core Modülü.
Visual Studio ile yayımlarken Web Dağıtımı'nı yükleme
Web Dağıtımı ile uygulamaları sunuculara dağıtırken, sunucuya Web Dağıtımı'nın en son sürümünü yükleyin. Web Dağıtımı'nı yüklemek için Web Platformu Yükleyicisi'ni (WebPI) kullanın veya bkz . IIS İndirmeleri: Web Dağıtımı. Tercih edilen yöntem WebPI kullanmaktır. WebPI, barındırma sağlayıcıları için tek başına bir kurulum ve bir yapılandırma sunar.
IIS sitesini oluşturma
Barındırma sisteminde, uygulamanın yayımlanan klasörleriyle dosyalarını içerecek bir klasör oluşturun. Aşağıdaki adımda klasörün yolu, uygulamanın fiziksel yolu olarak IIS'ye sağlanır. Uygulamanın dağıtım klasörü ve dosya düzeni hakkında daha fazla bilgi için bkz. ASP.NET Core dizin yapısı.
IIS Yöneticisi'nde, Bağlantılar panelinde sunucunun düğümünü açın. Siteler klasörüne sağ tıklayın. Bağlam menüsünden Web Sitesi Ekle'yi seçin.
Site adı girin ve Fiziksel yol olarak uygulamanın dağıtım klasörünü ayarlayın. Bağlama yapılandırmasını sağlayın ve Tamam'ı seçerek web sitesini oluşturun:
Uyarı
En üst düzey joker karakter bağlamaları (
http://*:80/vehttp://+:80) kullanılmamalıdır. En üst düzey joker karakter bağlamaları uygulamanızda güvenlik açıklarına neden olabilir. Bu durum hem güçlü hem de zayıf joker karakterler için geçerlidir. Joker karakterler yerine açık konak adları kullanın. Üst etki alanının tamamını denetliyorsanız alt etki alanı bağlamasının (örneğin*.mysub.com) böyle bir güvenlik riski yoktur (güvenlik açığı olan*.combağlamasından farklı olarak). Daha fazla bilgi için bkz. RFC 9110: HTTP Semantiği (Bölüm 7.2: Konak ve :yetkili).Sunucunun düğümü altında Uygulama Havuzları'nı seçin.
Sitenin uygulama havuzuna sağ tıklayın ve bağlam menüsünden Temel Ayarlar'ı seçin.
Uygulama Havuzunu Düzenle penceresinde .NET CLR sürümü'nü Yönetilen Kod Yok olarak ayarlayın:
ASP.NET Core ayrı bir işlemde çalıştırılır ve çalışma zamanını yönetir. ASP.NET Core masaüstü CLR'yi (.NET CLR) yüklemeye bağlı değildir. Uygulamayı çalışan işleminde barındırmak için .NET Core için Core Ortak Dil Çalışma Zamanı Modülü (CoreCLR) önyüklenir. .NET CLR sürümü olarak Yönetilen Kod Yok seçeneğinin ayarlanması isteğe bağlıdır ama önerilir.
ASP.NET Core 2.2 veya üzeri:
İşlem içi barındırma modeli kullanan ve bir 32 bit SDK'sıyla yayımlanan 32 bit (x86) kendi içinde dağıtım için, 32 bit için Uygulama Havuzu'nu etkinleştirin. IIS Yöneticisi'nde Bağlantılar kenar çubuğundaki Uygulama Havuzları'na gidin. Uygulamanın Uygulama Havuzunu seçin. Eylemler kenar çubuğunda Gelişmiş Ayarlar'ı seçin. 32 Bit Uygulamaları Etkinleştir seçeneğini
Trueolarak ayarlayın.İşlem içi barındırma modeli kullanan 64 bit (x64) kendi içinde dağıtım için, 32 bit (x86) işlemlerinin uygulama havuzunu devre dışı bırakın. IIS Yöneticisi'nde Bağlantılar kenar çubuğundaki Uygulama Havuzları'na gidin. Uygulamanın Uygulama Havuzunu seçin. Eylemler kenar çubuğunda Gelişmiş Ayarlar'ı seçin. 32 Bit Uygulamaları Etkinleştir seçeneğini
Falseolarak ayarlayın.
İşlem modelinin identity uygun izinlere sahip olduğunu onaylayın.
identity Uygulama havuzunun varsayılan değeri (İşlem ModeliIdentity>) ApplicationPoolIdentity yerine başka bir identityöğesine değiştirilirse, yeninin identity uygulamanın klasörüne, veritabanına ve diğer gerekli kaynaklara erişmek için gerekli izinlere sahip olduğunu doğrulayın. Örneğin uygulama havuzu için uygulamanın dosyaları okuduğu ve yazdığı klasörlere okuma ve yazma erişimi gerekir.
Windows Kimlik Doğrulaması yapılandırması (İsteğe Bağlı)
Daha fazla bilgi için bkz. Windows kimlik doğrulamasını yapılandırma.
Uygulamayı dağıtma
Uygulamayı IIS sitesini oluşturma bölümünde oluşturulan IIS Fiziksel yol klasörüne dağıtın. Web Dağıtımı, dağıtım için önerilen mekanizmadır ama uygulamayı projenin publish klasöründen barındırma sisteminin dağıtım klasörüne taşımak için çeşitli seçenekler vardır.
Visual Studio ile Web Dağıtımı
Web Dağıtımı ile kullanılacak bir yayımlama oluşturmayı öğrenmek için ASP.NET Core uygulama dağıtımı için Visual Studio yayımlama profilleri konusuna bakın. Barındırma sağlayıcısı bir Yayımlama Profili sağlıyorsa veya bu profili oluşturmayı destekliyorsa, profili indirin ve Visual Studio Yayımla iletişim kutusunu kullanarak içeri aktarın:
Visual Studio'nun dışında Web Dağıtımı
Web Dağıtımı Visual Studio'nun dışında komut satırından da kullanılabilir. Daha fazla bilgi için bkz. Web Dağıtım Aracı.
Web Dağıtımı'nın alternatifleri
Uygulamayı barındırma sistemine taşımak için el ile kopyalama, Xcopy, Robocopy veya PowerShell gibi çeşitli yöntemlerden herhangi birini kullanın.
IIS'ye ASP.NET Core dağıtımı hakkında daha fazla bilgi için IIS yöneticileri için dağıtım kaynakları bölümüne bakın.
Web sitesine göz atma
Uygulama barındırma sistemine dağıtıldıktan sonra uygulamanın genel uç noktalarına bir istek yöneltin.
Aşağıdaki örnekte, site Bağlantı Noktası 80üzerinde iis ana bilgisayar adına www.mysite.com bağlıdır. http://www.mysite.com konumuna bir istek yöneltilir:
Kilitli dağıtım dosyaları
Uygulama çalıştırılırken dağıtım klasöründeki dosyalar kilitlenir. Dağıtım sırasında kilitli dosyaların üzerine yazılamaz. Dağıtımda kilitli dosyaları serbest bırakmak için aşağıdaki yaklaşımlardan birini kullanarak uygulama havuzunu durdurun:
Web Dağıtımı'nı kullanın ve proje dosyasında
Microsoft.NET.Sdk.WebSDK'sına başvurun. Web uygulamasının köküne birapp_offline.htmdosyası yerleştirilir. Dosya mevcut olduğunda ASP.NET Core Modülü uygulamayı düzgün bir şekilde kapatır ve dağıtım sırasındaapp_offline.htmdosyasını kullanıma sunar. Daha fazla bilgi için bkz. ASP.NET Core Modülü yapılandırma başvurusu.Sunucudaki IIS Yöneticisi'nde uygulama havuzunu el ile durdurun.
app_offline.htmdosyasını bırakmak için PowerShell kullanın (PowerShell 5 veya üzeri gerekir):$pathToApp = 'PATH_TO_APP' # Stop the AppPool New-Item -Path $pathToApp app_offline.htm # Provide script commands here to deploy the app # Restart the AppPool Remove-Item -Path $pathToApp app_offline.htm
Veri koruması
ASP.NET Core Veri Koruma yığını, kimlik doğrulamasında kullanılan ara yazılım da dahil olmak üzere çeşitli ASP.NET Core ara yazılımlarında kullanılır. Veri Koruma API'leri kullanıcı kodu tarafından çağrılmıyor olsa bile, kalıcı bir şifreleme anahtar deposu oluşturmak için dağıtım betiğiyle veya kullanıcı kodu içinde yapılandırılmalıdır. Veri koruması yapılandırılmazsa anahtarlar bellekte tutulur ve uygulama yeniden başlatıldığında atılır.
Anahtarlık bellekte depolanıyorsa uygulama yeniden başlatıldığında:
- Tüm cookie tabanlı kimlik doğrulama belirteçleri geçersiz kılınır.
- Kullanıcıların, sonraki isteklerinde yeniden oturum açmaları gerekir.
- Artık anahtarlıkla korunan verilerin şifresi çözülemez. Bu, CSRF belirteçlerini ve ASP.NET Core MVC TempData tanımlama bilgilerini içerebilir.
IIS altında veri korumasını anahtarlığın kalıcı olmasını sağlayacak şekilde yapılandırmak için aşağıdaki yaklaşımlardan birini kullanın:
Veri Koruması Kayıt Defteri Anahtarlarını Oluşturma
ASP.NET Core uygulamaları tarafından kullanılan veri koruma anahtarları uygulamaların dışındaki kayıt defterinde depolanır. Belirli bir uygulamaya yönelik anahtarların kalıcı olmasını sağlamak için uygulama havuzuna kayıt defteri anahtarları oluşturun.
Tek başına, webfarm olmayan IIS yüklemeleri için, ASP.NET Core uygulamasıyla kullanılan her uygulama havuzunda Data Protection Provision-AutoGenKeys.ps1 PowerShell betiği kullanılabilir. Bu betik HKLM kayıt defterinde yalnızca uygulamanın uygulama havuzu çalışan işlemi hesabıyla erişilebilen bir kayıt defteri anahtarı oluşturur. Anahtarlar, makine genelinde bir anahtarla DPAPI kullanılarak şifrelenir rest .
Web grubu senaryolarında, uygulama kendi veri koruma anahtarlığını depolamak için bir UNC yolu kullanacak şekilde yapılandırılabilir. Varsayılan olarak veri koruma anahtarları şifrelenmez. Ağ paylaşımına yönelik dosya izinlerinin, uygulamanın altında çalıştırıldığı Windows hesabıyla sınırlı olduğundan emin olun. X509 sertifikası, konumundaki restanahtarları korumak için kullanılabilir. Kullanıcıların sertifikaları karşıya yüklemesine olanak tanıyan bir mekanizma düşünün: Sertifikaları kullanıcının güvenilen sertifika deposuna yerleştirin ve kullanıcının uygulama çalıştırdığı tüm makinelerde bu deponun kullanılabildiğinden emin olun. Ayrıntılar için bkz. ASP.NET Core Veri Koruması'nı yapılandırma.
IIS Uygulama Havuzu'nu kullanıcı profilini yükleyecek şekilde yapılandırma
Bu ayar uygulama havuzu için Gelişmiş Ayarlar'ın altında yer alan İşlem Modeli bölümündedir. Kullanıcı Profilini Yükle seçeneğini
Trueolarak ayarlayın.Trueolarak ayarlandığında anahtarlar kullanıcı profili dizininde depolanır ve kullanıcı hesabına özgü bir anahtarla DPAPI kullanılarak korunur. Anahtarlar kalıcı olarak %LOCALAPPDATA%/ASP.NET/DataProtection-Keys klasöründe yer alır.Uygulama havuzunun setProfileEnvironment özniteliği de etkinleştirilmelidir.
setProfileEnvironmentiçin varsayılan değertruedeğeridir. Bazı senaryolarda (örneğin Windows işletim sistemi)setProfileEnvironmentfalseolarak ayarlanır. Anahtarlar beklendiği gibi kullanıcı profili dizininde depolanmıyorsa:- %windir%/system32/inetsrv/config klasörüne gidin.
- applicationHost.config dosyasını açın.
<system.applicationHost><applicationPools><applicationPoolDefaults><processModel>öğesini bulun.- Varsayılan değeri
trueolansetProfileEnvironmentözniteliğinin mevcut olmadığını veya özniteliğin açıkçatruedeğerine ayarlanmadığını onaylayın.
Dosya sistemini anahtarlık deposu olarak kullanma
Uygulama kodunu, dosya sistemini anahtarlık deposu olarak kullanacak şekilde ayarlayın. Anahtarlığı korumak için X509 sertifikası kullanın ve sertifikanın güvenilen bir sertifika olduğundan emin olun. Sertifika otomatik olarak imzalandıysa sertifikayı Güvenilen Kök deposuna yerleştirin.
Web grubunda IIS kullanırken:
- Tüm makinelerin erişebildiği bir dosya paylaşımı kullanın.
- Her makineye bir X509 sertifikası dağıtın. Kodda veri korumasını yapılandırın.
Veri koruması için makine genelinde bir ilke ayarlama
Veri koruma sisteminin, Veri Koruma API'lerini kullanan tüm uygulamalar için varsayılan bir makine genelinde illke ayarlamaya yönelik sınırlı desteği vardır. Daha fazla bilgi için bkz. ASP.NET Core Veri Koruması'na Genel Bakış.
Sanal Dizinler
ASP.NET Core uygulamalarıyla IIS Sanal Dizinleri desteklenmez. Uygulama bir alt uygulama olarak barındırılabilir.
Alt uygulamalar
ASP.NET Core uygulaması bir IIS alt uygulaması (alt uygulama) olarak barındırılabilir. Alt uygulamanın yolu kök uygulama URL'sinin bir parçası olur.
Alt uygulama içindeki statik varlık bağlantıları tilde-eğik çizgi (~/) gösterimini kullanmalıdır. Tilde-eğik çizgi gösterimi, alt uygulamanın yol tabanını işlenen göreli bağlantının önüne eklemek için bir Etiket Yardımcısını tetikler. /subapp_path yolundaki bir alt uygulama için, src="~/image.png" ile bağlantılı bir resim src="/subapp_path/image.png" olarak işlenir. Kök uygulamanın Statik Dosya Ara Yazılımı statik dosya isteğini işlemez. İstek alt uygulamanın Statik Dosya Ara Yazılımı tarafından işlenir.
Statik varlığın src özniteliği bir mutlak yola ayarlanırsa (örneğinsrc="/image.png"), bağlantı alt uygulamanın yol tabanı olmadan işlenir. Kök uygulamanın Statik Dosya Ara Yazılımı kök uygulamanın web kökünden varlığa hizmet vermeyi dener ve statik varlık kök uygulamadan kullanıma sunulmadığı sürece bu deneme 404 - Bulunmadı yanıtıyla sonuçlanır.
ASP.NET Core uygulamasını bir alt uygulama olarak ASP.NET Core uygulamasının altında barındırmak için:
Alt uygulama için bir uygulama havuzu oluşturun. Uygulamayı çalışan işleminde barındırmak için masaüstü CLR (.NET CLR) değil Core Ortak Dil Çalışma Zamanı Modülü (CoreCLR) önyüklendiğinden, .NET CLR Sürümü'nü Yönetilen Kod Yok olarak ayarlayın.
Alt uygulama kök sitenin altındaki bir klasörde yer alırken kök siteyi IIS Yöneticisi'ne ekleyin.
IIS Yöneticisi'nde alt uygulama klasörüne sağ tıklayın ve Uygulamaya Dönüştür'ü seçin.
Uygulama Ekle iletişim kutusunda Uygulama Havuzu için Seç düğmesini kullanarak alt uygulama için oluşturduğunuz uygulama havuzunu atayın. Tamam'ı seçin.
İşlem içi barındırma modelini kullanırken, alt uygulamaya ayrı uygulama havuzu ataması bir gereksinimdir.
İşlem içi barındırma modeli ve ASP.NET Core Modülü'nü yapılandırma hakkında daha fazla bilgi için bkz. IIS için ASP.NET Core Modülü (ANCM).
Web.config ile IIS yapılandırması
ASP.NET Core Modülü ile ASP.NET Core uygulamaları için kullanılabilen IIS senaryolarında, IIS yapılandırmasını web.config dosyasının <system.webServer> bölümü etkiler. Örneğin IIS yapılandırması dinamik sıkıştırma için kullanılabilir. IIS sunucu düzeyinde dinamik sıkıştırmayı kullanacak şekilde yapılandırıldıysa, uygulamanın web.config dosyasındaki <urlCompression> öğesi ASP.NET Core uygulaması için bunu devre dışı bırakabilir.
Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:
- <system.webServer> için yapılandırma başvurusu
- IIS için ASP.NET Core Modülü (ANCM)
- ASP.NET Core içeren IIS modülleri
Yalıtılmış uygulama havuzlarında çalıştırılan tek tek uygulamalara ortam değişkenleri ayarlamak için (IIS 10.0 veya üzerinde desteklenir), IIS başvuru belgelerinde Ortam Değişkenleri <environmentVariables> konusunun AppCmd.exe komutu bölümüne bakın.
ASP.NET Core tarafından kullanılmayan bölümler
Web.config dosyasında ASP.NET uygulamalarının yapılandırma bölümleri ASP.NET Core uygulamaları tarafından yapılandırma için kullanılmaz:
<system.web><appSettings><connectionStrings><location>
ASP.NET Core uygulamaları diğer yapılandırma sağlayıcıları kullanılarak yapılandırılır. Daha fazla bilgi için bkz. Yapılandırma ve .NET Core çalışma zamanı yapılandırma ayarları
Uygulama Havuzları
Uygulama havuzu yalıtımı barındırma modeli tarafından belirlenir:
- İşlem içi barındırma: Uygulamaların ayrı uygulama havuzlarında çalıştırılması gerekir.
- İşlem dışı barındırma: Her uygulamayı kendi uygulama havuzunda çalıştırarak uygulamaları birbirinden yalıtmanızı öneririz.
IIS Web Sitesi Ekle iletişim kutusu varsayılan olarak uygulama başına tek bir uygulama havuzu ayarlar. Site adı sağlandığında, bu metin otomatik olarak Uygulama havuzu metin kutusuna aktarılır. Site eklendiğinde site adı kullanılarak yeni bir uygulama havuzu oluşturulur.
Uygulama Havuzu Identity
Uygulama havuzu identity hesabı, bir uygulamanın etki alanları veya yerel hesaplar oluşturmak ve yönetmek zorunda kalmadan benzersiz bir hesap altında çalışmasına olanak tanır. IIS 8.0 veya üzerinde, IIS Yönetici Çalışan İşlemi (WAS) yeni uygulama havuzunun adıyla sanal bir hesap oluşturur ve uygulama havuzunun çalışan işlemlerini varsayılan olarak bu hesap altında çalıştırılır. Uygulama havuzu için Gelişmiş Ayarlar'ın altındaki IIS Yönetim Konsolu'nda, öğesinin ApplicationPoolIdentity kullanacak şekilde ayarlandığından Identity emin olun:
IIS yönetim işlemi Windows Güvenlik Sistemi'nde uygulama havuzunun adıyla güvenli bir tanımlayıcı oluşturur. Kaynaklar bu identitykullanılarak güvenli hale getirilebilir. Ancak bu identity gerçek bir kullanıcı hesabı değildir ve Windows Kullanıcı Yönetimi Konsolu'nda gösterilmez.
IIS çalışan işlemine uygulama üzerinde yükseltilmiş erişim gerekiyorsa, uygulamayı içeren dizin için Erişim Denetim Listesi'ni (ACL) değiştirin:
Windows Gezgini'ni açın ve dizine gidin.
Dizine sağ tıklayın ve Özellikler'i seçin.
Güvenlik sekmesinin altında Düzenle düğmesini ve sonra da Ekle düğmesini seçin.
Konumlar düğmesini seçin ve sistemin seçildiğinden emin olun.
Seçilecek nesne adlarını girin alanında
IIS AppPool\{APP POOL NAME}girin; burada{APP POOL NAME}yer tutucusu uygulama havuzu adıdır. Adları Denetle düğmesini seçin. DefaultAppPool içinIIS AppPool\DefaultAppPoolkullanarak adları denetleyin. Adları Denetle düğmesi seçildiğinde nesne adları alanındaDefaultAppPooldeğeri gösterilir. Uygulama havuzu adını doğrudan nesne adları alanına girmek mümkün değildir. Nesne adını denetlerkenIIS AppPool\{APP POOL NAME}biçimini kullanın; burada{APP POOL NAME}yer tutucusu uygulama havuzu adıdır.
Tamam'ı seçin.
Okuma ve yürütme izinleri varsayılan olarak verilmelidir. Gerekirse ek izinler sağlayın.
Komut isteminde ICACLS aracı kullanılarak da erişim verilebilir. Örnek olarak DefaultAppPool kullanıldığında aşağıdaki komut kullanılır:
ICACLS C:\sites\MyWebApp /grant "IIS AppPool\DefaultAppPool":F
Daha fazla bilgi için icacls konusuna bakın.
HTTP/2 desteği
Aşağıdaki IIS dağıtım senaryolarında ASP.NET Core ile birlikte HTTP/2 desteklenir:
- İşlemde
- Windows Server 2016/Windows 10 veya üzeri; IIS 10 veya üzeri
- TLS 1.2 veya üzeri bağlantısı
- İşlem dışı
- Windows Server 2016/Windows 10 veya üzeri; IIS 10 veya üzeri
- Genel kullanıma yönelik uç sunucu bağlantıları HTTP/2 kullanır ama Kestrel sunucusuna ters ara sunucu bağlantısı HTTP/1.1 kullanır.
- TLS 1.2 veya üzeri bağlantısı
HTTP/2 bağlantısı kurulduğunda işlem içi dağıtım için HttpRequest.Protocol HTTP/2 bildirir. HTTP/2 bağlantısı kurulduğunda işlem dışı dağıtım için HttpRequest.Protocol HTTP/1.1 bildirir.
İşlem içi ve işlem dışı barındırma modelleri hakkında daha fazla bilgi için bkz. IIS için ASP.NET Core Modülü (ANCM).
HTTP/2 varsayılan olarak etkinleştirilir. HTTP/2 bağlantısı kurulamazsa bağlantılar HTTP/1.1'e geri döner. IIS dağıtımlarıyla HTTP/2 yapılandırması hakkında daha fazla bilgi için bkz. IIS üzerinde HTTP/2.
CORS denetim öncesi istekleri
Bu bölüm yalnızca .NET Framework'ü hedefleyen ASP.NET Core uygulamalarına yöneliktir.
.NET Framework'ü hedefleyen ASP.NET Core uygulaması için, IIS'de OPTIONS istekleri varsayılan olarak uygulamaya geçirilmez. OPTIONS isteklerini göndermek üzere web.config dosyasında uygulamanın IIS işleyicilerini yapılandırmayı öğrenmek için bkz. ASP.NET Web API 2'de kaynaklar arası istekleri etkinleştirme: CORS Nasıl Çalışır?
Uygulama Başlatma Modülü ve Boşta Kalma Zaman Aşımı
ASP.NET Core Modülü sürüm 2 tarafından IIS'de barındırıldığında:
- Uygulama Başlatma Modülü: İşlem içi veya işlem dışı barındırılan uygulamalar, çalışan işlemi yeniden başlatması veya sunucu yeniden başlatması sırasında otomatik olarak başlatılacak şekilde yapılandırılabilir.
- Boşta Kalma Zaman Aşımı: İşlem içi barındırılan uygulamalar, etkinlik dışı kaldıkları dönemlerde zaman aşımına uğramayacak şekilde yapılandırılabilir.
Uygulama Başlatma Modülü
İşlem içi ve işlem dışı barındırılan uygulamalar için geçerlidir.
IIS Uygulama Başlatma, uygulama havuzu başlatıldığında veya geri dönüştürüldüğünde uygulamaya HTTP isteği gönderen bir IIS özelliğidir. İstek, uygulamanın başlatılmasını tetikler. Varsayılan olarak, IIS uygulamayı başlatmak için uygulamanın kök URL'sine (/) bir istek gönderir (yapılandırmayla ilgili diğer ayrıntılar için bkz. Ek kaynaklar).
IIS Uygulama Başlatma rolü özelliğinin etkinleştirildiğini onaylayın:
Windows 7 veya üzeri masaüstü sistemlerinde IIS'yi yerel olarak kullanırken:
- Denetim Masası>Programlar>Programlar ve Özellikler> gidinWindows özelliklerini aç veya kapat seçeneğine gidin (ekranın sol tarafında).
- Internet Information Services>World Wide Web Hizmetleri>Uygulama Geliştirme Özellikleri'ni açın.
- Uygulama Başlatma onay kutusunu seçin.
Windows Server 2008 R2 veya üzerinde:
- Rol ve Özellik Ekleme Sihirbazı'nı açın.
- Rol hizmetlerini seçin panelinde Uygulama Geliştirme düğümünü açın.
- Uygulama Başlatma onay kutusunu seçin.
Sitede Uygulama Başlatma Modülü'nü etkinleştirmek için aşağıdaki yaklaşımlardan birini kullanın:
IIS Yöneticisi'ni kullanma:
- Bağlantılar panelinde Uygulama Havuzları'nı seçin.
- Listede uygulamanın uygulama havuzuna sağ tıklayın ve Gelişmiş Ayarlar'ı seçin.
- Varsayılan Başlatma Modu OnDemand'dır. Başlangıç Modu'nu AlwaysRunning olarak ayarlayın. Tamam'ı seçin.
- Bağlantılar panelinde Siteler düğümünü açın.
- Uygulamaya sağ tıklayın ve Web Sitesini Yönet>Gelişmiş Ayarlar'ı seçin.
- Varsayılan Önyükleme Etkin ayarı False'dur. Önyükleme Etkin öğesini True olarak ayarlayın. Tamam'ı seçin.
web.configdosyasını kullanarak,doAppInitAfterRestartöğesindetrueayarıyla<applicationInitialization>öğesini uygulamanın web.config dosyasındaki<system.webServer>öğelerine ekleyin:<?xml version="1.0" encoding="utf-8"?> <configuration> <location path="." inheritInChildApplications="false"> <system.webServer> <applicationInitialization doAppInitAfterRestart="true" /> </system.webServer> </location> </configuration>
Boşta Kalma Süresi Zaman Aşımı
Yalnızca işlem içinde barındırılan uygulamalar için geçerlidir.
Uygulamanın boşta kalmasını önlemek için IIS Yöneticisi'ni kullanarak uygulama havuzunun boşta kalma zaman aşımı değerini ayarlayın:
- Bağlantılar panelinde Uygulama Havuzları'nı seçin.
- Listede uygulamanın uygulama havuzuna sağ tıklayın ve Gelişmiş Ayarlar'ı seçin.
- Varsayılan Boşta kalma zaman aşımı (dakika) değeri 20 dakikadır. Boşta kalma zaman aşımı (dakika) değerini 0 (sıfır) olarak ayarlayın. Tamam'ı seçin.
- Çalışan işlemini geri dönüştürün.
İşlem dışında barındırılan uygulamaların zaman aşımına uğramasını önlemek için aşağıdaki yaklaşımlardan birini kullanın:
- Uygulamayı çalışır durumda tutmak için bir dış hizmetten uygulamaya ping gönderin.
- Uygulama yalnızca arka plan hizmetlerini barındırıyorsa IIS barındırmasından kaçının ve ASP.NET Core uygulamasını barındırmak için bir Windows Hizmeti kullanın.
Uygulama Başlatma Modülü ve Boşta Kalma Zaman Aşımı ek kaynakları
- IIS 8.0 Uygulama Başlatma
- Uygulama Başlatma <applicationInitialization>.
- Uygulama Havuzu için İşlem Modeli Ayarları <processModel>.
IIS yöneticileri için dağıtım kaynakları
- IIS belgeleri
- IIS'de IIS Yöneticisi ile Çalışmaya Başlama
- .NET Core uygulama dağıtımı
- IIS için ASP.NET Core Modülü (ANCM)
- ASP.NET Core dizin yapısı
- ASP.NET Core içeren IIS modülleri
- Azure App Service ve IIS'de ASP.NET Core sorunlarını giderme
- ASP.NET Core ile Azure App Service ve IIS için yaygın hataları giderme
Ek kaynaklar
ASP.NET Core uygulamasını IIS sunucusuna yayımlamaya yönelik bir öğretici deneyimi için bkz. ASP.NET Core uygulamasını IIS'ye yayımlama.
.NET Core Barındırma Paketini Yükleme
Desteklenen işletim sistemleri
Aşağıdaki işletim sistemleri desteklenmektedir:
- Windows 7 veya üzeri
- Windows Server 2008 R2 veya üzeri
HTTP.sys sunucusu (eski adı WebListener) IIS ile bir ters ara sunucu yapılandırmasında çalışmaz. Kestrel sunucusunu kullanın.
Azure'da barındırma hakkında bilgi için bkz. ASP.NET Core uygulamalarını Azure App Service'e dağıtma.
Sorun giderme kılavuzu için bkz. ASP.NET Core projelerinde sorun giderme ve hata ayıklama.
Desteklenen platformlar
32 bit (x86) veya 64 bit (x64) dağıtımı için yayımlanan uygulamalar desteklenir. Aşağıdaki durumlar dışında 32 bit uygulamayı 32 bit (x86) .NET Core SDK'sıyla dağıtabilirsiniz:
- Uygulamaya, 64 bit uygulamaya sağlanan daha büyük sanal bellek adres alanı gerekiyor.
- Uygulamaya daha büyük IIS yığın boyutu gerekiyor.
- Uygulamanın 64 bit yerel bağımlılıkları var.
64 bit uygulamasını yayımlamak için 64 bit (x64) .NET Core SDK'sını kullanın. Konak sisteminde 64 bit çalışma zamanı mevcut olmalıdır.
ASP.NET Core varsayılan, platformlar arası bir HTTP sunucusu olan Kestrel sunucusu ile gönderilir.
IIS veya IIS Express kullanıldığında, uygulama Kestrel sunucusuyla IIS çalışan işleminden ayrı bir işlemde (işlem dışı) çalıştırılır.
ASP.NET Core uygulamaları IIS çalışan işleminden ayrı bir işlemde çalıştırıldığından, işlem yönetimini modül gerçekleştirir. İlk istek geldiğinde modül ASP.NET Core uygulaması için işlemi başlatır ve uygulama kapanırsa veya kilitlenirse uygulamayı yeniden başlatır. Bu temelde, Windows İşlem Etkinleştirme Hizmeti (WAS) tarafından yönetilen, işlem içinde çalıştırılan uygulamalarda görünen davranışla aynıdır.
Aşağıdaki diyagramda IIS, ASP.NET Core Modülü ve işlem dışında barındırılan uygulama arasındaki ilişki gösterilir:
Web'den çekirdek modundaki HTTP.sys sürücüsüne istekler gelir. Sürücü istekleri web sitesinin yapılandırılmış bağlantı noktası üzerinden (genellikle 80 (HTTP) veya 443 (HTTPS)) IIS'ye yönlendirir. Modül istekleri uygulama için 80 veya 443 olmayan rastgele bir bağlantı noktası üzerinden Kestrel'e iletir.
Modül bağlantı noktasını başlatma sırasında bir ortam değişkeni aracılığıyla belirtir ve IIS Tümleştirme Ara Yazılımı sunucuyu http://localhost:{port} üzerinden dinleyecek şekilde yapılandırır. Ek denetimler gerçekleştirilir ve modülden kaynaklanmayan istekler reddedilir. Modül HTTPS iletmeyi desteklemez, dolayısıyla IIS tarafından HTTPS üzerinden alınan istekler bile HTTP üzerinden iletilir.
Kestrel isteği modülden aldıktan sonra, istek ASP.NET Core ara yazılım işlem hattına gönderilir. Ara yazılım işlem hattı isteği işler ve bir HttpContext örneği olarak uygulamanın mantığına geçirir. IIS Tümleştirmesi tarafından eklenen ara yazılım, isteği Kestrel'e iletme işlemini gerçekleştirmek için şemayı, uzak IP'yi ve yol tabanını güncelleştirir. Uygulamanın yanıtı IIS'ye geri geçirilir ve IIS de bunu geriye, isteği başlatan HTTP istemcisine gönderir.
CreateDefaultBuilder Kestrel sunucusunu web sunucusu olarak yapılandırır ve ASP.NET Core Modülü için temel yolu ve bağlantı noktasını yapılandırarak IIS tümleştirmesini etkinleştirir.
ASP.NET Core Modülü arka uç işlemine atamak üzere dinamik bir bağlantı noktası oluşturur. CreateDefaultBuilder UseIISIntegration yöntemini çağırır. UseIISIntegration, Kestrel sunucusunu localhost IP adresindeki (127.0.0.1) dinamik bağlantı noktası üzerinden dinleyecek şekilde yapılandırır. Dinamik bağlantı noktası 1234 ise, Kestrel 127.0.0.1:1234 konumunda dinler. Bu yapılandırma aşağıdakiler tarafından sağlanan diğer URL yapılandırmalarının yerini alır:
UseUrls- Kestrel'in Dinleme API'si
- Yapılandırma (veya komut satırı --urls seçeneği)
Modül kullanılırken UseUrls veya Kestrel'in Listen API'si çağrıları gerekli değildir. UseUrls veya Listen çağrılırsa, Kestrel yalnızca uygulama IIS olmadan çalıştırılırken belirtilen bağlantı noktası üzerinden dinler.
ASP.NET Core Modülü yapılandırma rehberi için bkz. IIS için ASP.NET Core Modülü (ANCM).
Barındırma hakkında daha fazla bilgi için bkz. ASP.NET Core'da barındırma.
Uygulama yapılandırması
IISIntegration bileşenlerini etkinleştirme
CreateWebHostBuilder yönteminde bir konak oluştururken (Program.cs) IIS tümleştirmesini etkinleştirmek için CreateDefaultBuilder yöntemini çağırın:
public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
WebHost.CreateDefaultBuilder(args)
...
CreateDefaultBuilder hakkında daha fazla bilgi için bkz. ASP.NET Core Web Konağı.
IIS seçenekleri
| Seçenek | Varsayılan | Ayar |
|---|---|---|
AutomaticAuthentication |
true |
true olduğunda, IIS Sunucusu HttpContext.User özelliğini Windows Kimlik Doğrulaması tarafından kimliği doğrulanmış olarak ayarlar. isefalse, sunucu yalnızca için HttpContext.User bir identity sağlar ve tarafından açıkça istendiğinde zorluklara AuthenticationSchemeyanıt verir. AutomaticAuthentication'ın çalışması için IIS'de Windows Kimlik Doğrulaması'nın etkinleştirilmesi gerekir. Daha fazla bilgi için bkz. Windows Kimlik Doğrulaması. |
AuthenticationDisplayName |
null |
Oturum açma sayfalarında kullanıcılara gösterilen görünen adı ayarlar. |
IIS seçeneklerini yapılandırmak için ConfigureServices yönteminde IISOptions için bir hizmet yapılandırması ekleyin. Aşağıdaki örnek uygulamanın HttpContext.Connection.ClientCertificate özelliğini doldurmasını engeller:
services.Configure<IISOptions>(options =>
{
options.ForwardClientCertificate = false;
});
| Seçenek | Varsayılan | Ayar |
|---|---|---|
AutomaticAuthentication |
true |
true olduğunda, IIS Tümleştirme Ara Yazılımı HttpContext.User özelliğini Windows Kimlik Doğrulaması tarafından kimliği doğrulanmış olarak ayarlar. isefalse, ara yazılım yalnızca için HttpContext.User bir identity sağlar ve tarafından açıkça istendiğinde zorluklara AuthenticationSchemeyanıt verir. AutomaticAuthentication'ın çalışması için IIS'de Windows Kimlik Doğrulaması'nın etkinleştirilmesi gerekir. Daha fazla bilgi için Windows Kimlik Doğrulaması konusuna bakın. |
AuthenticationDisplayName |
null |
Oturum açma sayfalarında kullanıcılara gösterilen görünen adı ayarlar. |
ForwardClientCertificate |
true |
true olduğunda ve MS-ASPNETCORE-CLIENTCERT istek üst bilgisi de mevcut olduğunda HttpContext.Connection.ClientCertificate doldurulur. |
Ara sunucu ve yük dengeleyici senaryoları
İletilen Üst Bilgiler Ara Yazılımı'nı yapılandıran IIS Tümleştirme Ara Yazılımı ve ASP.NET Core Modülü şemayı (HTTP/HTTPS) ve isteğin kaynaklandığı uzak IP adresini iletecek şekilde yapılandırılır. Ek ara sunucuların ve yük dengeleyicilerin arkasında barındırılan uygulamalar için ek yapılandırma gerekebilir. Daha fazla bilgi için bkz. ASP.NET Core'u ara sunucular ve yük dengeleyicilerle çalışacak şekilde yapılandırma.
web.config dosyası
Web.config dosyası ASP.NET Core Modülü'nü yapılandırır. Web.config dosyasını oluşturma, dönüştürme ve yayımlama işlemleri proje yayımlandığında MSBuild hedefi (_TransformWebConfig) tarafından gerçekleştirilir. Bu hedef, Web SDK'sı hedefleri (Microsoft.NET.Sdk.Web) arasında yer alır. SDK, proje dosyasının üst kısmında ayarlanır:
<Project Sdk="Microsoft.NET.Sdk.Web">
Projede web.config dosyası yoksa, dosya ASP.NET Core Modülü'nü yapılandırmak için doğru processPath ve arguments ile oluşturulur ve yayımlanan çıkışa taşınır.
Projede web.config dosyası varsa, dosya ASP.NET Core Modülü'nü yapılandırmak için doğru processPath ve arguments ile dönüştürülür ve yayımlanan çıkışa taşınır. Dönüşüm dosyadaki IIS yapılandırma ayarlarını değiştirmez.
Web.config dosyası etkin IIS modüllerini denetleyen ek IIS yapılandırma ayarları sağlayabilir. ASP.NET Core uygulamalarıyla istekleri işleyebilen IIS modülleri hakkında bilgi için IIS modülleri konusuna bakın.
Web SDK'sının web.config dosyasını dönüştürmesini önlemek için proje dosyasında <IsTransformWebConfigDisabled> özelliğini kullanın:
<PropertyGroup>
<IsTransformWebConfigDisabled>true</IsTransformWebConfigDisabled>
</PropertyGroup>
Web SDK'sının dosyayı dönüştürmesi devre dışı bırakıldığında processPath ve arguments geliştirici tarafından el ile ayarlanmalıdır. Daha fazla bilgi için bkz. IIS için ASP.NET Core Modülü (ANCM).
Web.config dosyasının konumu
ASP.NET Core Modülü'nü doğru ayarlayabilmek için, dağıtılan uygulamanın içerik kökü yolunda (tipik olarak uygulama temel yolu) web.config dosyası mevcut olmalıdır. Bu, IIS'ye sağlanan web sitesi fiziksel yoluyla aynı konumdur. Web Dağıtımı'nı kullanarak birden fazla uygulamanın yayımlanmasını sağlamak için uygulamanın kökünde web.config dosyasının bulunması gereklidir.
Uygulamanın fiziksel yolunda <assembly>.runtimeconfig.json, <assembly>.xml (XML Belgeleri açıklamaları) ve <assembly>.deps.json gibi hassas dosyalar bulunur. Web.config dosyası mevcut olduğunda ve site normal şekilde başlatıldığında, bu hassas dosyalar istenirse ISS bunları kullanıma sunmaz. Web.config dosyası yoksa, yanlış adlandırıldıysa veya siteyi normal başlatma için yapılandıramazsa, IIS hassas dosyaları genel kullanıma sunabilir.
Web.config dosyası dağıtımda her zaman doğru adlandırılmış olarak ve siteyi normal başlatma için yapılandırabilecek şekilde mevcut olmalıdır. Web.config dosyasını hiçbir zaman üretim dağıtımından kaldırmayın.
Web.config’i dönüştürme
Yayımlama sırasında web.config dosyasını dönüştürmeniz gerekirse (örneğin yapılandırmaya, profile veya ortama bağlı olarak ortam değişkenlerini ayarlama) bkz. Web.config'i dönüştürme.
IIS yapılandırması
Windows Server İşletim Sistemleri
Web Sunucusu (IIS) sunucu rolünü etkinleştirin ve rol hizmetlerini oluşturun.
Yönet menüsünden Rol ve Özellik Ekle sihirbazını veya Sunucu Yöneticisi'ndeki bağlantıyı kullanın. Sunucu Rolleri adımında Web Sunucusu (IIS) kutusunu işaretleyin.
Özellikler adımından sonra Web Sunucusu (IIS) için Rol hizmetleri adımı yüklenir. İstenen IIS rol hizmetlerini seçin veya sağlanan varsayılan rol hizmetlerini kabul edin.
Windows Kimlik Doğrulaması (İsteğe Bağlı)
Windows Kimlik Doğrulaması'nı etkinleştirmek için şu düğümleri genişletin: Web Sunucusu>Güvenlik. Windows Kimlik Doğrulaması özelliğini seçin. Daha fazla bilgi için bkz. Windows Kimlik Doğrulaması <windowsAuthentication> ve Windows kimlik doğrulamasını yapılandırma.WebSockets (İsteğe Bağlı)
WebSockets, ASP.NET Core 1.1 veya üzerinde desteklenir. WebSockets'i etkinleştirmek için şu düğümleri genişletin: Web Sunucusu>Uygulama Geliştirme. WebSocket Protokolü özelliğini seçin. Daha fazla bilgi için bkz. WebSockets.Web sunucusu rolünü ve hizmetlerini yüklemek için Onay adımıyla devam edin. Web Sunucusu (IIS) rolü yüklendikten sonra sunucunun/IIS'nin yeniden başlatılması gerekmez.
Windows masaüstü işletim sistemleri
IIS Yönetim Konsolu'nu ve World Wide Web Hizmetleri'ni etkinleştirin.
Denetim Masası>Programlar>Programlar ve Özellikler> gidinWindows özelliklerini aç veya kapat seçeneğine gidin (ekranın sol tarafında).
Internet Information Services düğümünü açın. Web Yönetimi Araçları düğümünü açın.
IIS Yönetim Konsolu kutusunu işaretleyin.
World Wide Web Hizmetleri kutusunu işaretleyin.
World Wide Web Hizmetleri için varsayılan özellikleri seçin veya IIS özelliklerini özelleştirin.
Windows Kimlik Doğrulaması (İsteğe Bağlı)
Windows Kimlik Doğrulaması'nı etkinleştirmek için şu düğümleri genişletin: World Wide Web Hizmetleri>Güvenlik. Windows Kimlik Doğrulaması özelliğini seçin. Daha fazla bilgi için bkz. Windows Kimlik Doğrulaması <windowsAuthentication> ve Windows kimlik doğrulamasını yapılandırma.WebSockets (İsteğe Bağlı)
WebSockets, ASP.NET Core 1.1 veya üzerinde desteklenir. WebSockets'i etkinleştirmek için şu düğümleri genişletin: World Wide Web Hizmetleri>Uygulama Geliştirme Özellikleri. WebSocket Protokolü özelliğini seçin. Daha fazla bilgi için bkz. WebSockets.IIS yüklemesi bir yeniden başlatma gerektiriyorsa sistemi yeniden başlatın.
.NET Core Barındırma Paketini Yükleme
Barındırma sisteminde .NET Core Barındırma Paketi'ni yükleyin. Paket .NET Core Çalışma Zamanı'nı, .NET Core Kitaplığı'nı ve ASP.NET Core Modülü'nü yükler. Modül ASP.NET Core uygulamalarının IIS'nin arkasında çalıştırılmasına olanak tanır.
Önemli
Barındırma Paketi IIS'den önce yüklenirse paket yüklemesinin onarılması gerekir. IIS'yi yükledikten sonra Barındırma Paketi yükleyicisini yeniden çalıştırın.
Barındırma Paketi .NET Core'un 64 bit (x64) sürümü yüklendikten sonra yüklenirse, SDK'lar eksik gibi görünebilir (Hiçbir .NET Core SDK'sı algılanmadı). Sorunu çözmek için bkz. ASP.NET Core projelerinde sorun giderme ve hata ayıklama.
İndir
- .NET Core'u indir sayfasına gidin.
- İstediğiniz .NET Core sürümünü seçin.
- Uygulamaları çalıştır - Çalışma Zamanı sütununda istenen .NET Core çalışma zamanı sürümünü bulun.
- Barındırma Paketi bağlantısını kullanarak yükleyiciyi indirin.
Uyarı
Bazı yükleyiciler kullanım ömrünün sonuna (EOL) ulaşmış ve artık Microsoft tarafından desteklenmeyen sürümler içerir. Daha fazla bilgi için destek ilkesi bölümüne bakın.
Barındırma Paketini yükleme
Sunucuda yükleyiciyi çalıştırın. Yönetici komut kabuğundan yükleyiciyi çalıştırırken aşağıdaki parametreler kullanılabilir:
OPT_NO_ANCM=1: ASP.NET Core Modülü'nü yüklemeyi atlayın.OPT_NO_RUNTIME=1: .NET Core çalışma zamanını yüklemeyi atlayın. Sunucu yalnızca kendi içinde dağıtımları (SCD) barındırdığında kullanılır.OPT_NO_SHAREDFX=1: ASP.NET Paylaşılan Çerçevesi'ni (ASP.NET çalışma zamanı) yüklemeyi atlayın. Sunucu yalnızca kendi içinde dağıtımları (SCD) barındırdığında kullanılır.OPT_NO_X86=1: x86 çalışma zamanlarını yüklemeyi atlayın. Bu parametreyi, 32 bit uygulamalar barındırmayacağınızı bildiğiniz durumlarda kullanın. Gelecekte hem 32 bit hem de 64 bit uygulamalar barındırma olasılığınız varsa bu parametreyi kullanmayın ve her iki çalışma zamanını da yükleyin.OPT_NO_SHARED_CONFIG_CHECK=1: Paylaşılan yapılandırma (applicationHost.config) IIS yüklemesiyle aynı makinede yer aldığında IIS Paylaşılan Yapılandırması'nı kullanmak için denetimi devre dışı bırakın. Yalnızca ASP.NET Core 2.2 veya üzeri Barındırma Paketi yükleyicilerinde kullanılabilir. Daha fazla bilgi için bkz. IIS için ASP.NET Core Modülü (ANCM).
Sistemi yeniden başlatın veya komut kabuğunda aşağıdaki komutları yürütün:
net stop was /y net start w3svcIIS yeniden başlatıldığında sistem PATH ortam değişkeninde yükleyici tarafından yapılan bir değişiklik alınır.
Barındırma Paketi'ni yüklerken IIS'de tek tek siteleri el ile durdurmanız gerekmez. IIS yeniden başlatıldığında barındırılan uygulamalar (IIS siteleri) yeniden başlatılır. Uygulamalar Uygulama Başlatma Modülü'nden gelenler de dahil olmak üzere ilk isteklerini aldıklarında yeniden başlatılır.
ASP.NET Core, paylaşılan çerçeve paketlerinin yama sürümleri için ileri sarma davranışını benimser. IIS tarafından barındırılan uygulamalar IIS ile yeniden başlatılırsa, ilk isteklerini aldıklarında başvurdukları paketlerin en son yama sürümleriyle yüklenir. IIS yeniden başlatılmazsa, uygulamalar çalışan işlemleri geri dönüştürüldüğünde ve ilk isteklerini aldıklarında yeniden başlatılır ve ileri sarma davranışı sergiler.
Not
IIS Paylaşılan Yapılandırması hakkında bilgi için bkz. IIS Paylaşılan Yapılandırması ile ASP.NET Core Modülü.
Visual Studio ile yayımlarken Web Dağıtımı'nı yükleme
Web Dağıtımı ile uygulamaları sunuculara dağıtırken, sunucuya Web Dağıtımı'nın en son sürümünü yükleyin. Web Dağıtımı'nı yüklemek için Web Platformu Yükleyicisi'ni (WebPI) veya IIS İndirmeleri: Web Dağıtımı'nı kullanın. Tercih edilen yöntem WebPI kullanmaktır. WebPI, barındırma sağlayıcıları için tek başına bir kurulum ve bir yapılandırma sunar.
IIS sitesini oluşturma
Barındırma sisteminde, uygulamanın yayımlanan klasörleriyle dosyalarını içerecek bir klasör oluşturun. Aşağıdaki adımda klasörün yolu, uygulamanın fiziksel yolu olarak IIS'ye sağlanır. Uygulamanın dağıtım klasörü ve dosya düzeni hakkında daha fazla bilgi için bkz. ASP.NET Core dizin yapısı.
IIS Yöneticisi'nde, Bağlantılar panelinde sunucunun düğümünü açın. Siteler klasörüne sağ tıklayın. Bağlam menüsünden Web Sitesi Ekle'yi seçin.
Site adı girin ve Fiziksel yol olarak uygulamanın dağıtım klasörünü ayarlayın. Bağlama yapılandırmasını sağlayın ve Tamam'ı seçerek web sitesini oluşturun:
Uyarı
En üst düzey joker karakter bağlamaları (
http://*:80/vehttp://+:80) kullanılmamalıdır. En üst düzey joker karakter bağlamaları uygulamanızda güvenlik açıklarına neden olabilir. Bu durum hem güçlü hem de zayıf joker karakterler için geçerlidir. Joker karakterler yerine açık konak adları kullanın. Üst etki alanının tamamını denetliyorsanız alt etki alanı bağlamasının (örneğin*.mysub.com) böyle bir güvenlik riski yoktur (güvenlik açığı olan*.combağlamasından farklı olarak). Daha fazla bilgi için bkz. RFC 9110: HTTP Semantiği (Bölüm 7.2: Konak ve :yetkili).Sunucunun düğümü altında Uygulama Havuzları'nı seçin.
Sitenin uygulama havuzuna sağ tıklayın ve bağlam menüsünden Temel Ayarlar'ı seçin.
Uygulama Havuzunu Düzenle penceresinde .NET CLR sürümü'nü Yönetilen Kod Yok olarak ayarlayın:
ASP.NET Core ayrı bir işlemde çalıştırılır ve çalışma zamanını yönetir. ASP.NET Core masaüstü CLR'nin (.NET CLR) yüklenmesine bağlı değildir; uygulamayı çalışan işleminde barındırmak için .NET Core için Core Ortak Dil Çalışma Zamanı Modülü (CoreCLR) önyüklenir. .NET CLR sürümü olarak Yönetilen Kod Yok seçeneğinin ayarlanması isteğe bağlıdır ama önerilir.
ASP.NET Core 2.2 veya üzeri: İşlem içi barındırma modeli kullanan 64 bit (x64) kendi içinde dağıtım için, 32 bit (x86) işlemlerinin uygulama havuzunu devre dışı bırakın.
IIS Yöneticisi'nin Eylemler kenar çubuğunda >Uygulama Havuzları, Uygulama Havuzu Varsayılanlarını Ayarla'yı veya Gelişmiş Ayarlar'ı seçin. 32 Bit Uygulamaları Etkinleştir'i bulun ve değerini
Falseolarak ayarlayın. Bu ayar işlem dışı barındırma için dağıtılan uygulamaları etkilemez.İşlem modelinin identity uygun izinlere sahip olduğunu onaylayın.
identity Uygulama havuzunun varsayılan değeri (İşlem ModeliIdentity>) ApplicationPoolIdentity yerine başka bir identityöğesine değiştirilirse, yeninin identity uygulamanın klasörüne, veritabanına ve diğer gerekli kaynaklara erişmek için gerekli izinlere sahip olduğunu doğrulayın. Örneğin uygulama havuzu için uygulamanın dosyaları okuduğu ve yazdığı klasörlere okuma ve yazma erişimi gerekir.
Windows Kimlik Doğrulaması yapılandırması (İsteğe Bağlı)
Daha fazla bilgi için bkz. Windows kimlik doğrulamasını yapılandırma.
Uygulamayı dağıtma
Uygulamayı IIS sitesini oluşturma bölümünde oluşturulan IIS Fiziksel yol klasörüne dağıtın. Web Dağıtımı, dağıtım için önerilen mekanizmadır ama uygulamayı projenin publish klasöründen barındırma sisteminin dağıtım klasörüne taşımak için çeşitli seçenekler vardır.
Visual Studio ile Web Dağıtımı
Web Dağıtımı ile kullanılacak bir yayımlama oluşturmayı öğrenmek için ASP.NET Core uygulama dağıtımı için Visual Studio yayımlama profilleri konusuna bakın. Barındırma sağlayıcısı bir Yayımlama Profili sağlıyorsa veya bu profili oluşturmayı destekliyorsa, profili indirin ve Visual Studio Yayımla iletişim kutusunu kullanarak içeri aktarın:
Visual Studio'nun dışında Web Dağıtımı
Web Dağıtımı Visual Studio'nun dışında komut satırından da kullanılabilir. Daha fazla bilgi için bkz. Web Dağıtım Aracı.
Web Dağıtımı'nın alternatifleri
Uygulamayı barındırma sistemine taşımak için el ile kopyalama, Xcopy, Robocopy veya PowerShell gibi çeşitli yöntemlerden herhangi birini kullanın.
IIS'ye ASP.NET Core dağıtımı hakkında daha fazla bilgi için IIS yöneticileri için dağıtım kaynakları bölümüne bakın.
Web sitesine göz atma
Uygulama barındırma sistemine dağıtıldıktan sonra uygulamanın genel uç noktalarına bir istek yöneltin.
Aşağıdaki örnekte, site Bağlantı Noktası 80üzerinde iis ana bilgisayar adına www.mysite.com bağlıdır. http://www.mysite.com konumuna bir istek yöneltilir:
Kilitli dağıtım dosyaları
Uygulama çalıştırılırken dağıtım klasöründeki dosyalar kilitlenir. Dağıtım sırasında kilitli dosyaların üzerine yazılamaz. Dağıtımda kilitli dosyaları serbest bırakmak için aşağıdaki yaklaşımlardan birini kullanarak uygulama havuzunu durdurun:
Web Dağıtımı'nı kullanın ve proje dosyasında
Microsoft.NET.Sdk.WebSDK'sına başvurun. Web uygulamasının köküne birapp_offline.htmdosyası yerleştirilir. Dosya mevcut olduğunda ASP.NET Core Modülü uygulamayı düzgün bir şekilde kapatır ve dağıtım sırasındaapp_offline.htmdosyasını kullanıma sunar. Daha fazla bilgi için bkz. ASP.NET Core Modülü yapılandırma başvurusu.Sunucudaki IIS Yöneticisi'nde uygulama havuzunu el ile durdurun.
app_offline.htmdosyasını bırakmak için PowerShell kullanın (PowerShell 5 veya üzeri gerekir):$pathToApp = 'PATH_TO_APP' # Stop the AppPool New-Item -Path $pathToApp app_offline.htm # Provide script commands here to deploy the app # Restart the AppPool Remove-Item -Path $pathToApp app_offline.htm
Veri koruması
ASP.NET Core Veri Koruma yığını, kimlik doğrulamasında kullanılan ara yazılım da dahil olmak üzere çeşitli ASP.NET Core ara yazılımlarında kullanılır. Veri Koruma API'leri kullanıcı kodu tarafından çağrılmıyor olsa bile, kalıcı bir şifreleme anahtar deposu oluşturmak için dağıtım betiğiyle veya kullanıcı kodu içinde yapılandırılmalıdır. Veri koruması yapılandırılmazsa anahtarlar bellekte tutulur ve uygulama yeniden başlatıldığında atılır.
Anahtarlık bellekte depolanıyorsa uygulama yeniden başlatıldığında:
- Tüm cookie tabanlı kimlik doğrulama belirteçleri geçersiz kılınır.
- Kullanıcıların, sonraki isteklerinde yeniden oturum açmaları gerekir.
- Artık anahtarlıkla korunan verilerin şifresi çözülemez. Bu, CSRF belirteçlerini ve ASP.NET Core MVC TempData tanımlama bilgilerini içerebilir.
IIS altında veri korumasını anahtarlığın kalıcı olmasını sağlayacak şekilde yapılandırmak için aşağıdaki yaklaşımlardan birini kullanın:
Veri Koruması Kayıt Defteri Anahtarlarını Oluşturma
ASP.NET Core uygulamaları tarafından kullanılan veri koruma anahtarları uygulamaların dışındaki kayıt defterinde depolanır. Belirli bir uygulamaya yönelik anahtarların kalıcı olmasını sağlamak için uygulama havuzuna kayıt defteri anahtarları oluşturun.
Tek başına, webfarm olmayan IIS yüklemeleri için, ASP.NET Core uygulamasıyla kullanılan her uygulama havuzunda Data Protection Provision-AutoGenKeys.ps1 PowerShell betiği kullanılabilir. Bu betik HKLM kayıt defterinde yalnızca uygulamanın uygulama havuzu çalışan işlemi hesabıyla erişilebilen bir kayıt defteri anahtarı oluşturur. Anahtarlar, makine genelinde bir anahtarla DPAPI kullanılarak şifrelenir rest .
Web grubu senaryolarında, uygulama kendi veri koruma anahtarlığını depolamak için bir UNC yolu kullanacak şekilde yapılandırılabilir. Varsayılan olarak veri koruma anahtarları şifrelenmez. Ağ paylaşımına yönelik dosya izinlerinin, uygulamanın altında çalıştırıldığı Windows hesabıyla sınırlı olduğundan emin olun. X509 sertifikası, konumundaki restanahtarları korumak için kullanılabilir. Kullanıcıların sertifikaları karşıya yüklemesine olanak tanıyan bir mekanizma düşünün: Sertifikaları kullanıcının güvenilen sertifika deposuna yerleştirin ve kullanıcının uygulama çalıştırdığı tüm makinelerde bu deponun kullanılabildiğinden emin olun. Ayrıntılar için bkz. ASP.NET Core Veri Koruması'nı yapılandırma.
IIS Uygulama Havuzu'nu kullanıcı profilini yükleyecek şekilde yapılandırma
Bu ayar uygulama havuzu için Gelişmiş Ayarlar'ın altında yer alan İşlem Modeli bölümündedir. Kullanıcı Profilini Yükle seçeneğini
Trueolarak ayarlayın.Trueolarak ayarlandığında anahtarlar kullanıcı profili dizininde depolanır ve kullanıcı hesabına özgü bir anahtarla DPAPI kullanılarak korunur. Anahtarlar kalıcı olarak %LOCALAPPDATA%/ASP.NET/DataProtection-Keys klasöründe yer alır.Uygulama havuzunun setProfileEnvironment özniteliği de etkinleştirilmelidir.
setProfileEnvironmentiçin varsayılan değertruedeğeridir. Bazı senaryolarda (örneğin Windows işletim sistemi)setProfileEnvironmentfalseolarak ayarlanır. Anahtarlar beklendiği gibi kullanıcı profili dizininde depolanmıyorsa:- %windir%/system32/inetsrv/config klasörüne gidin.
- applicationHost.config dosyasını açın.
<system.applicationHost><applicationPools><applicationPoolDefaults><processModel>öğesini bulun.- Varsayılan değeri
trueolansetProfileEnvironmentözniteliğinin mevcut olmadığını veya özniteliğin açıkçatruedeğerine ayarlanmadığını onaylayın.
Dosya sistemini anahtarlık deposu olarak kullanma
Uygulama kodunu, dosya sistemini anahtarlık deposu olarak kullanacak şekilde ayarlayın. Anahtarlığı korumak için X509 sertifikası kullanın ve sertifikanın güvenilen bir sertifika olduğundan emin olun. Sertifika otomatik olarak imzalandıysa sertifikayı Güvenilen Kök deposuna yerleştirin.
Web grubunda IIS kullanırken:
- Tüm makinelerin erişebildiği bir dosya paylaşımı kullanın.
- Her makineye bir X509 sertifikası dağıtın. Kodda veri korumasını yapılandırın.
Veri koruması için makine genelinde bir ilke ayarlama
Veri koruma sisteminin, Veri Koruma API'lerini kullanan tüm uygulamalar için varsayılan bir makine genelinde illke ayarlamaya yönelik sınırlı desteği vardır. Daha fazla bilgi için bkz. ASP.NET Core Veri Koruması'na Genel Bakış.
Sanal Dizinler
ASP.NET Core uygulamalarıyla IIS Sanal Dizinleri desteklenmez. Uygulama bir alt uygulama olarak barındırılabilir.
Alt uygulamalar
ASP.NET Core uygulaması bir IIS alt uygulaması (alt uygulama) olarak barındırılabilir. Alt uygulamanın yolu kök uygulama URL'sinin bir parçası olur.
Alt uygulama bir işleyici olarak ASP.NET Core Modülü'nü içermemelidir. Modül alt uygulamanın web.config dosyasına işleyici olarak eklenirse, alt uygulamaya göz atmaya çalışıldığında hatalı config dosyasına başvuran bir 500.19 İç Sunucu Hatası alınır.
Aşağıdaki örnekte ASP.NET Core alt uygulaması için yayımlanmış bir web.config dosyası gösterilir:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.webServer>
<aspNetCore processPath="dotnet"
arguments=".\MyApp.dll"
stdoutLogEnabled="false"
stdoutLogFile=".\logs\stdout" />
</system.webServer>
</configuration>
ASP.NET Core olmayan bir alt uygulama ASP.NET Core uygulamasında barındırıldığında, alt uygulamanın web.config dosyasında devralınan işleyiciyi açıkça kaldırın:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<system.webServer>
<handlers>
<remove name="aspNetCore" />
</handlers>
<aspNetCore processPath="dotnet"
arguments=".\MyApp.dll"
stdoutLogEnabled="false"
stdoutLogFile=".\logs\stdout" />
</system.webServer>
</configuration>
Alt uygulama içindeki statik varlık bağlantıları tilde-eğik çizgi (~/) gösterimini kullanmalıdır. Tilde-eğik çizgi gösterimi, alt uygulamanın yol tabanını işlenen göreli bağlantının önüne eklemek için bir Etiket Yardımcısını tetikler. /subapp_path yolundaki bir alt uygulama için, src="~/image.png" ile bağlantılı bir resim src="/subapp_path/image.png" olarak işlenir. Kök uygulamanın Statik Dosya Ara Yazılımı statik dosya isteğini işlemez. İstek alt uygulamanın Statik Dosya Ara Yazılımı tarafından işlenir.
Statik varlığın src özniteliği bir mutlak yola ayarlanırsa (örneğinsrc="/image.png"), bağlantı alt uygulamanın yol tabanı olmadan işlenir. Kök uygulamanın Statik Dosya Ara Yazılımı kök uygulamanın web kökünden varlığa hizmet vermeyi dener ve statik varlık kök uygulamadan kullanıma sunulmadığı sürece bu deneme 404 - Bulunmadı yanıtıyla sonuçlanır.
ASP.NET Core uygulamasını bir alt uygulama olarak ASP.NET Core uygulamasının altında barındırmak için:
Alt uygulama için bir uygulama havuzu oluşturun. Uygulamayı çalışan işleminde barındırmak için masaüstü CLR (.NET CLR) değil Core Ortak Dil Çalışma Zamanı Modülü (CoreCLR) önyüklendiğinden, .NET CLR Sürümü'nü Yönetilen Kod Yok olarak ayarlayın.
Alt uygulama kök sitenin altındaki bir klasörde yer alırken kök siteyi IIS Yöneticisi'ne ekleyin.
IIS Yöneticisi'nde alt uygulama klasörüne sağ tıklayın ve Uygulamaya Dönüştür'ü seçin.
Uygulama Ekle iletişim kutusunda Uygulama Havuzu için Seç düğmesini kullanarak alt uygulama için oluşturduğunuz uygulama havuzunu atayın. Tamam'ı seçin.
İşlem içi barındırma modelini kullanırken, alt uygulamaya ayrı uygulama havuzu ataması bir gereksinimdir.
İşlem içi barındırma modeli ve ASP.NET Core Modülü'nü yapılandırma hakkında daha fazla bilgi için bkz. IIS için ASP.NET Core Modülü (ANCM).
Web.config ile IIS yapılandırması
ASP.NET Core Modülü ile ASP.NET Core uygulamaları için kullanılabilen IIS senaryolarında, IIS yapılandırmasını web.config dosyasının <system.webServer> bölümü etkiler. Örneğin IIS yapılandırması dinamik sıkıştırma için kullanılabilir. IIS sunucu düzeyinde dinamik sıkıştırmayı kullanacak şekilde yapılandırıldıysa, uygulamanın web.config dosyasındaki <urlCompression> öğesi ASP.NET Core uygulaması için bunu devre dışı bırakabilir.
Daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:
- <system.webServer> için yapılandırma başvurusu
- IIS için ASP.NET Core Modülü (ANCM)
- ASP.NET Core içeren IIS modülleri
Yalıtılmış uygulama havuzlarında çalıştırılan tek tek uygulamalara ortam değişkenleri ayarlamak için (IIS 10.0 veya üzerinde desteklenir), IIS başvuru belgelerinde Ortam Değişkenleri <environmentVariables> konusunun AppCmd.exe komutu bölümüne bakın.
ASP.NET Core tarafından kullanılmayan bölümler
Web.config dosyasında ASP.NET 4.x uygulamalarının yapılandırma bölümleri ASP.NET Core uygulamaları tarafından yapılandırma için kullanılmaz:
<system.web><appSettings><connectionStrings><location>
ASP.NET Core uygulamaları diğer yapılandırma sağlayıcıları kullanılarak yapılandırılır. Daha fazla bilgi için bkz. Yapılandırma.
Uygulama Havuzları
Sunucuda birden fazla web sitesi barındırılırken, her uygulamayı kendi uygulama havuzunda çalıştırarak uygulamaları birbirinden yalıtmanızı öneririz. IIS Web Sitesi Ekle iletişim kutusu varsayılan olarak bu yapılandırmayı kullanır. Site adı sağlandığında, bu metin otomatik olarak Uygulama havuzu metin kutusuna aktarılır. Site eklendiğinde site adı kullanılarak yeni bir uygulama havuzu oluşturulur.
Uygulama Havuzu Identity
Uygulama havuzu identity hesabı, bir uygulamanın etki alanları veya yerel hesaplar oluşturmak ve yönetmek zorunda kalmadan benzersiz bir hesap altında çalışmasına olanak tanır. IIS 8.0 veya üzerinde, IIS Yönetici Çalışan İşlemi (WAS) yeni uygulama havuzunun adıyla sanal bir hesap oluşturur ve uygulama havuzunun çalışan işlemlerini varsayılan olarak bu hesap altında çalıştırılır. Uygulama havuzu için Gelişmiş Ayarlar'ın altındaki IIS Yönetim Konsolu'nda, öğesinin ApplicationPoolIdentity kullanacak şekilde ayarlandığından Identity emin olun:
IIS yönetim işlemi Windows Güvenlik Sistemi'nde uygulama havuzunun adıyla güvenli bir tanımlayıcı oluşturur. Kaynaklar bu identitykullanılarak güvenli hale getirilebilir. Ancak bu identity gerçek bir kullanıcı hesabı değildir ve Windows Kullanıcı Yönetimi Konsolu'nda gösterilmez.
IIS çalışan işlemine uygulama üzerinde yükseltilmiş erişim gerekiyorsa, uygulamayı içeren dizin için Erişim Denetim Listesi'ni (ACL) değiştirin:
Windows Gezgini'ni açın ve dizine gidin.
Dizine sağ tıklayın ve Özellikler'i seçin.
Güvenlik sekmesinin altında Düzenle düğmesini ve sonra da Ekle düğmesini seçin.
Konumlar düğmesini seçin ve sistemin seçildiğinden emin olun.
Seçilecek nesne adlarını girin alanında IIS AppPool\<app_pool_name> girin. Adları Denetle düğmesini seçin. DefaultAppPool için IIS AppPool\DefaultAppPool kullanarak adları denetleyin. Adları Denetle düğmesi seçildiğinde nesne adları alanında DefaultAppPool değeri gösterilir. Uygulama havuzu adını doğrudan nesne adları alanına girmek mümkün değildir. Nesne adını denetlerken IIS AppPool\<app_pool_name> biçimini kullanın.
Tamam'ı seçin.
Okuma ve yürütme izinleri varsayılan olarak verilmelidir. Gerekirse ek izinler sağlayın.
Komut isteminde ICACLS aracı kullanılarak da erişim verilebilir. Örnek olarak DefaultAppPool kullanıldığında aşağıdaki komut kullanılır:
ICACLS C:\sites\MyWebApp /grant "IIS AppPool\DefaultAppPool":F
Daha fazla bilgi için icacls konusuna bakın.
HTTP/2 desteği
HTTP/2, aşağıdaki temel gereksinimleri karşılayan işlem dışı dağıtımlar için desteklenir:
- Windows Server 2016/Windows 10 veya üzeri; IIS 10 veya üzeri
- Genel kullanıma yönelik uç sunucu bağlantıları HTTP/2 kullanır ama Kestrel sunucusuna ters ara sunucu bağlantısı HTTP/1.1 kullanır.
- Hedef çerçeve: HTTP/2 bağlantısı tamamen IIS tarafından işlendiğinden, işlem dışı dağıtımlar için geçerli değildir.
- TLS 1.2 veya üzeri bağlantısı
HTTP/2 bağlantısı kuruluyorsa HttpRequest.Protocol HTTP/1.1 bildirir.
HTTP/2 varsayılan olarak etkinleştirilir. HTTP/2 bağlantısı kurulamazsa bağlantılar HTTP/1.1'e geri döner. IIS dağıtımlarıyla HTTP/2 yapılandırması hakkında daha fazla bilgi için bkz. IIS üzerinde HTTP/2.
CORS denetim öncesi istekleri
Bu bölüm yalnızca .NET Framework'ü hedefleyen ASP.NET Core uygulamalarına yöneliktir.
.NET Framework'ü hedefleyen ASP.NET Core uygulaması için, IIS'de OPTIONS istekleri varsayılan olarak uygulamaya geçirilmez. OPTIONS isteklerini göndermek üzere web.config dosyasında uygulamanın IIS işleyicilerini yapılandırmayı öğrenmek için bkz. ASP.NET Web API 2'de kaynaklar arası istekleri etkinleştirme: CORS Nasıl Çalışır?.
IIS yöneticileri için dağıtım kaynakları
- IIS belgeleri
- IIS'de IIS Yöneticisi ile Çalışmaya Başlama
- .NET Core uygulama dağıtımı
- IIS için ASP.NET Core Modülü (ANCM)
- ASP.NET Core dizin yapısı
- ASP.NET Core içeren IIS modülleri
- Azure App Service ve IIS'de ASP.NET Core sorunlarını giderme
- ASP.NET Core ile Azure App Service ve IIS için yaygın hataları giderme
Ek kaynaklar
ASP.NET Core