使用Visual Studio Code开发Asp.Net Core WebApi学习笔记（十）-- 发布(Windows)

本篇将在这个系列演示的例子上继续记录Asp.Net Core在Windows上发布的过程。

Asp.Net Core在Windows上可以采用两种运行方式。一种是自托管运行，另一种是发布到IIS托管运行。

第一部分、自托管

一、依赖.Net Core环境

修改 project.json 文件内容，增加发布时需要包含文件的配置内容

 {
   "version": "1.0.0-*",
   "testRunner": "xunit", // 设置测试工具为xunit
   "buildOptions": {
     "debugType": "portable",
     "emitEntryPoint": true
   },
   "dependencies": {
     "Microsoft.NETCore.App": {
       "type": "platform",
       "version": "1.0.0"
     },
     "Microsoft.AspNetCore.Server.Kestrel": "1.0.0",
     "Microsoft.AspNetCore.Mvc": "1.0.0",
     "Microsoft.Extensions.Logging": "1.0.0",
     "Microsoft.Extensions.Logging.Console": "1.0.0",
     "Microsoft.Extensions.Logging.Debug": "1.0.0",
     "Microsoft.Extensions.Logging.Filter": "1.0.0",
     "NLog.Extensions.Logging": "1.0.0-rtm-alpha2",
     "Autofac.Extensions.DependencyInjection": "4.0.0-rc3-309",
     "Microsoft.Extensions.Configuration": "1.0.0",
     "Microsoft.Extensions.Configuration.FileExtensions": "1.0.0",
     "Microsoft.Extensions.Configuration.Json": "1.0.0",
     "Microsoft.Extensions.Options.ConfigurationExtensions": "1.0.0",
     "xunit": "2.2.0-beta2-build3300",
     "dotnet-test-xunit": "2.2.0-preview2-build1029",
     "moq.netcore": "4.4.0-beta8",
     "Microsoft.AspNetCore.TestHost": "1.0.0",
     "Newtonsoft.Json": "9.0.1"
   },
   "frameworks": {
     "netcoreapp1.0": {
       // 设置兼容框架
       "imports": [
         "dotnet54",
         "portable-net45+win8"
       ]
     }
   },
   "publishOptions": {
     // 设置发布时需要包含的文件
     "includeFiles": ["appsettings.json", "nlog.config"]
   }
 }

打开cmd窗口，进入到项目根目录，输入命令 dotnet publish ，项目将会进行编译发布

输入 dotnet xxx.dll 命令启动程序

访问路径 http://localhost:5000/api/users ，页面正常显示。

二、自带运行时发布

在跨平台发布时，.Net Core可以通过配置的方式指定目标平台，在发布时将对应的运行时一并打包发布。这样目标平台不需要安装.Net Core环境就可以部署。

再次修改 project.json 文件，增加目标平台

 {
   "version": "1.0.0-*",
   "testRunner": "xunit", // 设置测试工具为xunit
   "buildOptions": {
     "debugType": "portable",
     "emitEntryPoint": true
   },
   "dependencies": {
     "Microsoft.NETCore.App": {
       //"type": "platform",   // 这个需要注释掉
       "version": "1.0.0"
     },
     "Microsoft.AspNetCore.Server.Kestrel": "1.0.0",
     "Microsoft.AspNetCore.Mvc": "1.0.0",
     "Microsoft.Extensions.Logging": "1.0.0",
     "Microsoft.Extensions.Logging.Console": "1.0.0",
     "Microsoft.Extensions.Logging.Debug": "1.0.0",
     "Microsoft.Extensions.Logging.Filter": "1.0.0",
     "NLog.Extensions.Logging": "1.0.0-rtm-alpha2",
     "Autofac.Extensions.DependencyInjection": "4.0.0-rc3-309",
     "Microsoft.Extensions.Configuration": "1.0.0",
     "Microsoft.Extensions.Configuration.FileExtensions": "1.0.0",
     "Microsoft.Extensions.Configuration.Json": "1.0.0",
     "Microsoft.Extensions.Options.ConfigurationExtensions": "1.0.0",
     "xunit": "2.2.0-beta2-build3300",
     "dotnet-test-xunit": "2.2.0-preview2-build1029",
     "moq.netcore": "4.4.0-beta8",
     "Microsoft.AspNetCore.TestHost": "1.0.0",
     "Newtonsoft.Json": "9.0.1"
   },
   "frameworks": {
     "netcoreapp1.0": {
       // 设置兼容框架
       "imports": [
         "dotnet54",
         "portable-net45+win8"
       ]
     }
   },
   "publishOptions": {
     // 设置发布时需要包含的文件
     "includeFiles": [
       "appsettings.json",
       "nlog.config"
     ]
   },
   // 目标平台
   "runtimes": {
     "win7-x64": {},
     "win10-x64": {},
     "ubuntu.14.04-x64": {}
   }
 }

cmd窗口运行 dotnet restore 命令，还原目标平台相关的包。这个过程耗时较长。

还原完成后，执行 dotnet publish 命令进行发布

进入对应发布目录，执行 WebApiFrame.exe 文件即可启动项目。

如果不显式指定目标平台，.Net Core默认选择当前系统平台。如果想指定目标平台，则需要执行命令 dotnet publish -r {目标平台} 。下面展示的是发布到ubuntu环境下。

第二部分、IIS托管

首先要安装一个工具.NET Core Windows Server Hosting。该工具支持将IIS作为一个反向代理，将请求导向Kestrel服务器。

引入相关nuget包

"Microsoft.AspNetCore.Server.IISIntegration": "1.0.0"

修改 Program.cs 内容

 using Microsoft.AspNetCore.Hosting;

 namespace WebApiFrame
 {
     public class Program
     {
         public static void Main(string[] args)
         {
             var host = new WebHostBuilder()
                 .UseKestrel()
                 .UseIISIntegration()
                 .UseStartup<Startup>()
                 .Build();

             host.Run();
         }
     }
 }

在项目根目录添加web.config，并配置到发布包含文件列表中

 <?xml version="1.0" encoding="utf-8"?>
 <configuration>

   <!--
     Configure your application settings in appsettings.json. Learn more at http://go.microsoft.com/fwlink/?LinkId=786380
   -->

   <system.webServer>
     <handlers>
       <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified"/>
     </handlers>
     <aspNetCore processPath="dotnet" arguments=".\WebApiFrame.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" forwardWindowsAuthToken="false" />
   </system.webServer>
 </configuration>

执行 dotnet publish 发布后开始配置IIS

修改应用程序池，.Net CLR版本修改为：无托管代码

启动网站，访问地址 http://localhost:8080/api/users ，页面将显示内容。

在上面的例子里，IIS通过Asp.Net Core Module，提供了反向代理的机制。

通过访问IIS地址，将请求导向Asp.Net Core内置的Kestrel服务器，经过处理后再反向回传到IIS。整个过程IIS只作为一个桥梁，不做任何逻辑处理。

最后的话

这个系列到这里就告一段落了。之所以选择使用Visual Studio Code工具开发Asp.Net Core Web Api，主要是想通过一点点慢慢搭建这个框架的过程中，逐步学习了解Asp.Net Core里几个重要的特性和功能，未来在实际开发过程中能更好的选择合适的技术方案。