ASP.NET Core搭建多层网站架构【14-扩展之部署到IIS】

风格不统一 提交于 2020-02-08 19:29:51

2020/02/03, ASP.NET Core 3.1, VS2019, IIS 10, dotnet-hosting-3.1.1-win.exe

摘要:基于ASP.NET Core 3.1 WebApi搭建后端多层网站架构【14-扩展之部署到IIS】
在Windows上将ASP.NET Core网站部署到IIS

文章目录

本章节由于并未对代码做出改动,仅添加了发布配置文件,所以没有上传代码分支(下一章节中可以看到本章节添加的发布配置文件)

本章节介绍了在Windows上将ASP.NET Core网站部署到IIS,部署环境是 Windows 10.0.18363 (企业版)

添加IIS功能

在控制面板-程序和功能中,添加IIS:

勾选选项默认即可
我这里是win10企业版,winserver服务器也是类似的开启该功能

安装dotnet-hosting

官网下载安装dotnet-hosting,下载页面

先选取对应的.NET Core版本,然后找到Hosting Bundle下载,下载下来安装即可

编译项目

对着MS.WebApi应用程序右击,选择发布

选择文件夹我这里保持了默认bin\Release\netcoreapp3.1\publish\文件夹
点击高级,进一步配置:

Release配置,部署模式为框架依赖,目标运行时为可移植,勾选删除目标上的其他文件,最后点保存,创建该配置文件

最后点击发布,项目即开始以release方式编译
发布完成后,可以看到发布的文件都在目标文件夹中了:

  • 使用了Release配置,默认VS对Release的配置,依然会生成pdb调试文件,需要手动在项目属性-生成-Release配置-高级-调试信息选择为,之后该项目才不会生成pdb文件(注意调试的时候不能选择为无,会导致无法调试)
  • 部署模式是框架依赖,独立部署和框架依赖的区别,官网说的很清楚了,可以看官方文档
  • 目标运行时,我选择了可移植,不管在哪个平台都能运行;也可以依据目标机器,选择具体的平台
  • 勾选删除目标上的其他文件,确保多次发布,之前的遗留文件不会污染新的发布文件

IIS配置

选择一个地方作为部署目录,这里我选择D盘下website文件夹(如果选择C盘,记得要把该文件夹权限设为完全控制,否则网站没有对该文件夹的修改权限)
将发布后生成的文件都拷贝至该目录下:

打开IIS管理器

添加应用程序池

右击应用程序池-添加应用程序池:

  • 名称随意
  • .NET CLR版本一定要选择无托管代码
  • 托管模式为集成

添加网站

右击网站-添加网站,按以下配置添加:

  • 名称随意
  • 应用程序池要选择上一步骤中添加的应用程序池
  • 物理路径是之前步骤中选定的website文件夹
  • 这里我修改了端口号为5001

至此,部署已完成

测试部署前需确认:

  • 网站appsettings.json中设置的数据库连接地址是否能正常访问、连接
  • dotnet-hosting-版本号-win.exe已安装成功
  • IIS已配置成功
  • 如需局域网访问,确认防火墙打开了对应端口(具体可以百度下,很简单)

使用Postman调用接口,可以正常访问则部署成功:

排查错误

如果遇到网站启动失败,对照官方文档进行排错

排错思路:

  • 网站目录下的web.config中stdoutLogEnabled值改为true,重新访问网站,目录下会生成错误日志,根据错误日志排错或百度
  • 网站Program.cs下的Main方法中,使用try catch,并使用NLog记录日志,就能看到是否是网站内部逻辑运行出错
  • 新建一个空白的网站,发布出来部署试试,排除目标机器环境是否存在问题
易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!