概要

バージョン管理を使用して、ゾーン設定の変更を安全にテスト、デプロイ、およびロールバックします。

Enterprise-only

利点

バージョン管理を使用することで、次のことが可能になります：

• ライブトラフィックに影響を与えるリスクなしに変更を行うための独立したバージョンを作成できます。
• 本番環境にデプロイする前に、ステージング環境に安全に変更をデプロイできます。
• 問題が発生した場合に、デプロイされた変更を迅速にロールバックできます。

利用可能性

	Free	Pro	Business	Enterprise
Availability	No	No	No	Yes

アクセスするには、Cloudflareダッシュボードでゾーンバージョニングを有効にしてください。

制限事項

Version Management does not currently support or have limited support for the following products or features:

API Shield

• Some API Shield configurations are not cloned when a new zone version is created.
• Customers are allowed to opt-in to remove the UI block that prevents enabling Version Management.

Authenticated Origin Pull

• Authenticated Origin Pull does not work with Zone Versioning.
• Accessing your domain from an allowlisted IP returns a Cloudflare 520 error.

Cache

• Cache configurations are versioned, but cache keys are not.
• Caching a new URL on staging would cache it for production as well.
• Purging cache on staging would purge it on production too.
• Promoting a new version to production would wipe all exiting cache.

Cache Rules when used with Cloudflare Images

• Image Resizing does not work with the additional_cacheable_ports Cache Rule setting and Zone Versioning.
• If you use additional_cacheable_ports with Image Resizing, the image will be resized every time it is requested and will result in low performance.

Workers Cache API

• Workers Cache API does not work with Version Management.
• If you use the Workers Cache API with Zone Versioning, you might encounter unexpected caching behaviours.

China Network

• Regardless of the version deployed to production, traffic in China will always target the root zone.
• Other incompatibility issues with Access and ICP licenses.

Cloudflare API

• Zone Version Management does not currently expose a public API.
• Customers can only use Version Management through the Cloudflare dashboard ↗.

Domain-scoped Roles

• Domain-scoped Roles apply only to your root zone.
• Once a new version is created, these roles do not copy over and they lose access to versions.

Image Transformations

• Changes made to Image Transformations are not cloned when a new zone version is created.

Network Error Logging

• Network Error Logging configurations are not cloned when a new version is created.

Page Shield

• Page Shield is not available for versioning and is only configurable under your Global Configuration.

Security Insights

• Security Insights are not shown when Zone Versioning is enabled and the first version is deployed to production.

Terraform

• Zone Version Management does not currently support Terraform.
• Customers should either use Terraform or Version Management.

WAF Attack Score

• WAF Attack Score configurations are not cloned when a new zone version is created.

Waiting Room

• Waiting Room users active on the site may be placed back in the queue.
• Waiting Room users in the queue may lose their place in line.
• Traffic may exceed limits.

Wrangler

• If a version has a Worker route, it might disappear when a Worker is deployed via Wrangler.
• If two versions have the same custom domains, the Worker might randomly choose between them.

要件

バージョン管理を使用するには、次のすべてが真である必要があります：

• あなたのゾーンはエンタープライズプランにあります。
• あなたのゾーンはアクティブな状態です。
• あなたのゾーンはWAF管理ルールを使用しています。
• あなたのゾーンはファイアウォールルール（廃止）ではなくカスタムルールを使用するように移行されています。
• あなたのアカウントは新しいWAF ↗を使用しています（使用していない場合は、アカウントチームに連絡してください）。
• あなたのユーザーアカウントにはAPIキーがプロビジョニングされている必要があります（ない場合は、APIキーを表示してください）。
• あなたのユーザーアカウントにはAPIアクセスが有効になっている必要があります。詳細については、APIアクセスを制御するを参照してください。
• バージョニングを管理するためにダッシュボードを使用する必要があります。