.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
與應用程式的檔案一樣,釋出過程將生成包含應用除錯資訊的程式資料庫 (.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進行釋出。