使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(十)-- 发布(Windows)
2016-08-04 00:10
1421 查看
本篇将在这个系列演示的例子上继续记录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里几个重要的特性和功能,未来在实际开发过程中能更好的选择合适的技术方案。相关文章推荐
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(十)-- 发布(Windows)
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(二)-- Web Api Demo
- [转]使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(三)-- Logger
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(九)-- 单元测试
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(八)-- 多环境开发
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(三)-- Logger
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(一)-- 起步
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(二)-- Web Api Demo
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(一)-- 起步
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(四)-- Middleware
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(七)-- 结构化配置
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(五)-- Filter
- docker4dotnet #3 在macOS上使用Visual Studio Code和Docker开发asp.net core和mysql应用
- docker4dotnet #3 在macOS上使用Visual Studio Code和Docker开发asp.net core和mysql应用
- docker4dotnet #3 在macOS上使用Visual Studio Code和Docker开发asp.net core和mysql应用
- docker4dotnet #3 在macOS上使用Visual Studio Code和Docker开发asp.net core和mysql应用
- 使用Visual Studio Code开发Asp.Net Core WebApi学习笔记(六)-- 依赖注入
- 配置visual studio code进行asp.net core rc2的开发(转载jeffreywu)
- 配置visual studio code进行asp.net core rc2的开发
- 使用Visual Studio Code创建第一个ASP.NET Core应用程序