以下页面描述网关的预期行为。开源版本与企业版本正在拆分中,首个正式版本发布后细节会同步更新。
核心概念
目标、路由、凭据与会话 —— 后续章节使用的术语,先在这里一次讲清。
有五个术语承载了大部分配置。在这里一次定义清楚,后续章节就不再重复解释。
这五项都在控制台中管理,不在配置文件里。
Provider(服务方)
一个上游 HTTP 服务,使用你选定的某种协议方言。Provider 由名称、base URL 以及它接受的 路由来标识。Provider 在控制台中添加。
Route(路由)
Provider 接受的路径模式,例如 POST /v1/messages。路由决定了 provider 是否可达 ——
没有匹配路由的 provider 永远不会被选中。
路由描述的是请求可以被发往哪里,而不是如何转换。
Credential(凭据)
Solidway 向 provider 认证的方式:一个 Header、一个 Bearer Token,或云厂商的签名方案 (AWS SigV4、GCP ADC)。凭据在控制台录入,加密后落盘。
一个 provider 上的多个凭据构成密钥池。故障转移在池内轮转,负载均衡在池内分配。
Target(目标)
一个具体的 (provider, route, credential) 三元组,是请求可以被发往的实体。
回退链中的每一次尝试,都是针对某个 target 的一次尝试。
Session(会话)
可选的分组,把一连串请求固定在同一个 target 上。当 provider 从本地性中获益时有用。 会话不会覆盖健康状态:被暂停轮转的 target 即使被会话指向,也会被跳过。
它们如何配合
请求 ──► 匹配路由 ──► 选中 provider ──► 选定凭据
│
▼
target(一次尝试)
│
失败? ────┴────► 下一个 target