2020/02/03, ASP.NET Core 3.1, VS2019, IIS 10, dotnet-hosting-3.1.1-win.exe
Abstract: Based on ASP.NET Core 3.1 WebApi build back-end multi-layered site architecture [14-] extend the deployment to IIS
in Windows ASP.NET Core will deploy to IIS Web site
I deployment environment is Windows 10.0.18363 (Enterprise Edition)
Add the IIS feature
In the Control Panel - Programs and Features, add IIS:
Check Option Default to
me here is win10 Enterprise Edition, winserver server is similar to open the function
Install dotnet-hosting
Official website to download and install dotnet-hosting, download page
first select the corresponding version of the .NET Core, and then find Hosting Bundle download, download can be installed
Compile the project
Against the MS.WebApiapplication right click and select 发布:
选择文件夹I am here to keep the default bin \ Release \ \ publish \ folder netcoreapp3.1
clicks 高级, further configuration:
Releaseconfiguration, deployment mode 框架依赖, target runtime 可移植, check 删除目标上的其他文件the last point saved, created this configuration file
Finally click post, the project began to release compiled
after the release is complete, you can see the release of the files are in the target folder:
- 使用了
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记录日志，就能看到是否是网站内部逻辑运行出错
- 新建一个空白的网站，发布出来部署试试，排除目标机器环境是否存在问题