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.txtResponse Class(响应类)
response class 对象必须包含以下字段:
field value condition 一个 response match 对象,配置它定义一个 response 是文件否匹配这个 response class isFailure 一个布尔值,用于定义这些 response 是规范否应归类为失败Response Match(响应匹配)
response match 对象必须恰好包含以下字段之一:
field value status 用于匹配响应状态代码的 status range 对象 all 必须全部匹配的云南idc服务商 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 时应考虑请求的时间实战
设置服务配置文件https://linkerd.hacker-linner.com/2.11/tasks/setting-up-service-profiles/
完整的 demo 演练https://linkerd.hacker-linner.com/2.11/tasks/books/#service-profiles/