.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 的應用程序。
優點
- 不需要提前定義 .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 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進行發布。
.NET Core部署中你不了解的框架依賴與獨立部署