Linkerd Service Mesh 服务配置文件规范

服务配置文件Linkerd 提供有关服务的附加信息。
以下是可以使用服务配置文件完成的所有操作的参考。

系列

中文手册(https://linkerd.hacker-linner.com)

Spec(规范)

服务配置文件规范必须包含以下顶级字段:

fieldvalue
routesroute 对象的列表
retryBudget定义此服务的最大重试率的 retry budget 对象

Route(路由)

route 对象必须包含以下字段:

fieldvalue
name这条 route 的名称,因为它将出现在 route 标签中
condition一个 request match 对象,用于定义请求是否与此 route 匹配
responseClasses(可选)response class 对象列表
isRetryable表示对该 route 的请求始终可以安全重试,并且会导致 proxy 尽可能重试该 route 上失败的请求
timeout发送请求后等待响应(包括重试)完成的最长时间

Request Match(请求匹配)

请求匹配对象必须恰好包含以下字段之一:

fieldvalue
pathRegex匹配请求路径的正则表达式
methodGET, POST, PUT, DELETE, OPTION, HEAD, TRACE 之一
all必须全部匹配的 request match 对象列表
anyrequest match 对象的列表,其中至少一个必须匹配
not必须不匹配的 request match 对象

Request Match 使用示例

最简单的条件是路径正则表达式:

pathRegex: '/authors/\d+'

这是检查请求方法的条件:

method: POST

如果设置了多个条件字段,则必须满足所有条件。这等效于使用 all 条件:

all:
- pathRegex: '/authors/\d+'
- method: POST

可以使用 allanynot 组合条件:

any:
- all:
  - method: POST
  - pathRegex: '/authors/\d+'
- all:
  - not:
      method: DELETE
  - pathRegex: /info.txt

Response Class(响应类)

response class 对象必须包含以下字段:

fieldvalue
condition一个 response match 对象,它定义一个 response 是否匹配这个 response class
isFailure一个布尔值,用于定义这些 response 是否应归类为失败

Response Match(响应匹配)

response match 对象必须恰好包含以下字段之一:

fieldvalue
status用于匹配响应状态代码的 status range 对象
all必须全部匹配的 response match 对象列表
anyresponse match 对象列表,其中至少一个必须匹配
not必须不匹配的 response match 对象

Response Match 条件可以以类似于上面显示的 Request Match 使用示例 的方式组合

Status Range(状态范围)

status range 对象必须包含以下至少一个字段。只指定 minmax 中的一个将只匹配一个状态码。

fieldvalue
min状态码必须大于或等于此值
max状态码必须小于或等于此值

Retry Budget(重试预算)

retry budget 指定应发送到此服务的最大重试总次数原始请求量比率

fieldvalue
retryRatio重试请求原始请求的最大比率
minRetriesPerSecond除了 retryRatio 允许的重试次数外,允许每秒重试次数
ttl指示在计算 retryRatio 时应考虑请求的时间

实战

公众号:黑客下午茶
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值