池集合允许你将地理导向与其他流量引导策略结合使用。例如,你可以在特定区域或国家/地区内应用 Dynamic Latency 引导。对于通过 API 管理的负载均衡器,池集合可以替代 Geo steering。
使用池集合,你可以:
- 在单个位置内应用任何受支持的流量引导策略
- 设置仅适用于该位置的池权重
- 为该位置指定回退池,而不是使用全局回退池
- 为匹配的已代理流量返回固定 HTTP 响应
池集合作为负载均衡器上的有序数组存储。Cloudflare 按数组顺序评估它们,并在第一个 match 成功的池集合处停止。该池集合随后为此请求提供池、流量引导策略、权重和回退池。
匹配单个数据中心的池集合不会自动优先于匹配某个区域的池集合。请将数组从最具体到最宽泛排序。
将默认池集合放在最后,方法是将 match.default 设置为 true。default 匹配会应用于每一个请求。由于池集合采用先匹配者胜出,此池集合会处理未匹配到更早池集合的请求:
{
"pool_sets": [
{
"name": "sjc-only",
"match": { "topology": { "pops": ["SJC"] } },
"overrides": { "pools": ["17b5962d775c646f3f9725cbc7a53df4"] }
},
{
"name": "default",
"match": { "default": true },
"overrides": { "pools": ["ff02c959d17f7bb2b1184a202e3c0af7"] }
}
]
}将 disabled 设置为 true 的池集合会被跳过。
match 对象决定池集合应用于哪些请求。设置 default 或 topology 之一——二者不能组合。完全没有 match 的池集合会应用于每一个请求。
| 字段 | 说明 |
|---|---|
default |
为 true 时匹配每一个请求。不能与 topology 组合。 |
topology |
按位置匹配。至少需要 pops、countries、regions 之一。 |
在 topology 中,每个字段接受位置代码列表:
| 字段 | 值 |
|---|---|
pops |
Cloudflare 数据中心代码,对照处理该请求的数据中心进行匹配 |
countries |
ISO 3166-1 alpha-2 国家/地区代码 |
regions |
Cloudflare 区域代码,例如 WNAM |
同一字段内的条目以 OR 组合。来自德国的请求会匹配 "countries": ["FR", "DE", "GB"]。
例如,此拓扑在全部三个字段中都设置了多个值:
{
"match": {
"topology": {
"pops": ["SJC", "IAD"],
"countries": ["US", "CA"],
"regions": ["WNAM", "ENAM"]
}
}
}当请求的数据中心为 SJC 或 IAD、国家/地区为 US 或 CA,并且 其区域层级包含 WNAM 或 ENAM 时,该请求才会匹配。
除非你明确需要这种 AND 行为,否则每个 topology 只设置一个字段。
如果 regions 条目出现在请求区域层级的任何位置,就会匹配,因此更宽泛的区域代码可以匹配来自更窄区域的请求。
国家/地区匹配使用为该请求解析出的位置。当无法解析客户端位置时,国家/地区匹配会回退到处理该请求的 Cloudflare 数据中心所在国家/地区。
overrides 对象保存匹配后应用的路由行为。其字段均为可选,但没有 fixed_response 的池集合必须设置 overrides.pools。
| 字段 | 说明 |
|---|---|
pools |
要路由到的池 ID。对此请求完全替换负载均衡器的池选择。 |
pool_weights |
按池权重,仅在此池集合内应用 |
pool_default_weight |
pools 中未在 pool_weights 出现的任何池的权重 |
fallback_pool |
此池集合的最后手段池。省略时使用负载均衡器的回退池。 |
steering_policy |
应用于 pools 的流量引导策略 |
pools 是扁平列表,而不是位置到池的映射。匹配到的池集合定义该请求的整组候选池。
池集合内支持这些流量引导策略:
| 策略 | 在池集合内的行为 |
|---|---|
off |
按故障转移顺序使用 pools |
random |
随机选择池,并遵守 pool_weights |
dynamic_latency |
选择往返时间最低的池 |
proximity |
按纬度和经度选择距请求最近的池 |
least_outstanding_requests |
按权重和未完成请求数选择池 |
least_connections |
按权重和打开连接数选择池 |
pool_weights 和 pool_default_weight 适用于 random、least_outstanding_requests 和 least_connections。这些权重与负载均衡器的 random_steering 权重相互独立,因此每个池集合可以独立为池加权。
省略 steering_policy 时,池集合使用故障转移顺序。
对于已代理的 zone 负载均衡器,池集合可以返回 fixed_response,而不是使用 overrides.pools。使用此选项可为匹配的位置返回 HTTP 状态或重定向:
{
"pool_sets": [
{
"name": "redirect-region",
"match": { "topology": { "countries": ["US"] } },
"fixed_response": {
"status_code": 302,
"location": "https://example.com/service-unavailable"
}
}
]
}不要将 fixed_response 与仅 DNS 负载均衡器一起使用。DNS 响应无法携带 HTTP 状态、正文或重定向字段。匹配的固定响应会返回 NOERROR 且没有记录。
池集合必须指定 overrides.pools 或 fixed_response。两者都没有的池集合会被拒绝,因为它会匹配流量却无处可发送。
池集合独立于标准流量引导字段。添加池集合不会读取或写入 default_pools、region_pools、country_pools、pop_pools、steering_policy、random_steering 或 fallback_pool,配置这些字段也不会创建池集合。
由于匹配到的池集合会替换该请求的池选择,标准字段对池集合已匹配的请求没有影响。未匹配任何池集合的请求会回落到你的标准流量引导配置。
即使你预期每个请求都会匹配某个池集合,每个负载均衡器仍必须设置 default_pools。它是未匹配任何池集合的请求的目标。
池集合在自定义规则之前评估。匹配到的池集合确立路由决策,然后自定义规则在其之上应用覆盖。
返回 fixed_response 的池集合就是完整响应,因此不会为该请求评估自定义规则。
国家/地区匹配取决于顶层流量引导策略和 location_strategy。配置了策略时,Geo 和 Proximity 引导可以使用 EDNS Client Subnet (ECS)、解析器 IP 地址或作出响应的 Cloudflare 数据中心。未配置策略时,Proximity 在可用时使用 ECS,而 Geo 使用作出响应的数据中心。其他顶层策略使用作出响应的数据中心。
池集合在评估其匹配之后应用 overrides.steering_policy。因此该覆盖无法更改用于国家/地区匹配的位置。更多信息请参阅 EDNS Client Subnet (ECS) 支持。
池集合受以下限制约束:
| 限制 | 值 |
|---|---|
| 每个负载均衡器的池集合数 | 1,000 |
name 中的字符数 |
200 |
每个 pops、countries 或 regions 列表的条目数 |
1,000 |
单个 pops、countries 或 regions 列表中的重复条目会被拒绝。
池集合通过 Update Load Balancer 端点上的 pool_sets 字段管理。发送 PATCH 请求时:
- 省略
pool_sets会保持现有池集合不变 - 发送
"pool_sets": []会移除所有池集合 - 发送
"pool_sets": null不会进行任何更改
使用此示例前,请先创建所引用的池。将每个示例池 ID 替换为你账户中的 ID。
此请求按权重将北美西部流量分流到两个池,并使用区域回退池。它对德国流量选择延迟最低的池。默认池集合处理其余所有流量。负载均衡器使用单独的全局回退池。
向 /zones/{zone_id}/load_balancers/{load_balancer_id} 发送带有以下正文的 PATCH 请求:
{
"fallback_pool": "6f1ed002ab5595859014ebf0951522d9",
"pool_sets": [
{
"name": "wnam-active-active",
"match": { "topology": { "regions": ["WNAM"] } },
"overrides": {
"pools": [
"17b5962d775c646f3f9725cbc7a53df4",
"9290f38c5d07c2e2f4df57b1f61d4196"
],
"pool_weights": {
"17b5962d775c646f3f9725cbc7a53df4": 0.5,
"9290f38c5d07c2e2f4df57b1f61d4196": 0.5
},
"steering_policy": "random",
"fallback_pool": "2a28d35d1c00f000540fe739a04b3230"
}
},
{
"name": "de-lowest-latency",
"match": { "topology": { "countries": ["DE"] } },
"overrides": {
"pools": [
"0930eec54a4c7ae6616985b79f678210",
"c8b4f5a6d7e84910a2b3c4d5e6f70819"
],
"steering_policy": "dynamic_latency"
}
},
{
"name": "default",
"match": { "default": true },
"overrides": {
"pools": ["ff02c959d17f7bb2b1184a202e3c0af7"],
"steering_policy": "off"
}
}
]
}请求完成后,负载均衡器使用此配置路由流量:
| 顺序 | 匹配 | 池 | 流量引导策略 | 回退池 |
|---|---|---|---|---|
| 1 | 北美西部 (WNAM) |
17b5962d775c646f3f9725cbc7a53df4、9290f38c5d07c2e2f4df57b1f61d4196 |
随机,各 50% | 2a28d35d1c00f000540fe739a04b3230 |
| 2 | 德国 (DE) |
0930eec54a4c7ae6616985b79f678210、c8b4f5a6d7e84910a2b3c4d5e6f70819 |
Dynamic Latency | 全局回退 |
| 3 | 其余所有流量 | ff02c959d17f7bb2b1184a202e3c0af7 |
故障转移顺序 | 全局回退 |
全局回退池为 6f1ed002ab5595859014ebf0951522d9。
无效的池集合配置会返回 HTTP 状态 400 和 API 错误代码 1002。错误消息会说明问题,并可能包含以下标识符之一:
| 消息标识符 | 原因 |
|---|---|
POOL_SETS_TOO_LARGE |
单个负载均衡器上的池集合超过 1,000 个 |
POOL_SET_NO_INTENT |
池集合既未指定 overrides.pools 也未指定 fixed_response |
POOL_SET_DEFAULT_WITH_MATCH |
match 将 default 与 topology 组合 |
POOL_SET_EMPTY_TOPOLOGY |
topology 未设置 pops、countries 或 regions 中的任何一个 |
POOL_SET_TOPOLOGY_TOO_LARGE |
topology 列表超过 1,000 个条目 |
POOL_SET_POP_ENTITLEMENT |
该账户无权使用数据中心引导 |
POOL_SET_REGION_ENTITLEMENT |
该账户无权使用区域引导 |
POOL_SET_COUNTRY_ENTITLEMENT |
该账户无权使用国家/地区引导 |