Asp.Net Core 项目运行部署到发布

1.项目创建

使用Visual Studio 2019 创建一个Asp.NetCore WebApplication 并选择MVC项目命名为OnePublish。

确认运行无误后我们来探讨一下Asp.NetCore项目的运行启动方式以及他与Asp.Net的区别。

2.项目运行

IIS Express运行效果：

结果不出乎意料和Asp.Net相似都能成功的运行Web项目，但在Asp.NetCore中新增了一种使用CommandLine运行的方式，我们可以从配置文件或者VS设置中可以看出。

项目属性设置：

LaunchSettings.json

 1 {
 2   "iisSettings": {
 3     "windowsAuthentication": false,
 4     "anonymousAuthentication": true,
 5     "iisExpress": {
 6       "applicationUrl": "http://localhost:54012",
 7       "sslPort": 0
 8     }
 9   },
10   "profiles": {
11     "IIS Express": {
12       "commandName": "IISExpress",
13       "launchBrowser": true,
14       "environmentVariables": {
15         "ASPNETCORE_ENVIRONMENT": "Development"
16       }
17     },
18     "OnePublish": {
19       "commandName": "Project",
20       "launchBrowser": true,
21       "applicationUrl": "http://localhost:5000",
22       "environmentVariables": {
23         "ASPNETCORE_ENVIRONMENT": "Development"
24       }
25     }
26   }
27 }

我们可以看见以"OnePublish"为名的CommandLine也可以成功运行Web项目，那Asp.NetCore是如何做到从命令行实现Web项目的呢？

原因在于ASP.NET Core不再是由IIS工作进程（w3wp.exe）托管，而是使用自托管Web服务器（Kestrel）运行，IIS则是作为反向代理的角色转发请求到Kestrel不同端口的ASP.NET Core程序中，随后就将接收到的请求推送至中间件管道中去，处理完你的请求和相关业务逻辑之后再将HTTP响应数据重新回写到IIS中，最终转达到不同的客户端（浏览器，APP，客户端等）。

官方文档图解：

Kestrel used as an edge (Internet-facing) web server:

Kestrel used in a reverse proxy configuration:

我的理解为：当Kestrel作为Eage Server监听某一个ip或者端口时，它可以接受所有由该端口发送的信息并解决他们的请求。但当有反向代理的存在时如（IIS，Nginx，Apache），反向代理可以接受多个Kestrel托管的端口来接受他们的信息并完成他们的请求。总结来说在Asp.NetCore中Kestrel已经组成一个完整的生态，而代理服务器大多起一个监听的作用了。那Kestrel在哪里启动的呢？

首先我们来观察一下这两个类文件。

Program.cs：

 1 using Microsoft.AspNetCore.Hosting;
 2 using Microsoft.Extensions.Hosting;
 3 
 4 namespace OnePublish
 5 {
 6     public class Program
 7     {
 8         public static void Main(string[] args)
 9         {
10             CreateHostBuilder(args).Build().Run();
11         }
12 
13         public static IHostBuilder CreateHostBuilder(string[] args) =>
14             Host.CreateDefaultBuilder(args)
15                 .ConfigureWebHostDefaults(webBuilder =>
16                 {
17                     webBuilder.UseStartup<Startup>();
18                 });
19     }
20 }

我们知道Main函数一般为程序的入口。在此函数中我们可以看见是调用了一系列方法，这可能还不够简单明了，我们对此方法做一点简化。

1 public static void Main(string[] args)
2         {
3             var hostBuilder = CreateHostBuilder(args);
4             var host = hostBuilder.Build();
5             host.Run();
6         }

现在我们可以理解为它使用CreateHsotBuilder()方法创建了一个hostBuilder,在利用hostBuilder创建了一个host主机实体对象，在Run这个Host主机。

那么这个HostBuiler到底做了什么配置又创建了一些什么东西呢？

我们对源码进行解读一下：

 1 public static IHostBuilder CreateDefaultBuilder(string[] args)
 2     {
 3       HostBuilder hostBuilder = new HostBuilder();
 4       hostBuilder.UseContentRoot(Directory.GetCurrentDirectory());
 5       hostBuilder.ConfigureHostConfiguration((Action<IConfigurationBuilder>) (config =>
 6       {
 7         config.AddEnvironmentVariables("DOTNET_");
 8         if (args == null)
 9           return;
10         config.AddCommandLine(args);
11       }));
12       hostBuilder.ConfigureAppConfiguration((Action<HostBuilderContext, IConfigurationBuilder>) ((hostingContext, config) =>
13       {
14         IHostEnvironment hostingEnvironment = hostingContext.HostingEnvironment;
15         config.AddJsonFile("appsettings.json", true, true).AddJsonFile("appsettings." + hostingEnvironment.EnvironmentName + ".json", true, true);
16         if (hostingEnvironment.IsDevelopment() && !string.IsNullOrEmpty(hostingEnvironment.ApplicationName))
17         {
18           Assembly assembly = Assembly.Load(new AssemblyName(hostingEnvironment.ApplicationName));
19           if (assembly != (Assembly) null)
20             config.AddUserSecrets(assembly, true);
21         }
22         config.AddEnvironmentVariables();
23         if (args == null)
24           return;
25         config.AddCommandLine(args);
26       })).ConfigureLogging((Action<HostBuilderContext, ILoggingBuilder>) ((hostingContext, logging) =>
27       {
28         int num = RuntimeInformation.IsOSPlatform(OSPlatform.Windows) ? 1 : 0;
29         if (num != 0)
30           logging.AddFilter<EventLogLoggerProvider>((Func<LogLevel, bool>) (level => level >= LogLevel.Warning));
31         logging.AddConfiguration((IConfiguration) hostingContext.Configuration.GetSection("Logging"));
32         logging.AddConsole();
33         logging.AddDebug();
34         logging.AddEventSourceLogger();
35         if (num == 0)
36           return;
37         logging.AddEventLog();
38       })).UseDefaultServiceProvider((Action<HostBuilderContext, ServiceProviderOptions>) ((context, options) =>
39       {
40         bool flag = context.HostingEnvironment.IsDevelopment();
41         options.ValidateScopes = flag;
42         options.ValidateOnBuild = flag;
43       }));
44       return (IHostBuilder) hostBuilder;
45     }

可以看到它对路径做了一个默认的规定，并的确的使用的CommandLine并可接受参数，这也是为什么我们可以通过CommandLine控制Web程序的原因，还有对appsettings.json文件的引用，从这里我们可以看出我们也是可以自定义配置文件的。还添加了Logging这些基本功能。

继续向源码解读可以看到在ConfigureWebDefaults方法中，Asp.NetCore确实使用了Kestrel并对他的一些option进行了默认的规定。到这里我们就基本了明白了Asp.NetCore WebApplication的启动流程了。

internal static void ConfigureWebDefaults(IWebHostBuilder builder)
    {
      builder.ConfigureAppConfiguration((Action<WebHostBuilderContext, IConfigurationBuilder>) ((ctx, cb) =>
      {
        if (!ctx.HostingEnvironment.IsDevelopment())
          return;
        StaticWebAssetsLoader.UseStaticWebAssets(ctx.HostingEnvironment, ctx.Configuration);
      }));
      builder.UseKestrel((Action<WebHostBuilderContext, KestrelServerOptions>) ((builderContext, options) => options.Configure((IConfiguration) builderContext.Configuration.GetSection("Kestrel")))).ConfigureServices((Action<WebHostBuilderContext, IServiceCollection>) ((hostingContext, services) =>
      {
        services.PostConfigure<HostFilteringOptions>((Action<HostFilteringOptions>) (options =>
        {
          if (options.AllowedHosts != null && options.AllowedHosts.Count != 0)
            return;
          string str = hostingContext.Configuration["AllowedHosts"];
          string[] strArray1;
          if (str == null)
            strArray1 = (string[]) null;
          else
            strArray1 = str.Split(new char[1]{ ';' }, StringSplitOptions.RemoveEmptyEntries);
          string[] strArray2 = strArray1;
          HostFilteringOptions filteringOptions = options;
          string[] strArray3;
          if (strArray2 == null || strArray2.Length == 0)
            strArray3 = new string[1]{ "*" };
          else
            strArray3 = strArray2;
          filteringOptions.AllowedHosts = (IList<string>) strArray3;
        }));
        services.AddSingleton<IOptionsChangeTokenSource<HostFilteringOptions>>((IOptionsChangeTokenSource<HostFilteringOptions>) new ConfigurationChangeTokenSource<HostFilteringOptions>(hostingContext.Configuration));
        services.AddTransient<IStartupFilter, HostFilteringStartupFilter>();
        if (string.Equals("true", hostingContext.Configuration["ForwardedHeaders_Enabled"], StringComparison.OrdinalIgnoreCase))
        {
          services.Configure<ForwardedHeadersOptions>((Action<ForwardedHeadersOptions>) (options =>
          {
            options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto;
            options.KnownNetworks.Clear();
            options.KnownProxies.Clear();
          }));
          services.AddTransient<IStartupFilter, ForwardedHeadersStartupFilter>();
        }
        services.AddRouting();
      })).UseIIS().UseIISIntegration();
    }

3.区别：

在我看来Asp.Net就像一个全家桶，在我默认使用框架中基本上包含了所有进行Web开发的框架如HttpContext,Session等。而Asp.NetCore更像是一个自选桶你可以在StartUp.cs中自定义的添加你需要的Services。在我看来，Asp.NetCore变得更加透明和更加灵活了。

4.部署和发布。

1. 我们将此项目用文件系统打包部署到本地即可。点击Publish即可。

2. 确保打开Windows的IIS服务。

确保IIS中安装了AspNetCoreModule.

若无安装（去安装）：下载安装即可

现在来添加IIS服务

运行成功，即发布成功了。

若不能成功运行请检查部署目录中是否有此文件。