前言

今天，我們很高興宣布 CAP 發布 6.0 版本正式版，在這個版本中，我們主要致力于對 OpenTelemetry 提供支持，以及更好的適配 .NET 6。

那么，接下來我們具體看一下吧。

總覽

可能有些人還不知道 CAP 是什么，老規矩來一個簡介。

CAP 是一個用來解決微服務或者分布式系統中分布式事務問題的一個開源項目解決方案（https://github.com/dotnetcore/CAP）同樣可以用來作為 EventBus 使用，該項目誕生于2016年，目前在 Github 已經有超過 5000+ Star 和 70 個貢獻者，以及在 NuGet 超200萬的下載量，并在越來越多公司的和項目中得到應用。

如果你想對 CAP 更多了解，請查看我們的 官方文檔（http://cap.dotnetcore.xyz/）。

本次在 CAP 6.0 版本中我們主要帶來了以下新特性：

• 適配 .NET 6 啟用 #nullable

• 支持 OpenTelemetry

• 改進 NATS Jetstream 對通配符的支持

• Azure ServiceBus 支持自定義 Header

• 更新依賴的 NuGet 包到最新版本

適配 .NET 6

雖然上一個版本也能夠在 .NET 6 的項目中使用，但是在這個版本中我們升級了我們的 NuGet 包到和框架符合的 .NET 6 的版本，并且對于依賴了EF的包兼容了 .NET Standard 2.1 的支持。

過去我們使用 Jetbrains.Annotations 包對可能存在null的場景進行檢查，但是并不徹底，而且IDE對其支持有限。在新的 .NET 6版本中官方已經默認開啟了#nullable的功能，所以我們也是將所有的庫都進行了啟用，以便于對可能存在null的場景盡可能在編譯階段知道，從而讓代碼更加穩健。

支持 OpenTelemetry

自 2.6 版本一直以來，我們提供了對 Diagnostics 的支持，并且我們在 SkyAPM.Diagnostics.CAP 中提供了對 Skywalking 的支持以用于做分布式跟蹤，但這僅限于在 Skywalking 中才能使用。

在 .NET 6 中，.NET 團隊改進了對分布式跟蹤的支持，所以在這個版本中，CAP 提供了對 OpenTelemetry 的支持。

OpenTelemetry 是 CNCF 的一個可觀測性項目，旨在提供可觀測性領域的標準化方案，解決觀測數據的數據模型、采集、處理、導出等的標準化問題，提供與三方 vendor 無關的服務。它是一組標準和工具的集合，旨在管理觀測類數據，如 trace、metrics、logs 等。

集成CAP的方式也很簡單，以在 ASP.NET Core 項目中為例：

首先，引用 DotNetCore.CAP.OpenTelemetry 包

PM> Install-Package DotNetCore.CAP.OpenTelemetry

然后，在集成了 OpenTelemetry 的項目( https://opentelemetry.io/docs/instrumentation/net/getting-started/#aspnet-core )中添加 CAP 的 Instrumentation 即可。

public?void?ConfigureServices(IServiceCollection?services){services.AddOpenTelemetryTracing((builder)?=>?builder.AddAspNetCoreInstrumentation().AddCapInstrumentation()?// <-- CAP 的支持，只需添加此行.AddZipkinExporter());}

這樣，你就可能使用你喜愛的工具來對跟蹤請求進行查看。以下為CAP 在 Zipkin 的一個截圖。

你可以在文檔中找到更多信息。

https://cap.dotnetcore.xyz/user-guide/zh/monitoring/opentelemetry/

改進 NATS Jetstream 對通配符的支持

我們在上個版本（5.2）中改進了對 JetStream 的支持，但是不能發送帶有* 通配符的消息，這個在 JetStream中是受支持的，在這個版本中我們對此進行了優化，現在你可能正常的發送帶有通配符的消息。

此外，我們還提供了 NormalizeStreamName 配置項用于處于多個不同名稱的流綁定同一個Topic的問題，默認情況下使用 '.' 前面的字符認為處于一個組。

Azure ServiceBus 支持自定義 Header

在這個版本中，Azure ServiceBus 也提供了 CustomHeaders 配置項用于接收來自于異構系統中發送的消息。你可以在文檔中找到更多信息。

https://cap.dotnetcore.xyz/user-guide/en/transport/azure-service-bus/#heterogeneous-systems

感謝 @mviegas 對此提交的PR。

其他

其他的一些改進項目包括：

1、我們將所有的 nuget 的依賴包都升級到了最新版本。

2、修復了一些已知的Bug，你可以在 Github Release 中看到。

總結

以上，就是本版本中支持的一些新特性，感謝大家的支持，我們很開心能夠幫助到大家 。大家在使用的過程中遇到問題希望也能夠積極的反饋，幫助CAP變得越來越好。😃

總結

以上是生活随笔為你收集整理的NCC CAP 6.0 发布 —— 新增支持 OpenTelemetry的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。