堪比JMeter的.Net压测工具 - Crank 入门篇
1. 前言
Crank 是.NET 團隊用來運行基準測試的基準測試基礎架構，包括（但不限于）來自TechEmpower Web 框架基準測試的場景,是2021年.NET Conf 大會上介紹的一項新的項目，其前身是Benchmarks。
Crank目標之一是為開發人員提供一種工具，讓他們能夠非常輕松地處理性能并衡量潛在的改進。其中一些功能是：
部署和基準測試基于 .NET 或 Docker 容器的多層應用程序
通過指定.Net項目(本地路徑或git遠程倉庫地址)，支持直接部署或通過Docker部署應用程序，用于基準測試）
通過Yml配置，不僅僅支持結果存儲在 JSON 、SQL Server 中還支持存儲到csv文件中以用于圖表
目前有小伙伴已經在提議將支持存儲在es
支持更改自定義應用程序的Franework環境，測試在不同環境下的性能
收集診斷跟蹤信息
2. 核心組成
Crank由Agent、Controller兩部分組成
Controller是任務的調度者，可以調度負載任務以及輸出結果
Agent是基準代理，任務的實際執行者，接收來自Controller的任務并執行。
3. 安裝
欲先工其善 必先利其器，我們先學習下如何安裝crank，以及如何驗證是否安裝成功
3.1. 準備工作
安裝 .NET 5.0.
打開shell：安裝Crank Controller
安裝命令：
驗證命令：
crank打開shell: 安裝Crank Agent
安裝命令：
驗證命令：
crank-agent3.2. 小結
為方便閱讀、文章中Crank Controller簡稱Crank，Crank Agent簡稱Agent
Agent以及Crank需要根據實際情況安裝，可分以下幾種情況:
只是為了學習Crank，沒有單獨的測試環境，則需要分別安裝Agent、Controller
Agent有單獨提供測試環境，則本地不需要安裝Agent，只安裝Controller即可
Agent有單獨提供測試環境，且壓測任務由ci來觸發執行，則本地不需要安裝任何配置，通過構建ci任務完成壓力計劃即可
打開shell：查看Agent、Controller版本
dotnet tool list -g4. 基礎知識
4.1. variables: 參數
variables分為局部參數與全局參數兩種類型，在根節點的為全局參數，在其他節點下的是局部參數。
例：
hello.benchmarks.yml > scenarios > hello-load > variables節點下的serverPort以及path以及profiles>local>variables節點下的serverAddress是局部參數
scenarios:hello:application:job: serverload:job: bombardiervariables:serverPort: 5000path: /profiles:local:variables:serverAddress: localhostbombardier.yml > variables > headers為全局參數
variables:headers:none: ''plaintext: '--header "Accept: text/plain,text/html;q=0.9,application/xhtml+xml;q=0.9,application/xml;q=0.8,*/*;q=0.7" --header "Connection: keep-alive"'html: '--header "Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8" --header "Connection: keep-alive"'json: '--header "Accept: application/json,text/html;q=0.9,application/xhtml+xml;q=0.9,application/xml;q=0.8,*/*;q=0.7" --header "Connection: keep-alive"'connectionclose: '--header "Connection: close"'---------------------------------------------------------------------4.2. profiles: 配置
profiles其實就是配置文件信息，profiles允許被多次使用，這點可以在文檔中找到對應介紹。
Usage: crank [options]Options:-?|-h|--help ? ? ? ? ? ? ? ? ? ? ? Show help informationThese options are not specific to a Job------------------------------------------------------------------------profile <profile> ? ? ? ? ? ? ? Profiles to apply. Can be used multiple times.命名規則: 建議 *.profiles.yml
4.3. jobs: 任務
將我們要做的事定義為一個job。方便之后重用。此處的事指的是一類事，而不是指特定的某件事。
例如：微軟內置定義的bombardier就是一個job，這個job是通過bombardier對其進行基準測試，并將結果記錄并輸出，而具體針對哪個接口進行基準測試其實并不關心。
job根據應用程序源有分為遠程、本地兩種。
本地源：
jobs:server: #任務名稱，可根據任務作用自行命名source: #任務源localFolder: ../hello project: hello.csproj #要構建的 .NET 項目的文件名readyStateText: Application started. #控制臺中通知服務器它已啟動的文本本地源localFolder針對當前運行crank --config執行命令所在的相對路徑即可，任務開始后會將本地的項目發送到agent后再執行任務。
遠程源
jobs:server:source:repository: https://github.com/dotnet/crankbranchOrCommit: main #遠程源執行任務的分支project: samples/hello/hello.csproj #要構建的 .NET 項目的文件名，格式：相對根的相對路徑+項目名.csprojreadyStateText: Application started.遠程源會將倉庫信息發送到Agent，Agent會先將倉庫下載下來并切換到指定的分支后再執行構建任務啟動項目
4.4. scenarios: 場景
job關心的是一類事，而特定的事情并不關心，那具體的事是誰比較關心呢，沒錯那就是場景，也就是scenarios，scenarios通過多個job來完成對指定場景的基準測試，做的是具體任務的編排
4.5. imports: 導入
imports為我們提供了yml重用的可能，因為有imports的支持，我們才可以將公共的yml提取到一個單獨的yml中，通過imports將使用到的yml導入即可，與js、css的導入有異曲同工之妙
4.6. 小結
在crank中，variables、profiles都不是必須的，但因為它們的存在，才使得我們可以以面向對象的思想開發，可以通過新增變量或指定配置完成基準測試，這塊后面的實戰中會有詳細解釋
5. 入門
經過之前的學習，我們對crank的基本配置也有了一定的了解，那接下來的時間，我們先試著學習下官方已經給我們準備好的Sample，下面的教程也會詳細講解一下各個配置的作用，希望能通過下面的學習了解到Crank的工作基本原理
5.1. 啟動Agent
crank-agent --dotnethome "/home/{your-account}/dotnet"5.1.0.1. 啟動Agent并指定dotnet環境
格式：crank-agent –dotnethome "dotnet安裝地址"
crank-agent --dotnethome "C:\Program Files\dotnet" (windows)
crank-agent --dotnethome "/usr/share/dotnet" (Linux)
在啟動agent時，強烈建議大家增加dotnethome 配置，為agent運行指定環境，以免運行任務時由于環境問題而卡在install sdk這里
因演示機器本地dotnet的使用的是安裝路徑為/home/gushoudao/dotnet，所以視頻中運行的命令有所不同，這塊還需要根據本地的實際情況自行調整路徑即可 (因視頻錄制原因，在錄制結束后會停止agent，我們真實使用中啟動后不需要退出，一旦退出agent，就無法執行任務)
5.1.0.2. 啟動Agent并指定不清理臨時文件
crank-agen --no-cleanup (指定不清理臨時文件)
默認agent執行任務結束后會刪除當前任務執行過程中產生的臨時文件
5.1.0.3. 啟動Agent并指定構建任務的最大持續時間
crank-agent --build-timeout
默認構建任務的最大持續時間為10 minutes
更多配置點擊查看
5.2. 新建hello.benchmarks.yml配置
配置文件源碼來自hello.benchmarks.yml
imports:- https://raw.githubusercontent.com/doddgu/crank/sample/src/Microsoft.Crank.Jobs.Bombardier/bombardier.ymljobs:server:source:repository: https://github.com/doddgu/crankbranchOrCommit: sampleproject: samples/hello/hello.csprojreadyStateText: Application started.scenarios:hello:application:job: serverload:job: bombardiervariables:serverPort: 5000path: /profiles:local:variables:serverAddress: localhostjobs: application:endpoints: - http://localhost:5010load:endpoints: - http://localhost:50105.3. 啟動任務
啟動agent（打開放在一邊）：
crank-agent --dotnethome "/usr/share/dotnet"啟動任務（另起一個新的Shell）：
git clone https://github.com/doddgu/crank.git cd crank git checkout sample crank --config ./samples/hello/hello.original.benchmarks.yml --scenario hello --load.framework net5.0 --application.framework net5.0然后我們等待片刻會輸出以下結果
crank-agent：
crank：
當你能輸出以上信息的時候，證明了你已經成功跑通了整個流程
在上面我們可以很清楚的看到場景hello下的測試結果，其中包含CPU使用率、多核CPU的使用率、內存使用率以及每秒執行的請求數等等指標
在這一刻是不是突然覺得這個crank挺強大的，雖然還不清楚具體是咋做到的，但是真的很贊！！在這一刻是不是對它來了興趣，想知道它到底可以做什么，為什么可以輸出以上的結果？
6. 結尾
為確保后續不會因更新導致按照文檔操作不可用，源碼從官方源Fork了一份，其中絕大多數來自官方提供的Sample、部分文件為了更好的滿足個人習慣，會在一定程度上進行調整。
源碼地址：https://github.com/doddgu/crank/tree/sample
參考鏈接：
https://github.com/dotnet/crank
https://github.com/aspnet/Benchmarks
https://www.youtube.com/watch?v=2IgfrnG-128
開源地址
MASA.BuildingBlocks：https://github.com/masastack/MASA.BuildingBlocks
MASA.Contrib：https://github.com/masastack/MASA.Contrib
MASA.Utils：https://github.com/masastack/MASA.Utils
MASA.EShop：https://github.com/masalabs/MASA.EShop
MASA.Blazor：https://github.com/BlazorComponent/MASA.Blazor
如果你對我們的 MASA Framework 感興趣，無論是代碼貢獻、使用、提 Issue，歡迎聯系我們
總結
以上是生活随笔為你收集整理的堪比JMeter的.Net压测工具 - Crank 入门篇的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： BeetleX服务网关授权配置
- 下一篇： 如何编译 dotnet/aspnetco