gRPC在C#中的未来属于grpc-dotnet
作者：Jan Tattermusch
grpc-dotnet（Grpc.Net.Client[1]和Grpc.AspNetCore.Server[2]?nuget 包）現(xiàn)在是.NET/C#中推薦的 gRPC 實現(xiàn)。最初的 gRPC C#實現(xiàn)（Grpc.Core nuget 包）將進(jìn)入維護(hù)模式，不會得到任何新功能，只會收到重要的錯誤修復(fù)和安全修復(fù)。最終的計劃是在未來的某個時候逐步完全淘汰 Grpc.Core。該公告描述了我們決定這樣做的原因，并更詳細(xì)地列出了該計劃。
2019 年 9 月，我們宣布[3]了一個新的gRPC C#實現(xiàn)[4]的普遍可用性，它不再基于 gRPC C 核心原生庫，而是使用了在.NET Core 3 和 ASP.NET Core 3 中添加的 HTTP/2 協(xié)議實現(xiàn)。我們將此實現(xiàn)稱為“grpc-dotnet”。
當(dāng)我們引入 grpc-dotnet 實現(xiàn)時，我們宣布 gRPC C＃實現(xiàn)（新的純 C# grpc-dotnet 實現(xiàn)和基于 C 核心原生庫的最初的 gRPC C#實現(xiàn)）將并存，讓用戶 選擇最適合他們的實現(xiàn)。這很有道理，因為 grpc-dotnet 當(dāng)時是全新的，并且需要一個剛剛發(fā)布的.NET Core 框架，而最初的 gRPC C#實現(xiàn)已經(jīng)穩(wěn)定了很長時間，擁有很多用戶，并且甚至可以使用很老的.NET Framework 版本。事情需要一些時間才能解決。
從那時起，新的 grpc-dotnet 實現(xiàn)已經(jīng)取得了很大的進(jìn)展：它被許多用戶所采用并變得非常流行，它已經(jīng)被許多生產(chǎn)環(huán)境中的應(yīng)用程序所使用，并且還添加了許多有趣的新特性。此外，它的主要先決條件，.NET Core 3 框架已經(jīng)存在一段時間了，并且它的采用人數(shù)正在增長。
同時，最初的 gRPC C#實現(xiàn)[5]（通常稱為“gRPC.Core”，它的 nuget 包的名字）肯定有它的位置，它是非常受歡迎的，我們現(xiàn)在正接近一個點(diǎn)，在 2016 年（當(dāng) gRPC C#作為 GA 發(fā)布時）的一些設(shè)計決定不再有他們過去的重量。例如，我們決定將 gRPC C#實現(xiàn)建立在一個原生庫上，因為在 2016 年，還沒有可用的 C# HTTP/2 庫可供我們依賴。通過依賴 C 核心原生庫，我們能夠更快地交付一個穩(wěn)定的、高性能的 gRPC 庫，而不是從頭開始用 C#實現(xiàn)所有東西。但是從今天的角度來看，采用原生依賴已經(jīng)沒有多大意義了，因為 HTTP/2 支持已經(jīng)內(nèi)置到.NET Core 框架中。擁有原生依賴的好處正在減少，而擁有一個原生依賴的維護(hù)負(fù)擔(dān)卻保持不變。
在這兩種穩(wěn)定的 C#實現(xiàn)中，grpc-dotnet 實現(xiàn)無疑是未來潛力更大的一個。它是一個更現(xiàn)代的實現(xiàn)，與.NET 的現(xiàn)代版本很好地集成在一起，而且它很可能與 C#社區(qū)在幾年后的發(fā)展方向更加一致。它也是一個純粹的 C#實現(xiàn)（沒有原生組件），這使得它對貢獻(xiàn)更加友好，帶來更好的可調(diào)試性，這也是 C#愛好者喜歡看到的東西。
因為為 C#提供兩種官方的 gRPC 實現(xiàn)的維護(hù)成本非同小可，而且從長遠(yuǎn)來看 grpc-dotnet 似乎是所有用戶的最佳選擇，我們想要宣布的計劃是逐步淘汰最初的 gRPC C#實現(xiàn)（nuget 包 gRPC.Core），以支持更現(xiàn)代和更有前瞻性的 grpc-dotnet 實現(xiàn)。
計劃的細(xì)節(jié)將在下面的部分中描述，并進(jìn)一步解釋為什么它是有意義的。為了幫助理解逐步淘汰 Grpc.Core 的后果，此外，我們還列出了一些常見問題，并提供了答案。
是什么讓 grpc-dotnet 成為首選實現(xiàn)
簡單地說，grpc-dotnet 似乎是一個更好的未來賭注。一些最重要的要點(diǎn)已經(jīng)提到了。以下是我們相信 grpc-dotnet 將更好地滿足用戶需求的更詳細(xì)的原因：
這是一個更現(xiàn)代的實現(xiàn)，基于.NET 框架最新版本的特性。因此，將來它可能是兩種實現(xiàn)中更可行的一種。
它更符合 C#/.NET 社區(qū)現(xiàn)在和未來的發(fā)展方向。與社區(qū)的發(fā)展方向保持一致似乎是 C#中 gRPC 未來的最佳選擇。
它的實現(xiàn)更加敏捷，貢獻(xiàn)更加友好——因為它在內(nèi)部是基于眾所周知的原語/API（ASP.NET 核心服務(wù) API 和 HTTP2 客戶端），它是用純 C#實現(xiàn)的，代碼對 C#開發(fā)人員更容易訪問（對只想了解事情如何工作的用戶和可能編寫 PR 的貢獻(xiàn)者）。grpc-dotnet 代碼庫相對較小，構(gòu)建只需幾秒鐘，運(yùn)行測試簡單快捷。從長遠(yuǎn)來看，更輕松的開發(fā)和貢獻(xiàn)友好性應(yīng)彌補(bǔ)當(dāng)今缺少的一些功能，并使其成為用戶的絕佳選擇——也就是說，降低貢獻(xiàn)和修復(fù)/改進(jìn)產(chǎn)品的障礙將轉(zhuǎn)化為更多的產(chǎn)品修復(fù)，并在一段時間后改善用戶體驗。
與依賴于原生組件的實現(xiàn)相比，使用純 C#實現(xiàn)的庫通常更受.NET 社區(qū)的歡迎。雖然 C#很好地支持與原生庫的互操作，但這是一種大多數(shù) C#開發(fā)人員不熟悉的技術(shù)，對他們來說它就像一個黑盒。原生互操作很難正確實現(xiàn)，而且有許多缺點(diǎn)（例如，更復(fù)雜的開發(fā)和構(gòu)建過程、復(fù)雜的調(diào)試、難以維護(hù)、難以獲得社區(qū)貢獻(xiàn)、難以為多個平臺提供支持）。使用 Grpc.Core 我們能夠克服這些挑戰(zhàn)中的大多數(shù)（所以這些天事情都很順利），但這需要大量的努力，解決方案有時是復(fù)雜和脆弱的，維護(hù)它是昂貴的，需要大量的專業(yè)知識。
注意：用于 C#的 Google.Protobuf 庫已經(jīng)完全用 C#編寫（沒有原生組件），所以有一個純粹的 gRPC C#實現(xiàn)就完全擺脫了開發(fā)者微服務(wù)棧中的原生組件。
為什么不永遠(yuǎn)保留 Grpc.Core 呢？
用 C#開發(fā) gRPC 的兩個實現(xiàn)并不是免費(fèi)的。它花費(fèi)了寶貴的資源，我們相信工程時間應(yīng)該花在讓 C#中的 gRPC 更容易使用和添加新功能（當(dāng)然還有修復(fù) bug）上，而不是需要在兩個不同的代碼庫上工作，它們都服務(wù)于同一個目的。另外，擁有兩個獨(dú)立的實現(xiàn)必然會在一定程度上分割用戶基礎(chǔ)，并將貢獻(xiàn)者的工作分成兩部分。同樣，僅僅是用戶需要選擇他們想押注的兩個實現(xiàn)中的哪一個的簡單行為就會帶來不確定性和內(nèi)在風(fēng)險（我們不希望我們的用戶有這樣的風(fēng)險）。
通過使 grpc-dotnet 成為推薦的實現(xiàn)，通過使 Grpc.Core 的實現(xiàn)“僅限維護(hù)”（并最終將其淘汰），我們想實現(xiàn)以下目標(biāo)：
釋放工程資源來開發(fā)更好的特性和可用性。
統(tǒng)一 gRPC C#用戶群。這將導(dǎo)致將所有社區(qū)工作和貢獻(xiàn)導(dǎo)向單一的實施。它還消除了用戶需要選擇使用這兩種正式實現(xiàn)中的哪一種而產(chǎn)生的內(nèi)在摩擦。
解決 Grpc.Core 的一些眾所周知的痛點(diǎn)，很難通過其他方式解決的問題。
通過與.NET 社區(qū)保持一致，讓 gRPC 的 C#/.NET 實現(xiàn)面向未來。
計劃
階段 1：Grpc.Core 變成“僅限維護(hù)”
時間：即刻生效（2021 年 5 月）
從現(xiàn)在開始，我們將不再為 Grpc.Core 提供新特性或增強(qiáng)。重要的錯誤和安全問題將繼續(xù)以正常的方式解決。
我們將正常發(fā)布 Grpc.Core 版本，以通常的 6 周節(jié)奏發(fā)布。
新版本將基于最新的 grpc C 核心原生庫構(gòu)建，所以所有不需要 C#特定工作的新特性也將被包括在內(nèi)。
階段 2：Grpc.Core 變成“棄用”
時間：1 年后（2022 年 5 月）
一旦達(dá)到這一里程碑，Grpc.Core 將不再被官方支持，所有用戶將強(qiáng)烈建議從那時開始只使用 grpc-dotnet。
Grpc.Core nuget 包將繼續(xù)在 nuget.org 倉庫中可用，但不會提供更多的修復(fù)（=甚至沒有安全修復(fù)）。
Grpc.Tools 和 Grpc.Core.Api nuget 包的未來
這兩個包將繼續(xù)得到完全支持，因為嚴(yán)格來說它們不是 Grpc.Core 的一部分，他們也被 grpc-dotnet 使用。
Grpc.Tools nuget 包為 C#項目提供 codegen 構(gòu)建集成將繼續(xù)得到支持（并有可能得到改進(jìn)）——因為它被 Grpc.Core 和 grpc-dotnet 使用。此包獨(dú)立于 C 內(nèi)核。
Grpc.Core.Api 包是 grpc-dotnet 的先決條件，因此它將有可能隨著時間的推移而演變（但它是一個純 C# API 包，因為它只包含公共 API 表面，更改是非常少的）。
常見問題
我現(xiàn)在是 Grpc.Core 用戶，這對我意味著什么？
我們將繼續(xù)支持 Grpc.Core（有關(guān)詳細(xì)信息，請參閱棄用時間表），如果你想在未來繼續(xù)獲得更新和 bug 修復(fù)，你必須將你的項目遷移到 grpc-dotnet。
如何將現(xiàn)有項目遷移到 grpc-dotnet？
因為 Grpc.Core 和 grpc-dotnet 是兩個不同的庫，在你的項目中會有一些必要的代碼更改。由于這兩個實現(xiàn)都共享調(diào)用和處理 rpc 的相同 API（我們故意這樣設(shè)計它們），我們相信必要的代碼更改應(yīng)該相當(dāng)少。對于許多應(yīng)用程序，你只需要改變配置 gRPC 通道和服務(wù)器的方式；這通常只是應(yīng)用程序?qū)崿F(xiàn)的一小部分，往往與業(yè)務(wù)邏輯分離。
更多關(guān)于如何從 Grpc.Core 遷移到 grpc-dotnet 的提示，請參見Migrating gRPC services from C-core to ASP.NET Core[6]。
我們計劃在未來發(fā)布一個更詳細(xì)的遷移指南，以幫助從 Grpc.Core 遷移到 grpc-dotnet。
我想在一個新項目中使用 C#的 gRPC。我應(yīng)該選擇哪種實現(xiàn)？
我們強(qiáng)烈建議在新項目中只使用 grpc-dotnet。我們將在未來停止支持 Grpc.Core。
這是否意味著我現(xiàn)在需要停止使用 Grpc.Core 嗎？
不，Grpc.Core 將繼續(xù)支持一段時間（參見棄用時間表）。你應(yīng)該有足夠的時間來評估情況并計劃遷移。
我沒有在我的代碼中直接使用 gRPC，但我使用谷歌云客戶端庫（它在底層確實使用 Grpc.Core）。這對我有什么影響？
這種棄用目前不會影響谷歌云客戶端庫的現(xiàn)有用戶。
因為 Grpc.Core 是客戶端庫的組成部分，Grpc.Core 的安全和 bug 修復(fù)將繼續(xù)在谷歌云客戶端庫提供。
將提供擴(kuò)展支持的客戶端庫：
Google Cloud Libraries for .NET[7]
Google Ads Client Library for .NET[8]
注意 Grpc.Core 的擴(kuò)展支持將只提供給當(dāng) Grpc.Core 用作這些客戶端庫的一部分時。對于谷歌云客戶端庫之外的其他用例，Grpc.Core 將不會在棄用日期之后得到官方支持，用戶必須在棄用發(fā)生之前將現(xiàn)有工作負(fù)載遷移到 grpc-dotnet。
我可以在哪里找到支持的特性列表？
我們在github 上的文檔[9]對支持的特性進(jìn)行了比較。
我有本文檔沒有涵蓋的一個重要的 Grpc.Core 用例。
我們歡迎你的反饋！通過gRPC-io 谷歌群[10]，或任何其他gRPC 社區(qū)的主要渠道[11]寫給我們。
參考資料
[1]
Grpc.Net.Client:?https://www.nuget.org/packages/Grpc.Net.Client/
[2]Grpc.AspNetCore.Server:?https://www.nuget.org/packages/Grpc.AspNetCore.Server/
[3]宣布:?https://www.grpc.io/blog/grpc-on-dotnetcore/
[4]gRPC C#實現(xiàn):?https://github.com/grpc/grpc-dotnet
[5]最初的 gRPC C#實現(xiàn):?https://github.com/grpc/grpc/tree/master/src/csharp
[6]Migrating gRPC services from C-core to ASP.NET Core:?https://docs.microsoft.com/en-us/aspnet/core/grpc/migration
[7]Google Cloud Libraries for .NET:?https://github.com/googleapis/google-cloud-dotnet
[8]Google Ads Client Library for .NET:?https://github.com/googleads/google-ads-dotnet/
[9]github 上的文檔:?https://github.com/grpc/grpc-dotnet/blob/master/doc/implementation_comparison.md
[10]gRPC-io 谷歌群:?https://groups.google.com/forum/#!forum/grpc-io
[11]gRPC 社區(qū)的主要渠道:?https://www.grpc.io/community/
點(diǎn)擊【閱讀原文】閱讀網(wǎng)站原文。
總結(jié)
以上是生活随笔為你收集整理的gRPC在C#中的未来属于grpc-dotnet的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 深入探究ASP.NET Core读取Re
- 下一篇： C# 答群友:把窗体应用改成类库输出然后