Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

Cloudflare Version Management

最終更新 Markdown で表示Agent セットアップ

Version Management を使い、ゾーン設定の変更を安全にテスト、デプロイ、ロールバックします。

Enterprise のみ

メリット

Version Management を使うと、次のことができます。

  • 本番トラフィックに影響するリスクなく、変更用の独立したバージョンを作成できます。
  • 本番へのデプロイに先立ち、ステージング環境へ安全に変更をデプロイできます。
  • 問題が起きたときに、デプロイ済みの変更をすばやくロールバックできます。

提供状況

Free Pro Business Enterprise
提供状況 なし なし なし あり

利用するには、Cloudflare ダッシュボードで Zone Versioning を 有効 にします。

制限事項

Version Management は現時点で、次の製品または機能をサポートしていないか、サポートが限定されています。

API Shield

  • 新しいゾーンバージョンを作成するとき、一部の API Shield 設定はコピーされません。
  • Version Management の有効化を妨げる UI ブロックを解除するオプトインができます。

Authenticated Origin Pull

  • Authenticated Origin Pull は Zone Versioning では動作しません。
  • 許可リストに登録した IP からドメインにアクセスすると、Cloudflare の 520 エラーが返ります。

Cache

  • Cache Reserve は本番環境での利用を想定しています。
  • 本番環境をパージすると、すべての環境がパージされます。

Cloudflare Images と組み合わせた Cache Rules

  • Image Resizing は、additional_cacheable_portsCache Rule 設定および Zone Versioning では動作しません。
  • Image Resizing で additional_cacheable_ports を使うと、リクエストのたびに画像がリサイズされ、パフォーマンスが低下します。

Workers Cache API

  • Workers Cache API は Version Management では動作しません。
  • Zone Versioning で Workers Cache API を使うと、想定外のキャッシュ動作が発生することがあります。

China Network

  • 本番環境にデプロイしたバージョンに関係なく、中国のトラフィックは常にルートゾーンを対象にします。
  • Access および ICP ライセンスとのその他の非互換もあります。

Cloudflare API

  • Version Management の環境(ルーティング式とバージョン割り当てを含む)は、公開 Environments API で管理できます。
  • ゾーンバージョン(設定スナップショットそのもの)の作成、クローン、編集は、現時点では Cloudflare ダッシュボード からのみ利用できます。

Domain-scoped Roles

  • Domain-scoped Roles はルートゾーンにのみ適用されます。
  • 新しいバージョンを作成すると、これらのロールはコピーされず、バージョンへのアクセスを失います。

Image Transformations

  • Image Transformations に加えた変更は、新しいゾーンバージョンを作成するときにコピーされません。

Network Error Logging

  • Network Error Logging の設定は、新しいバージョンを作成するときにコピーされません。

Client-side security

  • Client-side security(旧称 Page Shield)はバージョニングでは利用できず、Global Configuration でのみ設定できます。

Rules

Security Insights

  • Zone Versioning を有効にし、最初のバージョンを本番環境にデプロイすると、Security Insights は表示されません。

Terraform

  • Version Management は現時点で Terraform をサポートしていません。
  • Terraform または Version Management のどちらか一方を使ってください。

WAF Attack Score

  • WAF Attack Score の設定は、新しいゾーンバージョンを作成するときにコピーされません。

Waiting Room

  • サイト上でアクティブな Waiting Room ユーザーが、キューに戻されることがあります。
  • キュー内の Waiting Room ユーザーは、順番を失うことがあります。
  • トラフィックが制限を超えることがあります。

Wrangler

  • バージョンに Worker ルートがある場合、Wrangler で Worker をデプロイすると、そのルートが消えることがあります。
  • 2 つのバージョンが同じカスタムドメインを持つ場合、Worker はランダムにどちらかを選ぶことがあります。

要件

Version Management を使うには、次のすべてを満たす必要があります。

  • ゾーンが Enterprise プランである。
  • ゾーンが アクティブ な状態である。
  • ゾーンが WAF マネージドルール を使っている。
  • ゾーンが、非推奨の Firewall Rules ではなく カスタムルール へ移行済みである。
  • アカウントが 新しい WAF を使っている(そうでない場合は、アカウントチームにお問い合わせください)。
  • ユーザーアカウントに Super Administrator または Administrator の ロール がある。Zone Versioning ロールでは新しいバージョンを作成できません。
  • ユーザーアカウントに API Key が用意されている(ない場合は、API Key を確認 します)。
  • ユーザーアカウントで API Access が有効である。詳細は API Access を制御する を参照してください。
  • バージョニングの管理にはダッシュボードを使う必要があります。

役に立ちましたか?