Windows + IIS 環境部署Asp.Net Core App

環境：Windows Server 2012, IIS 8, Asp.Net Core 1.1.

很多人第一次在IIS中部署Asp.Net Core App的人都會遇到問題，會發現原來的部署方式沒法運行Asp.Net Core App程序。過去不管是原始的Asp程序仍是後來的Asp.Net程序，在IIS中的部署方式都沒太大變化，僅需指向程序目錄，而後設定虛擬目錄，最後作一些參數配置。Asp.Net Core App爲了作到跨平臺，自帶了一個輕量級的Web Server - Kestrel，那麼要在IIS中部署Asp.Net Core App，就必須有一種新的機制來協調IIS與Kestrel Server之間的數據傳遞。

1.  Asp.Net Core的部署模式

與傳統的Asp.Net程序不一樣，Asp.Net Core App使用了Kestrel Server。Kestrel是一個跨平臺的Web Server，與IIS同樣負責請求的監聽、接收和響應，但沒有IIS豐富的管理功能，仍須要由IIS來處理一些前置工做。（固然你也可使用Apache來作前置處理）

IIS負責把外部請求轉發給後端的Asp.net Core App，充當「反向代理（reverse-proxy）」角色。

2.  理解反向代理

「反向」是指入站方向，「代理」能夠理解爲某種服務，這裏是轉發HTTP請求的服務。「反向代理」就是入站方向轉發HTTP請求的服務。

和路由器原理同樣，路由器除了讓局域網可以訪問internet，也能夠經過設置NAT或端口映射，從internet訪問內部的某臺服務器，至關於把入站請求轉發給指定電腦上，這與IIS的反向代理角色相似。代理服務器與路由器都是起到數據轉發的做用，只不過代理服務器轉發的是某類應用的數據，路由器轉發的是數據包。

3.  部署環境

Asp.Net Core App部署須要操做系統知足：

• Windows 7 或更新版本
• Windows Server 2008 R2 或更新版本

4.  配置IIS

Windows Server上經過「添加角色和功能」，桌面Windows上經過「啓用和關閉Windows功能」來安裝和配置IIS。確保勾選Web服務和「IIS 管理控制檯」：

Windows Server IIS 安裝配置 

 桌面Windows IIS 安裝配置

5.  安裝.NET Core Windows Server Hosting程序集

安裝.NET Core Windows Server Hosting程序集，讓IIS具有反向代理功能。該程序集包含了.Net Core運行時（Runtime），.Net Core 類庫（Library）和 Asp.Net Core Module。其中Asp.Net Core Module負責反向代理工做。

特別注意，按微軟官方說法，若是是脫機安裝，則需先手動安裝Microsoft Visual C++ 2015 Redistributable。但實踐證實即便在線安裝不少時候也不會自動安裝 Microsoft Visual C++ 2015 Redistributable，所以強烈建議手動安裝Microsoft Visual C++ 2015 Redistributabl。

另外，目前.NET Core版本升級很快，請下載最新版本的.NET Core Windows Server Hosting，確保服務器上的.Net Core版本不低於部署的Asp.Net Core App版本。

下載 Microsoft Visual C++ 2015 Redistributable

下載最新版本.NET Core Windows Server Hosting

安裝完成重啓系統或重啓IIS服務便可。

6.  IIS中配置Asp.Net Core App

接下來的步驟與部署傳統網站基本一致，但也有稍許不一樣，請留意。

1)  服務器中建立目錄存放發佈之後的App程序文件，確保App的web.config文件在網站根目錄下。

2)  在網站根目錄建立一個logs文件夾。若是你開啓了某些日誌服務，日誌文件將記錄在這裏。固然也能夠不記錄日誌，但初次部署對排錯有幫助，建議建立。

    web.config 中開啓 stdoutLogEnabled="true"

<aspNetCore processPath="dotnet" arguments=".\Web.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" />

3)  在IIS管理器中添加網站。步驟與通常網站配置一致：

4) 配置應用程序池。在左側導航欄選擇「應用程序池」，選擇指定程序池，右鍵菜單，選擇「基本設置」，將.Net CLR版本設置爲「無託管代碼」。

7.  測試Asp.Net Core App

本例使用一個測試公網域名www.test.com，顯然咱們沒有權限更改此域名在公網的解析記錄，但咱們能夠更改此域名在本地的指向用於測試。使用記事本打開C:\Windows\System32\Drivers\etc\hosts文件，添加一條記錄 「127.0.0.1      www.test.com」。以後咱們在本地訪問域名www.test.com時IP地址將解析爲 127.0.0.1。使用瀏覽器打開www.test.com，咱們會看到Asp.Net Core App已正常運行：

 

相關閱讀： Asp.Net Core App 部署故障示例 1 Asp.Net Core App 部署故障示例 2