デプロイメントのライフサイクル
Edge の挙動のほとんどは、ふたつの考え方で説明できます。
distribution と deployment
distribution は継続的な存在としてのサイトです。名前、slug、設定、ドメインを持ちます。URL を保持し、人に伝えるのはこのアドレスで、コンテンツのどのバージョンよりも長く存在します。
deployment はそのサイトのファイルのひとつのバージョンです。distribution は寿命のあいだに多数の deployment を蓄積し、そのうち常にひとつだけが公開中になります。
この分離があるため、切り戻しは安価です。新しいものを promote したとき、前の deployment は削除されず、配信対象ではなくなっただけです。戻すのはポインタの変更であり、再ビルドではありません。
commit と promote が分かれている理由
公開はふたつの段階に分かれています。儀式的な手順ではなく、理由があります。
commit はアップロードされたバンドルをワーカーに渡します。ワーカーはそれを展開してファイルを公開し、その deployment 専用のプレビュー URL({deployment_id}.preview.edge.deca-dev.com)を用意します。完了すると status が ready、preview_published が true になります。
この時点で本番サイトは何も変わっていません。訪問者には引き続き前の deployment が配信されています。
promote が、本番のトラフィックを新しい deployment に切り替える手順です。
分けている理由は、失敗しやすく時間のかかる処理 — アーカイブの展開、ファイルの公開、ビルドが壊れていたと気づくこと — を、訪問者から見えない場所で終わらせるためです。promote する時点で deployment はすでにビルドされ配信されており、promote は「どちらを公開するか」を変えるだけです。
これはプレビューが近似ではなく実物であることも意味します。プレビュー URL は本番とまったく同じ方法で同じファイルを配信します。そこで正しく見えるなら、本番でも正しく見えます。
status の値
status | 意味 |
|---|---|
pending | 作成済み。バンドルまたは commit を待っている |
ready | 公開済みで、プレビュー URL からアクセスできる |
live | distribution の公開 URL を配信中 |
failed | 処理が完了しなかった。理由はレスポンスに含まれる |
promote は取り消せます
ready に到達した deployment はすべて公開されたままなので、そのあいだの移動は distribution がどれを指すかの問題でしかありません。rollback は以前の deployment を新しい deployment にコピーします。ファイルは公開済みのものがそのままコピーされ、ソースから再ビルドはされません。コピーが ready になると promote されます。CLI は両方の手順を行い、エージェントは復元した deployment を確認してから promote します。移動元の deployment も再度 promote できます。
設定も deployment と一緒に動きます。レスポンスヘッダーと リダイレクト は distribution に属しますが、その変更は新しい deployment として記録されます。訪問者に新しいヘッダーやリダイレクト表が届くのはその deployment を promote したときで、切り戻すと以前の deployment が持っていた表が戻ります。
promote が制御しないのはキャッシュです。新しい内容はすぐに公開されますが、エッジにキャッシュ済みのコピーが短時間だけ古いバージョンを返すことがあります。distribution を invalidate すれば消えます。
promote は時刻を決めて待たせられます
promote は、頼んだその時に実行する必要はありません。予約すると deployment と時刻が記録され、Edge はその時刻から約 1 分以内に promote します。誰もオンラインでいる必要はありません。時刻になると deployment をもう一度確認し、ready でなければ何も公開されず、予約は failed になります。リリースと公開停止を予約する を参照してください。
公開停止は削除ではありません
公開停止(takedown) は、distribution の公開中のアドレスで公開中の deployment を配信する代わりに、訪問者に 410 Gone または一時的なリダイレクトを返します。これは deployment ではなく distribution の設定なので、次のようになります。
- 何も削除されず、復元すると同じ公開中の deployment が戻ります。
- プレビューは引き続き使えます。
- 新しい deployment を promote しても解除されません。公開停止のまま次のキャンペーンを準備し、整ったら復元できます。
公開停止は 停止(suspension) とは異なります。停止は、不正利用や法的な要請に対してプラットフォームが distribution を止める仕組みです。403 を返し、自分で設定するものではありません。停止された distribution は、公開停止しているかどうかにかかわらず到達できないままです。
ふたつのインターフェースが同じ挙動になる理由
Edge はスクリプトを書く人と MCP ツールを呼ぶエージェントの両方から使われます。これはふたつの実装ではありません。各 HTTP ルートと対応する MCP ツールは、同じ権限チェックを伴う同じハンドラを呼びます。エージェントがサイトを公開するとき、その動作は curl の一連の呼び出しとまったく同じです。
これはエージェントを監督するときに重要です。エージェントにできることは、すべて自分で API から確認し、再現し、取り消せます。
知っておくべき落とし穴
distribution を作成すると、distribution と一緒に deployment id が返ります。この行は記録用です。ファイルもジョブもなく、commit しても意味のあることは起きません。
実際に扱うのは、deployment を明示的に作成したときに返るものです。commit が何も起こしていないように見える場合、ほぼ確実にこれが原因です。