.NET Core部署中你不瞭解的框架依賴與獨立部署

作者：依樂祝原文地址：https://www.cnblogs.com/yilezhu/p/9703460.html NET Core項目發佈的時候你有沒有註意到這兩個選項呢？有沒有糾結過框架依賴與獨立部署到底有什麼區別呢？如果有的話那麼這篇文章可以參考下！為什麼要寫這篇文章呢？因為今天同事問我框 ...

作者：依樂祝
原文地址：https://www.cnblogs.com/yilezhu/p/9703460.html
NET Core項目發佈的時候你有沒有註意到這兩個選項呢？有沒有糾結過框架依賴與獨立部署到底有什麼區別呢？如果有的話那麼這篇文章可以參考下！
為什麼要寫這篇文章呢？因為今天同事問我框架依賴與獨立部署到底應該選哪個呢？有什麼區別。印象中只知道框架依賴發佈後文件比獨立部署要小很多，然後就是獨立部署不占用net core的共用資源，而框架依賴需要與其他net core程式共用net core的一些資源。感覺很模糊，所以查了下資料整理如下，希望對大家有所幫助。

依賴框架的部署 (FDD)

定義

框架依賴的部署：顧名思義，依賴框架的部署 (FDD) 依賴目標系統上存在共用系統級版本的 .NET Core。由於已存在 .NET Core，因此應用在 .NET Core 安裝程式間也是可移植的。應用僅包含其自己的代碼和任何位於 .NET Core 庫外的第三方依賴項。 FDD 包含可通過在命令行中使用 dotnet 實用程式啟動的 .dll 文件。例如，dotnet app.dll 就可以運行一個名為 app 的應用程式。
對於 FDD，僅部署應用程式和第三方依賴項。不需要部署 .NET Core，因為應用將使用目標系統上存在的 .NET Core 版本。這是定目標到 .NET Core 的 .NET Core 和 ASP.NET Core 應用程式的預設部署模型。

優點

不需要提前定義 .NET Core 應用將在其上運行的目標操作系統。因為無論什麼操作系統，.NET Core 的可執行文件和庫都是用通用的 PE 文件格式，因此，無論什麼基礎操作系統，.NET Core 都可執行應用。
部署包很小。只需部署應用及其依賴項，而無需部署 .NET Core 本身。
許多應用都可使用相同的 .NET Core 安裝，從而降低了主機系統上磁碟空間和記憶體使用量。

缺點
僅當主機系統上已安裝你設為目標的 .NET Core 版本或更高版本時，應用才能運行。
如果不瞭解將來版本，.NET Core 運行時和庫可能發生更改。在極少數情況下，這可能會更改應用的行為。

獨立部署 (SCD)

定義

獨立部署：與 FDD 不同，獨立部署 (SCD) 不依賴目標系統上存在的共用組件。所有組件（包括 .NET Core 庫和 .NET Core 運行時）都包含在應用程式中，並且獨立於其他 .NET Core 應用程式。 SCD 包括一個可執行文件（如 Windows 平臺上名為 app 的應用程式的 app.exe），它是特定於平臺的 .NET Core 主機的重命名版本，還包括一個 .dll 文件（如 app.dll），而它是實際的應用程式。
對於獨立部署，可以部署應用和所需的第三方依賴項以及生成應用所使用的 .NET Core 版本。創建 SCD 不包括各種平臺上的 .NET Core 本機依賴項，因此運行應用前這些依賴項必須已存在。
從 NET Core 2.1 SDK（版本 2.1.300）開始，.NET Core 支持修補程式版本前滾。在創建獨立部署時，.NET Core 工具會自動包含你的應用程式所指向的 .NET Core 版本的最新服務的運行時。（最新服務的運行時包括安全修補程式和其他 bug 修複程式。）服務的運行時不需要存在於你的生成系統上；它會從 NuGet.org 自動下載。
FDD 和 SCD 部署使用單獨的主機可執行文件，使你可以使用發佈者簽名為 SCD 簽署主機可執行文件。

優點

可以對與應用一起部署的 .NET Core 版本具有單獨的控制權
請放心，目標系統可以運行你的 .NET Core 應用，因為你提供的是應用將在其上運行的 .NET Core 版本

缺點
由於 .NET Core 包含在部署包中，因此必須提前選擇為其生成部署包的目標平臺
部署包相對較大，因為需要將 .NET Core 和應用及其第三方依賴項包括在內。

從.NET Core 2.0 開始，可以通過使用 .NET Core 全球化固定模式在 Linux 系統上減少大約 28 MB 的部署大小。通常，Linux 上的 .NET Core 依賴於 ICU 庫來實現全球化支持。在固定模式下，庫不包含在部署中，並且所有區域性的行為均類似於固定區域性。
向系統部署大量獨立的 .NET Core 應用可能會使用大量磁碟空間，因為每個應用都會複製 .NET Core 文件

實例演示 .NET Core 應用的部署發佈

上面已經說了，可以將 .NET Core 應用程式部署為依賴框架的部署或獨立部署，前者包含應用程式二進位文件，但依賴目標系統上存在的 .NET Core，而後者同時包含應用程式和 .NET Core 二進位文件。

不包含第三方依賴的框架依賴的部署

為項目創建一個目錄，並將其設為當前目錄
在命令行中，鍵入 dotnet new console 以創建新的 C# 控制台項目

在編輯器中打開 Program.cs 文件，然後使用下列代碼替換自動生成的代碼。它會提示用戶輸入文本，並顯示用戶輸入的個別詞。它使用正則表達式 \w+ 來將輸入文本中的詞分開。

using System;
using System.Text.RegularExpressions;

namespace Applications.ConsoleApps
{
    public class ConsoleParser
    {
        public static void Main()
        {
            Console.WriteLine("Enter any text, followed by <Enter>:\n");
            String s = Console.ReadLine();
            ShowWords(s);
            Console.Write("\nPress any key to continue... ");
            Console.ReadKey();
        }

        private static void ShowWords(String s)
        {
            String pattern = @"\w+";
            var matches = Regex.Matches(s, pattern);
            if (matches.Count == 0)
            {
                Console.WriteLine("\nNo words were identified in your input.");
            }
            else
            {
                Console.WriteLine($"\nThere are {matches.Count} words in your string:");
                for (int ctr = 0; ctr < matches.Count; ctr++)
                {
                    Console.WriteLine($"   #{ctr,2}: '{matches[ctr].Value}' at position {matches[ctr].Index}");
                }
            }
        }
    }
}

運行 dotnet restore（請參閱註釋）命令，還原項目中指定的依賴項。
使用 dotnet build命令生成應用程式，或使用 dotnet run命令生成並運行應用程式。
完成程式調試和測試後，使用下列命令創建部署
```
dotnet publish -f netcoreapp2.1 -c Release
```
這將創建一個應用的發行版（而不是調試版）。生成的文件位於名為“publish”的目錄中，該目錄位於項目的 bin 目錄的子目錄中。

與應用程式的文件一起，發佈過程將發出包含應用調試信息的程式資料庫 (.pdb) 文件。該文件主要用於調試異常。可以選擇不將其與應用程式的文件一起分佈。但是，如果要調試應用的發佈版本，則應保存該文件。

可以採用任何喜歡的方式部署完整的應用程式文件集。例如，可以使用簡單的 copy 命令將其打包為 Zip 文件，或者使用選擇的安裝包進行部署。
安裝成功後，用戶可通過使用 dotnet 命令或提供應用程式文件名（如 dotnet fdd.dll）來執行應用程式。
除應用程式二進位文件外，安裝程式還應捆綁共用框架安裝程式，或在安裝應用程式的過程中將其作為先決條件進行檢查。安裝共用框架需要管理員/根訪問許可權。

包含第三方依賴項的依賴框架的部署

要使用一個或多個第三方依賴項來部署依賴框架的部署，需要這些依賴項都可供項目使用。在運行 dotnet restore命令之前，還需執行額外兩個步驟：

向 csproj 文件的部分添加對所需第三方庫的引用。以下部分包含 Json.NET 的依賴項（作為第三方庫）：

<ItemGroup>
  <PackageReference Include="Newtonsoft.Json" Version="10.0.2" />
</ItemGroup>

如果尚未安裝，請下載包含第三方依賴項的 NuGet 包。若要下載該包，請在添加依賴項後執行 dotnet restore命令。因為依賴項在發佈時已從本地 NuGet 緩存解析出來，因此它一定適用於你的系統。

請註意，如果依賴框架的部署具有第三方依賴項，則其可移植性只與第三方依賴項相同。例如，如果某個第三方庫只支持 macOS，該應用將無法移植到 Windows 系統。當第三方依賴項本身取決於本機代碼時，也可能發生此情況。 Kestrel 伺服器就是一個很好的示例，它需要 libuv 的本機依賴項。當為具有此類第三方依賴項的應用程式創建 FDD 時，已發佈的輸出會針對每個本機依賴項支持（存在於 NuGet 包中）的運行時標識符 (RID) 包含一個文件夾。

不包含第三方依賴項的獨立部署

部署沒有第三方依賴項的獨立部署包括創建項目、修改 csproj 文件、生成、測試以及發佈應用。一個用 C# 編寫的簡單示例可說明此過程。該示例演示如何使用命令行中的 dotnet 實用工具創建獨立部署。

為項目創建一個目錄，並將其設為當前目錄。
在命令欄行中，鍵入 dotnet new console，在該目錄中創建新的 C# 控制台項目
在編輯器中打開 Program.cs 文件，然後使用下列代碼替換自動生成的代碼。它會提示用戶輸入文本，並顯示用戶輸入的個別詞。它使用正則表達式 \w+ 來將輸入文本中的詞分開。

using System;
using System.Text.RegularExpressions;

namespace Applications.ConsoleApps
{
    public class ConsoleParser
    {
        public static void Main()
        {
            Console.WriteLine("Enter any text, followed by <Enter>:\n");
            String s = Console.ReadLine();
            ShowWords(s);
            Console.Write("\nPress any key to continue... ");
            Console.ReadKey();
        }

        private static void ShowWords(String s)
        {
            String pattern = @"\w+";
            var matches = Regex.Matches(s, pattern);
            if (matches.Count == 0)
            {
                Console.WriteLine("\nNo words were identified in your input.");
            }
            else
            {
                Console.WriteLine($"\nThere are {matches.Count} words in your string:");
                for (int ctr = 0; ctr < matches.Count; ctr++)
                {
                    Console.WriteLine($"   #{ctr,2}: '{matches[ctr].Value}' at position {matches[ctr].Index}");
                }
            }
        }
    }
}

在 csproj 文件（該文件用於定義應用的目標平臺）的部分中創建標記，然後指定每個目標平臺的運行時標識符 (RID)。請註意，還需要添加分號來分隔 RID。請查看運行時標識符目錄，獲取運行時標識符列表。
例如，以下部分表明應用在 64 位 Windows 10 操作系統和 64 位 OS X 10.11 版本的操作系統上運行。

<PropertyGroup>
    <RuntimeIdentifiers>win10-x64;osx.10.11-x64</RuntimeIdentifiers>
</PropertyGroup>

請註意，元素可能出現在 csproj 文件的任何中。本節後面部分將顯示完整的示例 csproj 文件。

運行 dotnet restore命令，還原項目中指定的依賴項。
運行 dotnet restore（請參閱註釋）命令，還原項目中指定的依賴項。特別是如果應用面向 Linux，則可以通過利用全球化固定模式來減小部署的總規模。全球化固定模式適用於不具有全局意識且可以使用固定區域性的格式約定、大小寫約定以及字元串比較和排序順序的應用程式。要啟用固定模式，右鍵單擊“解決方案資源管理器”中的項目（不是解決方案），然後選擇“編輯 SCD.csproj”。然後將以下突出顯示的行添加到文件中：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
  </PropertyGroup>
  <ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Globalization.Invariant" Value="true" />
  </ItemGroup> 
</Project>

在命令行中，使用 dotnet run 生成命令。
調試並測試程式後，為應用的每個目標平臺創建要與應用一起部署的文件。
同時對兩個目標平臺使用 dotnet publish 命令，如下所示：

dotnet publish -c Release -r win10-x64
dotnet publish -c Release -r osx.10.11-x64

這將為每個目標平臺創建一個應用的發行版（而不是調試版）。生成的文件位於名為“發佈”的子目錄中，該子目錄位於項目的 .\bin\Release\netcoreapp2.1 子目錄的子目錄中。請註意，每個子目錄中都包含完整的啟動應用所需的文件集（既有應用文件，也有所有 .NET Core 文件）。

與應用程式的文件一樣，發佈過程將生成包含應用調試信息的程式資料庫 (.pdb) 文件。該文件主要用於調試異常。可以選擇不使用應用程式文件打包該文件。但是，如果要調試應用的發佈版本，則應保存該文件。
可按照任何喜歡的方式部署已發佈的文件。例如，可以使用簡單的 copy 命令將其打包為 Zip 文件，或者使用選擇的安裝包進行部署。
下麵是此項目完整的 csproj 文件。


<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <RuntimeIdentifiers>win10-x64;osx.10.11-x64</RuntimeIdentifiers>
  </PropertyGroup>
</Project>

包含第三方依賴項的獨立部署

部署包含一個或多個第三方依賴項的獨立部署包括添加依賴項。在運行 dotnet restore命令之前，還需執行額外兩個步驟：

將對任何第三方庫的引用添加到 csproj 文件的部分。以下部分使用 Json.NET 作為第三方庫。

<ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="10.0.2" />
  </ItemGroup>

如果尚未安裝，請將包含第三方依賴項的 NuGet 包下載到系統。若要使依賴項對應用適用，請在添加依賴項後執行 dotnet restore命令。因為依賴項在發佈時已從本地 NuGet 緩存解析出來，因此它一定適用於你的系統。
下麵是此項目的完整 csproj 文件：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>netcoreapp2.1</TargetFramework>
    <RuntimeIdentifiers>win10-x64;osx.10.11-x64</RuntimeIdentifiers>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Newtonsoft.Json" Version="10.0.2" />
  </ItemGroup>
</Project>

部署應用程式時，應用中使用的任何第三方依賴項也包含在應用程式文件中。運行應用的系統上不需要第三方庫。
請註意，可以只將具有一個第三方庫的獨立部署部署到該庫支持的平臺。這與依賴框架的部署中具有本機依賴項和第三方依賴項相似，其中的本機依賴項必須與部署應用的平臺相容。

備註：
從 .NET Core 2.0 開始，無需運行 dotnet restore，因為它由所有需要還原的命令隱式運行，如 dotnet new、dotnet build 和 dotnet run。

總結

本文首先介紹了框架依賴與獨立部署的概念，然後分別介紹了框架依賴與獨立部署的優缺點讓大家加深理解！最後通過一個實例來講述瞭如何進行框架依賴與獨立部署。採用的實例使用的是控制台的方式進行的，當然你也可以使用vs進行發佈。