跳转到内容
搜索文档

Cloudflare 版本管理

最后更新 查看 MarkdownAgent 设置

使用版本管理安全地测试、部署和回滚区域配置更改。

Enterprise-only

优势

通过使用版本管理,您可以:

  • 创建独立的版本进行更改,而不会影响实时流量。
  • 在部署到生产环境之前,安全地将更改部署到暂存环境。
  • 在出现问题时快速回滚已部署的更改。

可用性

FreeProBusinessEnterprise

Availability

No

No

No

Yes

如需访问,请在 Cloudflare 仪表板中启用区域版本控制(Zone Versioning)。

限制

版本管理(Version Management)目前不支持或仅有限支持以下产品或功能:

API Shield

  • 创建新的区域版本时,某些 API Shield 配置不会被克隆。
  • 允许客户选择移除阻止启用版本管理的 UI 阻拦。

Authenticated Origin Pull

缓存 (Cache)

  • Cache Reserve 仅适用于生产环境。
  • 清理(Purge)生产环境会清理所有环境。

与 Cloudflare Images 一起使用时的缓存规则

  • Image Resizing(图像缩放) 不适用于 additional_cacheable_ports 缓存规则设置和区域版本控制。
  • 如果您在 Image Resizing 中使用 additional_cacheable_ports,图像将在每次被请求时进行缩放,这会导致性能低下。

Workers Cache API

  • Workers Cache API 不适用于版本管理。
  • 如果您在区域版本控制中使用 Workers Cache API,可能会遇到意外的缓存行为。

中国网络

  • 无论部署到生产环境的版本是什么,中国境内的流量都将始终指向根区域。
  • 与 Access 和 ICP 备案的其他不兼容问题。

Cloudflare API

  • 版本管理环境(包括其路由表达式和版本分配)可以通过公共的 Environments API 进行管理。
  • 创建、克隆和编辑区域版本(配置快照本身)目前仅能通过 Cloudflare 仪表板进行。

域名级角色 (Domain-scoped Roles)

  • 域名级角色 仅适用于您的根区域。
  • 一旦创建了新版本,这些角色不会被复制,且会失去对版本的访问权限。

图像转换 (Image Transformations)

网络错误日志记录 (Network Error Logging)

客户端安全 (Client-side security)

规则 (Rules)

安全洞察 (Security Insights)

  • 启用区域版本控制且第一个版本部署到生产环境时,不会显示 Security Insights

Terraform

  • 版本管理目前不支持 Terraform
  • 客户应仅使用 Terraform 或仅使用版本管理。

WAF 攻击评分 (WAF Attack Score)

等候室 (Waiting Room)

  • 在网站上处于活动状态的 等候室 (Waiting Room) 用户可能会被重新放入队列中。
  • 在队列中的等候室用户可能会失去他们的排队位置。
  • 流量可能会超出限制。

Wrangler

  • 如果某个版本包含 Worker 路由,当通过 Wrangler 部署 Worker 时,该路由可能会消失。
  • 如果两个版本具有相同的自定义域名,Worker 可能会在这两者之间随机选择。

要求

要使用版本管理,必须满足以下所有条件:

  • 您的区域处于 Enterprise 计划。
  • 您的区域处于活动状态。
  • 您的区域使用 WAF 托管规则
  • 您的区域已迁移至使用自定义规则,而不是防火墙规则(已弃用)。
  • 您的账户使用 新版 WAF(如果没有,请联系您的客户团队)。
  • 您的用户账户必须具有超级管理员(Super Administrator)或管理员(Administrator)角色Zone Versioning(区域版本控制) 角色无法创建新版本。
  • 您的用户账户必须配置了 API 密钥(如果没有,请查看您的 API 密钥)。
  • 您的用户账户必须启用 API 访问权限。有关更多信息,请参考控制 API 访问权限
  • 您必须使用仪表板来管理版本控制。

这篇文档对您有帮助吗?