快速搞懂.NET 5/.NET Core应用程序的发布部署

.NET Framework时代，.NET 应用程序大多直接部署运行在Windows服务器上，固然也能够经过Mono部署运行在Linux上。不管部署exe，仍是IIS站点、或是Windows Service，编译后的程序直接copy、简单配置部署上便可。

有了.NET Core以后，.NET应用程序完美支持跨平台部署，.NET 5 Release后，沿袭了.NET Core应用程序发布模式。

支持跨平台部署运行，.NET 5/.NET Core的应用程序面临着多平台，多场景的部署需求。好比说：部署在Windows、Linux、MaxOS...，OS层面是否须要部署.NET Runtime运行时，.NET Runtime运行时的版本选择，等等。

所以，今天咱们研究一下.NET 5/.NET Core应用程序的部署发布。

1、两种应用程序发布模式

  1. 以自包含的方式发布应用程序

      这种模式包含.NET运行时和应用程序及其依赖项的应用程序。咱们能够在未安装.NET运行时的操做系统上运行它。

      总结一句话：把.NET Runtime运行时打包到程序运行目录中，应用程序运行的主机不须要安装.NET Runtime运行时。

  2. 以依赖于框架的方式发布应用程序

      生成一个仅包含应用程序自己及其依赖项的应用程序。应用程序的运行环境必须单独安装.NET运行时。

      总结一句话：不包含.NET Runtime运行时，只有应用程序自己和依赖的应用程序。应用程序运行的主机须要单独安装应用程序所需的.NET Runtime运行时。

2、NET 5/.NET Core的应用程序的发布指令：dotnet publish

  dotnet publish -将应用程序及其依赖项发布到指定的文件夹中，以方便后续部署到目标托管系统。

  关于dotnet publish的使用说明，能够参考如下连接：https://docs.microsoft.com/en-us/dotnet/core/tools/dotnet-publish?WT.mc_id=DT-MVP-5003918

dotnet publish [<PROJECT>|<SOLUTION>] [-c|--configuration <CONFIGURATION>]
    [-f|--framework <FRAMEWORK>] [--force] [--interactive]
    [--manifest <PATH_TO_MANIFEST_FILE>] [--no-build] [--no-dependencies]
    [--no-restore] [--nologo] [-o|--output <OUTPUT_DIRECTORY>]
    [-p:PublishReadyToRun=true] [-p:PublishSingleFile=true] [-p:PublishTrimmed=true]
    [-r|--runtime <RUNTIME_IDENTIFIER>] [--self-contained [true|false]]
    [--no-self-contained] [-v|--verbosity <LEVEL>]
    [--version-suffix <VERSION_SUFFIX>]

dotnet publish -h|--help

   dotnet publish 将编译应用程序，读取其在项目文件中指定的依赖项，而后将结果文件集发布到目录中。输出包括如下内容：

• 具备dll扩展名的程序集中的中间语言（IL）代码。
• 一个.deps.json文件，其中包含项目的全部依赖项。
• 一个.runtimeconfig.json文件，它指定应用程序指望的共享运行时，以及该运行时的其余配置选项（例如，垃圾收集类型）。
• 应用程序依赖的应用程序，从NuGet缓存目录复制到输出文件夹中。

    从上述描述中，咱们能够发现，经过dotnet publish指令，咱们能够编译应用程序，生成并输出指定运行环境的交付物。

    咱们新建一个.NET 5的Console应用程序，同时引用Newtonsoft.Json Nuget包。

    

    Main函数的代码：

using System;

namespace NET5PublishExample
{
    class Program
    {
        static void Main(string[] args)
        {
            var msg = Newtonsoft.Json.JsonConvert.SerializeObject("Hello .NET 5!");
            Console.WriteLine(msg);
            Console.ReadKey();
        }
    }
}

  首先，编译一下这个工程dotnet build，这一步很重要。而后，使用命令行执行dotnet publish指令：

   

   咱们看一下F:\GitHub\Source\Repos\NET5PublishExample\bin\Debug\net5.0\publish\目录下生成的文件：

   

    正如上面所说，输出包括如下内容：

• 具备dll扩展名的程序集中的中间语言（IL）代码：NET5PublishExample.dll
• 一个.deps.json文件，其中包含项目的全部依赖项。NET5PublishExample.deps.json
• 一个.runtimeconfig.json文件，它指定应用程序指望的共享运行时，以及该运行时的其余配置选项（例如，垃圾收集类型）。NET5PublishExample.runtimeconfig.json
• 应用程序依赖的应用程序，从NuGet缓存目录复制到输出文件夹中。Newtonsoft.Json.dll

     同时，还生成了一个Windows平台的可执行文件：NET5PublishExample.exe，双击能够执行：

     

     另外，使用dotnet NET5PublishExample.dll，也能够直接执行：

      

     而后有几个疑问：

     NET5PublishExample.dll是否是能够跨平台运行？

     在Linux、MacOS平台下有没有对应的可执行文件？

     带着这2个问题，咱们继续往下研究？

3、dotnet publish生成的可执行文件和跨平台二进制文件

     自包含的方式发布应用程序，依赖于框架的方式发布应用程序。这两种发布模式默认状况下都会生成特定于平台的可执行文件和跨平台二进制文件。

     1. 可执行文件

     可执行文件不是跨平台的。它们特定于操做系统和CPU体系结构。由于Windows和linux下的可执行文件的结构和内容是不一样的，因此可执行文件是分操做系统的。

     建立可执行文件时，同时能够选择将应用程序发布为自包含或依赖于框架。

     以自包含的方式发布应用程序包括该应用程序的.NET运行时，而且该应用程序的用户没必要担忧在运行该应用程序以前安装.NET。能够直接执行！

     发布为与框架相关的应用程序不包括.NET运行时和库。仅包括应用程序和第三方依赖项。须要安装.NET 运行时。

     这里咱们示例2个平台的可执行文件：

     ① windows-x64平台

     

      ② Linux-x64平台

       使用的dotnet publish指令 dotnet publish -r linux-x64 --self-contained false

       

       生成的可执行文件：

       

     2. 跨平台的二进制文件

     将应用程序发布为依赖于框架的dll文件形式时，就会建立跨平台的二进制文件。该dll文件以项目命名。例如，若是您有一个名为应用程序NET5PublishExample，文件名为NET5PublishExample.dll建立。

     以这种方式发布的应用程序dotnet <filename.dll>能够经过命令运行，能够在任何平台上运行。

4、关于自包含的发布选项和示例

    以自包含的方式发布应用会生成特定于平台的可执行文件。

    输出发布文件夹包含应用程序的全部组件，包括.NET库和目标运行时。该应用程序与其余.NET应用程序隔离，而且不使用本地安装的.NET运行时。所以无需下载并安装.NET 运行时。

    可执行二进制文件针对指定的目标平台生成。例如，若是您有一个名为NET5PublishExample的应用程序，而且发布了Windows的自包含可执行文件，则会建立NET5PublishExample.exe文件。对于Linux或macOS发布，将建立一个NET5PublishExample文件。目标平台和体系结构-r <RID>由dotnet publish命令的参数指定。有关RID的更多信息，请参见.NET RID目录。

    若是应用程序具备特定于平台的依赖项，例如包含特定于平台的依赖项的NuGet程序包，则这些依赖项将与应用程序一块儿复制到publish文件夹中。

    这种模式的优点有哪些呢？

1.     控制.NET版本：能够控制与应用程序一块儿部署的.NET版本。
2.     指定运行的平台：由于必须为每一个平台发布应用程序，因此咱们须要肯定应用程序将在何处运行。若是.NET引入了新平台，则必须先发布针对该平台的版本，而后才能在该平台上运行您的应用程序。

    同时也带来了如下问题：

1.     更大的部署内容：应用程序包括.NET运行时和全部应用程序依赖项，因此所需的下载大小和硬盘空间大于依赖于框架的版本。
2.     难以更新.NET版本.NET Runtime：（随应用程序分发）只能经过发布新版本的应用程序进行升级。可是，.NET将根据应用程序运行的计算机上框架库的须要更新关键的安全补丁。

    例如：

    示例1：发布一个独立的应用程序，建立macOS 64位可执行文件，同时包含了.NET 运行时

dotnet publish -r osx-x64

    生成的文件列表以下：包含macOS 64可执行文件NET5PublishExample，以及包含了对应macOS 64平台下的.NET 运行时

    

      示例2：发布一个独立的应用程序，建立Windows 64位可执行文件，同时包含了.NET 运行时

 dotnet publish -r win-x64

    生成的文件列表以下：包含Windows 64可执行文件NET5PublishExample.exe，以及包含了对应Windows 64平台下的.NET 运行时

       

5、关于依赖框架的发布选项和示例

  发布为依赖框架的应用程序是跨平台的，而且不包含.NET运行时。应用程序的运行须要单独安装指定版本的.NET运行时。

  应用程序的跨平台二进制文件可使用dotnet <filename.dll>命令运行，而且能够在任何平台上运行。若是应用程序使用具备特定于平台的实现的NuGet包，则全部平台的依赖项都将与应用程序一块儿复制到publish文件夹中。

  能够经过将-r <RID> --self-contained false参数传递给dotnet publish命令来为特定平台建立可执行文件。当-r参数被省略，为当前平台建立一个可执行文件。具备目标平台特定于平台的依赖关系的任何NuGet软件包都将复制到publish文件夹中。

  这种模式带来的优点有：

1.   小型部署：仅分发应用程序及其依赖项。.NET运行时和库由用户安装，全部应用共享运行时。
2.   跨平台：应用程序和任何基于.NET的库均可以在其余操做系统上运行
3.   使用最新的.NET运行时：该应用程序使用目标系统上安装的最新运行时（在.NET的目标主要，次要家族中）。这意味着应用程序会自动使用最新的.NET运行时修补版本。

   同时也带来了如下问题：

1.    须要预安装.NET 运行时：仅在主机系统上已安装应用目标的.NET运行时版本时，应用才能运行。
2.    .NET可能会更改：.NET运行时和库可能会在运行该应用程序的计算机上更新。

   例如：

   示例1：发布一个当前平台的依赖框架的跨平台应用程序，不包含.NET 运行时，将与dll文件一块儿建立一个针对当前平台的可执行文件。   

dotnet publish

   

   使用dotnet NET5PublishExample.dll，能够直接运行（本机已经安装.NET运行时，NET5PublishExample.dll是跨平台的二进制文件）

   示例2：发布一个依赖框架的跨平台应用程序（Linux 64位），不包含.NET 运行时，将建立一个Linux 64位可执行文件以及dll文件。    

dotnet publish -r linux-x64 --self-contained false

      使用dotnet NET5PublishExample.dll，能够直接运行（本机已经安装.NET运行时，NET5PublishExample.dll是跨平台的二进制文件）

      

  6、ReadyToRun编译选项

   经过将应用程序程序集编译为ReadyToRun（R2R）格式，能够改善.NET应用程序的启动时间和延迟。R2R是一种提早（AOT）编译的形式。

   R2R二进制文件经过减小应用程序加载时即时（JIT）编译器须要完成的工做量来提升启动性能。与JIT产生的代码相比，二进制文件包含类似的本机代码。

   可是，R2R二进制文件较大，由于它们既包含中间语言（IL）代码（某些状况下仍然须要此代码）和同一代码的本机版本。仅当发布针对特定运行时环境（RID）（例如Linux x64或Windows x64）的应用程序时，R2R才可用。

   总结一下：经过R2R方式，能够直接将代码编译为Native Code，减小.NET 程序第一次加载是JIT编译带来的性能消耗，以提高.NET应用的首次加载性能。相似于ngen的程序集预加载。关于Ngen能够参考这个连接：ngen

   对应的dotnet publish指令选项：   dotnet publish -c Release -r win-x64 -p:PublishReadyToRun=true

 

   以上是.NET 5/.NET Core应用程序的发布部署的一些研究和分享。

   推荐一个不错的知识连接：https://docs.microsoft.com/en-us/dotnet/core/deploying/#publish-framework-dependent?WT.mc_id=DT-MVP-5003918

 

周国庆

2020/2/15