ロールアウト

ロールアウトは、1つの予定時刻を持つ、名前付きのレコードバージョンのまとまりです。その時刻に、各レコードの指定されたバージョンを公開するため、多数のレコードにまたがるキャンペーンがまとめて公開されます。

ロールアウトが保持するもの

ロールアウトには名前、予定時刻、レコードバージョンのリストがあります。時刻は必須で、ロールアウトがスケジュール済みの間は、名前、説明、時刻、項目を編集できます。

ロールアウトが扱うのはレコードのバージョンだけです。モデルと設定の変更はリリースで届けます。ロールアウトでは、先に出すスケジュール済みリリースを指定できます。そのリリースはロールアウトの時刻に、コンテンツより先に配信されます。拒否または失敗した場合、ロールアウトは理由付きで失敗とマークされ、コンテンツは1つも公開されません。

項目が失敗したとき

すべての項目は1つのデータベーストランザクション内で、項目ごとに独自のセーブポイントを持って実行されます。失敗した項目だけがロールバックされ、失敗として記録されます。他の項目は公開され、トランザクションのコミット時にまとめて見えるようになります。その後、ロールアウトは、すべての項目が成功すれば「完了」、一部が失敗すれば「一部完了」、すべて失敗すれば「失敗」と表示されます。

操作

スケジュール済みのロールアウトは、早めにトリガーしたり、一時停止して再開したりでき、トリガーされるまでは削除できます。リトライは失敗した項目だけを再実行します。ロールバックは各項目の以前に公開されたバージョンを再公開します。ロールバックは実行前にプレビューでき、以前に公開されたバージョンがない項目はプレビューで示されます。

管理する場所

ロールアウトは、コンソールのコンテンツ、スケジュール、ロールアウトで管理でき、CLIではfoir rollouts、またエージェントのツールからも管理できます。公開GraphQL APIでは管理できません。CIでは、CLIでファイルからロールアウトを作成するスケジュール済みジョブを使うのが、文書化されたパターンです。作成にはschedules:write権限が必要です。

詳細を読む

予約公開ガイドでは、ロールアウトの作成、ステータス、各ライフサイクルの操作を扱っています。