在IIS上部署(托管).NET Core站点

部署教程

操作系统要求

Windows 7 或更高版本
Windows Server 2008 R2 或更高版本

依赖的组件

Runtime & Hosting Bundle

image.png

可以选择.NET Core版本，选择 Runtime & Hosting Bundle 开始下载。
这里一定注意左边的版本标识了Sdk和运行时对应的Asp.NET Core IIS Module等各项版本信息

image.png

安装完成后通过在IIS管理台上通过模块按钮查看，如下图

image.png

部署站点

部署方式和部署.NET站点一样（安装IIS和常规的IIS相关组件），只是需要将站点的应用程序池设置.NET CLR版本为无托管代码，如下图:

image.png

接下来重启服务器；

web.config详解

vs发布后的站点文件夹下会带有一个web.config文件。文件格式如下:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModule" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath="dotnet" arguments=".\Test1.dll" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout" />
    </system.webServer>
  </location>
</configuration>

上面的handlers节点下包含名称aspNetCore，modules=“AspNetCoreModule
”的节点。意思即对应IIS下的AspNetCoreModule HttpModule。这里不要对其进行改动，保持默认配置即可。
下面的aspNetCore节点内的processPath意思表示该站点需在IIS工作进程内托管,这种模式称之为进程内托管模型。在进程内托管时，该模块会使用 IIS 进程内服务器实现，即 IIS HTTP 服务器 (IISHttpServer)。在IIS托管下使用进程内托管模式比进程外托管模式性能更强。 stdoutLogEnabled属性表示是否开启日志(建议开启)，
stdoutLogFile属性表示日志输出目录。

可以在配置文件中新增环境变量，如下:

<aspNetCore processPath="dotnet" arguments=".\MyApp.dll" stdoutLogEnabled="false" stdoutLogFile="\\?\%home%\LogFiles\stdout"> 

    <environmentVariables> 
      <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" /> 
      <environmentVariable name="CONFIG_DIR" value="f:\application_config" />    
   </environmentVariables> 
</aspNetCore>

ASPNETCORE_ENVIRONMENT变量对应项目的appsettings.json文件读取目录(可读取开发环境Development或生产环境Product)
CONFIG_DIR是我们自定义的一个环境变量，可在站点启动时候读取该变量做相应的逻辑。
注意此配置文件下的环境变量权重高于我们在操作系统下配置的环境变量

官网说明:https://docs.microsoft.com/zh-cn/aspnet/core/host-and-deploy/iis/index?view=aspnetcore-2.1#sub-applications

常见的部署问题(持续更新)

上面的部署步骤我都走完后，开启站点遇到下面这个错误:

image.png

404!!!!!

我还只是默认的webapi啊，代码都是微软自动生成的啊！！！然后查看IIS日志，如下图

image.png

打开IIS日志存放目录，C:\inetpub\logs\LogFiles\W3SVC4打开一看，没问题啊，没有错误日志啊(内心很纠结。。。)。

各种百度、Goolge就是没找到解决办法，一直以为是环境问题，服务器都重启了不下3次

最后自己尝试手动补齐了路由，一看可以了！！！
说到底还是对.NetCore了解不够深入，发布后IIS托管站点后不会对路由默认补齐，所以在项目的launchSettings.json文件里改成一朵花都没用。

image.png

默认路由未自动补齐导致404的解决办法:
1、Nuget 安装Microsoft.AspNetCore.Rewrite
2、在启动项目Startup.Configure方法下的app.UseMvc();代码前加入下面代码:

var option = new RewriteOptions();
option.AddRedirect("^$", "swagger"); //swagger为补充的路由
app.UseRewriter(option);

app.UseMvc();·

哎，本来还想部署在Linux上的，结果在IIS上部署都出西西，真的当时都怀疑自己了。
也是在开发经历上遇到的各种问题吧，让我能更深入的去理解问题本质并着手解决。

最后编辑于：2019.01.23 11:15:01