Linkerd Service Mesh 服务配置文件规范

572 阅读2分钟

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

系列

中文手册(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

可以使用 all、any 和 not 组合条件:

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 对象必须包含以下至少一个字段。只指定 min 或 max 中的一个将只匹配一个状态码。

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

Retry Budget(重试预算)

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

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

实战