Linkerd Service Mesh 服务配置文件规范

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

系列

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

Spec(规范)

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

field value routes route 对象的列表 retryBudget 定义此服务的最大重试率的 retry budget 对象

Route(路由)

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

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

Request Match(请求匹配)

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

field value pathRegex 匹配请求路径的正则表达式 method GET, POST, PUT, DELETE, OPTION, HEAD, TRACE 之一 all 必须全部匹配的 request match 对象列表 any request 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 对象必须包含以下字段：

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

Response Match(响应匹配)

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

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

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

Status Range(状态范围)

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

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

Retry Budget(重试预算)

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

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

实战

设置服务配置文件
完整的 demo 演练

公众号：黑客下午茶