跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

池集合

最后更新 查看 MarkdownAgent 设置

池集合允许你将地理导向与其他流量引导策略结合使用。例如,你可以在特定区域或国家/地区内应用 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 的池集合就是完整响应,因此不会为该请求评估自定义规则。

仅 DNS 负载均衡器

国家/地区匹配取决于顶层流量引导策略和 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 列表中的重复条目会被拒绝。

通过 API 配置池集合

池集合通过 Update Load Balancer 端点上的 pool_sets 字段管理。发送 PATCH 请求时:

  • 省略 pool_sets 会保持现有池集合不变
  • 发送 "pool_sets": [] 会移除所有池集合
  • 发送 "pool_sets": null 不会进行任何更改

示例请求

使用此示例前,请先创建所引用的池。将每个示例池 ID 替换为你账户中的 ID。

此请求按权重将北美西部流量分流到两个池,并使用区域回退池。它对德国流量选择延迟最低的池。默认池集合处理其余所有流量。负载均衡器使用单独的全局回退池。

向 /zones/{zone_id}/load_balancers/{load_balancer_id} 发送带有以下正文的 PATCH 请求:

Requestjson
{
	"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 该账户无权使用国家/地区引导

这篇文档对您有帮助吗?