1. 前言
入门篇咱们曾经胜利运行 hello.benchmarks.yml 并输入测试后果,本篇咱们就 hello.benchmarks.yml、以及运行的 shell 脚本具体解读下其中的含意
2. 分析 hello.benchmarks.yml
2.1. job
- 在 hello.benchmarks.yml 中咱们定义了一个新的 job: server,并指定了仓库信息 (近程仓库):
repository:https://github.com/doddgu/crank.git # 仓库源
branchOrCommit:sample # 分支
project: samples/hello/hello.csproj # 我的项目
- 并通过 import 导入了 bombardier.yml,其中定义了另外一个 job: bombardier,并指定了仓库信息 (近程仓库):
repository: https://github.com/doddgu/crank.git
branchOrCommit: sample
project: src/Microsoft.Crank.Jobs.Bombardier/Microsoft.Crank.Jobs.Bombardier.csproj
sourceKey: bombardier # 服务器应用它来重用雷同的源文件夹。noBuild: true # 定义 SourceKey 时,批示是否仍应进行构建
2.2. scenarios
-
在 hello.benchmarks.yml 中咱们定义了场景: hello,并为此场景指定了两个工作:
- 第一个工作名为 application,应用的是我的项目 server
- 第二个工作名为 load,并指定应用我的项目 bombardier
2.3. variables 变量
-
在 bombardier.yml 中
- 定义了全局变量: headers、presetHeaders(预设 header)
- 定义了局部变量: connections、warmup、duration、requests、rate、transport、serverScheme 等等
- 在 hello.benchmarks.yml 中为 load 定义了局部变量 serverPort、path
2.4. profiles 配置
-
在 hello.benchmarks.yml 中咱们
- 定义了配置 local
- 并指定了局部变量: serverAddress = localhost
- 为工作 application、load 指定了部署作业的 endpoint 是 http://localhost:5010(指定执行工作的 Agent 地址)
2.5. arguments 参数
- 在 bombardier.yml 中与 variables 同级的配置: arguments,此参数是在启动 job 后传递的参数,其中定义的全局参数、局部参数信息也都是为构建残缺的参数做筹备,bombardier 实在的参数信息是:
-c {{connections}} -w {{warmup}} -d {{duration}} -n {{requests}} --insecure -l {% if rate != 0 %} --rate {{rate}} {% endif %} {% if transport %} --{{transport}} {% endif %} {{headers[presetHeaders]}} {% for h in customHeaders %}{% assign s = h | split : ':' %}--header \"{{s[0] }}: {{s[1] | strip }}\" {% endfor %} {% if serverUri == blank or serverUri == empty %} {{serverScheme}}://{{serverAddress}}:{{serverPort}}{{path}} {% else %} {{serverUri}}:{{serverPort}}{{path}} {% endif %} {% if bodyFile != blank and bodyFile != empty %} -f {{bodyFile}} {% endif %} {% if verb != blank and verb != empty %} -m {{verb}} {% endif %}
3. 革新 hello.benchmarks.yml
革新 hello.benchmarks.yml,不思考重用,最原始的代码如下
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"'
presetHeaders: none
jobs:
bombardier:
source:
repository: https://github.com/dotnet/crank.git
branchOrCommit: main
project: src/Microsoft.Crank.Jobs.Bombardier/Microsoft.Crank.Jobs.Bombardier.csproj
sourceKey: bombardier
noBuild: true
readyStateText: Bombardier Client
waitForExit: true
variables:
connections: 256
warmup: 15
duration: 15
requests: 0
rate: 0
transport: fasthttp # | http1 | http2
serverScheme: http
serverAddress: localhost
serverPort: 5000
path:
bodyFile: # path or url for a file to use as the body content
verb: # GET when nothing is specified
customHeaders: [] # list of headers with the format: '<name1>: <value1>', e.g. [ 'content-type: application/json']
arguments: "-c {{connections}} -w {{warmup}} -d {{duration}} -n {{requests}} --insecure -l {% if rate != 0 %} --rate {{rate}} {% endif %} {% if transport %} --{{transport}} {% endif %} {{headers[presetHeaders]}} {% for h in customHeaders %}{% assign s = h | split :':'%}--header \"{{s[0] }}: {{s[1] | strip }}\"{% endfor %} {% if serverUri == blank or serverUri == empty %} {{serverScheme}}://{{serverAddress}}:{{serverPort}}{{path}} {% else %} {{serverUri}}:{{serverPort}}{{path}} {% endif %} {% if bodyFile != blank and bodyFile != empty %} -f {{bodyFile}} {% endif %} {% if verb != blank and verb != empty %} -m {{verb}} {% endif %}"
onConfigure:
# - job.timeout = Number(job.variables.duration) + Number(job.variables.warmup) + 10;
endpoints:
- http://localhost:5010
server:
source:
repository: https://github.com/doddgu/crank
branchOrCommit: sample
project: samples/hello/hello.csproj
readyStateText: Application started.
endpoints:
- http://localhost:5010
scenarios:
hello:
application:
job: server
load:
job: bombardier
variables:
serverPort: 5000
path: /
4. 解读 crank shell
之前咱们通过 shell 执行:
-
crank –config hello.benchmarks.yml –scenario hello –profile local –load.framework net5.0 –application.framework net5.0
- 其中 crank 是固定的、代表:Crank Controller
- –config:固定的配置,指执行哪个 yml 配置,每次仅能指定一个 yml 配置
- –scenario:固定的配置,设置场景是 hello
- –profile:固定的配置,非必选,可屡次设置,指定以后 Crank 命令申请的配置是 local,应用 local 下配置的所有信息
- –load.framework: 格局:< 工作名 >.framework,为工作 load 指定 framework 的运行框架版本是 net5.0、–application.framework 同理
- 革新 hello.benchmarks.yml,因为移除了 profile,所以执行: crank –config hello.yml –scenario hello –load.framework net5.0 –application.framework net5.0 即可
查看 crank 更多文档
5. 疑难
-
为什么启动 crank 时要减少 –application.framework net5.0?
- 装置 crank 要求必须有 net5.0 的环境,所以指定 net5.0 不须要再独自装置框架环境
-
为什么启动 crank 时不指定 framework 时默认是 netcore3.1 呢?
- 应用记事本关上 hello.csproj、Microsoft.Crank.Jobs.Bombardier.csproj 即可理解
-
scenarios 节点下 application 以及 load 两个节点名称能够更换吗?只能有两个节点?
- 节点名称不固定,能够更换,也没有限度必须是两个节点,具体多少个节点依据本人的须要来
6. 结尾
通过下面的学习,咱们也曾经齐全的理解了各配置的作用,但对 bombardier.yml 与开源我的项目 bombardier 存在什么样的分割还不分明,以及为什么叫做 bombardier.yml 而不是其余名字,并且是如何实现性能指标的输入,接下来就会讲到 bombardier.yml 与开源我的项目 bombardier 的关系,以及 wrk.yml 与 wrk 的关系
源码地址:https://github.com/doddgu/cra…
开源地址
MASA.BuildingBlocks:https://github.com/masastack/…
MASA.Contrib:https://github.com/masastack/…
MASA.Utils:https://github.com/masastack/…
MASA.EShop:https://github.com/masalabs/M…
MASA.Blazor:https://github.com/BlazorComp…
如果你对咱们的 MASA Framework 感兴趣,无论是代码奉献、应用、提 Issue,欢送分割咱们