IIS中的 Asp.Net Core 和 dotnet watch

在基于传统的.NET Framework的Asp.Net Mvc的时候，本地开发环境中可以在IIS中建立一个站点，可以直接把站点的目录指向asp.net mvc的项目的根目录。然后build一下就可以在浏览器里面刷新到最新的修改了，也可以附加到w3wp的进程进行调试。但是在开发基于.Net Core的Asp.Net Core项目的时候，这样的做法已经无法满足我们的需要了：

更改完代码build一下，无需部署即可在浏览器得到最新的更改。
附加到进程调试。

Asp.Net Core的项目需要先Pubilsh一下才能部署到IIS，而且中间需要一个AspNetCoreModule的模块来中转一下。这主要是因为Asp.Net Core的项目本质上来说是一个Console类型的项目，而且它自带了Kertrel组件来监听HTTP请求。这就使得IIS不再负责Asp.Net Core的运行了，而是作为一个反向代理来使用的，如下图所示：

那么如何优雅在满足上面提到的2点需要呢？本文源代码位于(https://github.com/linianhui/aspnetcore/tree/master/dotnet-watch-run)

dotnet watch

dotnet watch 属于dotnet cli tool里面的一部分功能，其用途在于扩充dotnet cli的命令，为它们添加一个监视的功能，即在使用cli运行dotnet core的项目的时候，当你修改了项目的源代码，那么save一下源码，即可刷新得到最新的更改。比如我们用 dotnet run 运行了我们的一个Asp.Net Core项目，想要修改的话就需要先停止运行，然后修改代码，再一次运行才能看到结果。而如果使用了 dotnet watch run 来运行的话则省去了停止运行的过程，直接修改保存即可。享受到这样的好处只需再你的csproj文件中增加一个引用即可。

<ItemGroup><DotNetCliToolReference Include="Microsoft.DotNet.Watcher.Tools" Version="2.0.0" />
</ItemGroup>

当我修改了ValuesController.cs文件的内容的时候，watch会自动退出当前正在运行的进程，然后再一次启动它。是不是很方便呢？

IIS中的 dotnet watch

如何把Asp.Net Core部署到IIS这里就不解释了，只贴一下我写的Cake部署脚本：

 1 #addin "Cake.IIS" 
 2 #addin "Cake.Hosts" 
 3 #addin "Cake.FileHelpers" 
 4 #addin "Cake.Powershell"
 5  
  /// params 
 7 var target = Argument("target", "default"); 
 8  
 9 /// iis web site config
 10 var webSiteConfig = new {
 11     host = "api.asp-net-core.dev",
 12     path = "./src",
 13     appPoolName = "apppool.noclr"
 14 };
 15 
 16 /// deploy task
 17 Task("deploy")
 18     .Does(() =>
 19 {
 20     DeleteSite(webSiteConfig.host);
 21 
 22     CreateWebsite(new WebsiteSettings()
 23     {
 24         Name = webSiteConfig.host,
 25         Binding = IISBindings.Http.SetHostName(webSiteConfig.host)
 26                                   .SetIpAddress("*")
 27                                   .SetPort(80),
 28         ServerAutoStart = true,
 29         PhysicalDirectory = webSiteConfig.path,
 30         ApplicationPool = new ApplicationPoolSettings()
 31         {
 32             Name = webSiteConfig.appPoolName,
 33             IdentityType = IdentityType.LocalSystem,
 34             MaxProcesses = 1,
 35             ManagedRuntimeVersion = null
 36         }
 37     });
 38         
 39     AddHostsRecord("127.0.0.1", webSiteConfig.host);
 40 });
 41 
 42 /// open browser task
 43 Task("open-browser")
 44     .Does(() =>
 45 {
 46     StartPowershellScript("Start-Process", args =>
 47     {
 48         args.Append("chrome.exe")
 49             .Append("'-incognito'")
 50             .Append(", '" + webSiteConfig.host + "'");
 51     });
 52 });
 53 
 54 
 55 /// default task
 56 Task("default")
 57 .IsDependentOn("deploy")
 58 .IsDependentOn("open-browser");
 59 
 60 RunTarget(target);

由于我们要使用dotnet watch这个命令，所以在部署的时候并没有对Asp.Net Core的项目进行Build和Publish，而是直接指向了其源代码目录。那么在哪里让IIS执行dotnet watch呢？答案是web.config里面：

 1 <?xml version="1.0" encoding="utf-8"?> 
 2 <configuration>
 3   <system.webServer> 
 4     <handlers> 
 5       <remove name="aspNetCore" /> 
 6       <add name="aspNetCore" 
 7            path="*" 
 8            verb="*" 
 9            modules="AspNetCoreModule"
 10            resourceType="Unspecified" />
 11     </handlers>
 12     <aspNetCore processPath="dotnet"
 13                 arguments="watch run"
 14                 stdoutLogEnabled="true"
 15                 shutdownTimeLimit="2"
 16                 stdoutLogFile=".\_log\" />
 17   </system.webServer>
 18 </configuration>

其中重点在于aspnetcore节点的processPath="dotnet"和arguments="watch run"。这个配置节点是供AspNetCoreModule使用的，其详细的配置参数请移步这里：https://docs.microsoft.com/en-us/aspnet/core/hosting/aspnet-core-module。这样在IIS中访问的时候，AspNetCoreModule就会使用 dotnet watch run来运行我们的项目。就可以实现编辑代码->保存->在浏览器中刷新就可以直接看到结果了！。