Skip to content

デプロイメントのライフサイクル ​

Edge の挙動のほとんどは、ふたつの考え方で説明できます。

distribution — URL を保持し、個々の deployment より長く存在するpendingバンドルをアップロード済みreadyプレビュー公開済みlive訪問者に配信中commit本番サイトは変わらないpromoteトラフィックが切り替わるPUT bundle.tar.gzrollbackプレビュー URL — 他の誰も知らないacme-marketing.edge.deca-dev.com
commit はプレビューを公開するだけで、本番サイトには触れません。トラフィックを切り替えるのは promote で、rollback がそれを取り消します。

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 からアクセスできる
livedistribution の公開 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 が何も起こしていないように見える場合、ほぼ確実にこれが原因です。

あわせて読む ​