リリースと公開停止を予約する
キャンペーンページ、セミナーの申込ページ、期間限定のオファーは、たいてい決まった時刻に公開し、そのあと取り下げる必要があります。そのために誰かが深夜 0 時に起きている必要はありません。Edge が両方を実行します。公開には promote を、終了には 公開停止(takedown) を予約します。
このページは、distribution が一度は公開されたことがある前提です。まだの場合は 最初のサイトを公開する から始めてください。以降、distribution は acme-spring-sale(d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38)とします。
どこで実行できるか
予約は ウェブコンソールでは実行できません。エージェント、CLI、または API を使ってください。
結果はコンソールで確認できます。Deployments ページ(https://app.edge.deca-dev.com/edge/{workspaceId}/deployments)で、どの deployment が公開されたかがわかります。
予約の動き
- タイミング:Edge は予約した時刻から約 1 分以内に実行します。その後、数秒で訪問者に反映されます。
- タイムゾーン:時刻はオフセット付きで指定します。たとえば東京の 0 時なら
2026-11-01T00:00:00+09:00です。オフセットのない時刻は推測せずに拒否します。CLI ではローカル時刻をそのまま渡せます。 - 指定できる時刻:予約は 60 秒以上先、366 日以内である必要があります。distribution あたりの未実行の予約は 20 件まで、1 分に 1 件までです。
- 予約の変更:予約は編集できません。取り消してから予約し直してください。
- 遅れた予約:Edge が予約に 24 時間以上遅れて到達した場合は実行しません。その予約は
missedで始まる理由とともにfailedになります。1 日ずれたリリースは、ほぼ必ず人の判断が必要だからです。
公開を予約する
キャンペーンを deployment として公開し、プレビューを確認してから promote を予約します。予約する時点では deployment がまだビルド中でもかまいませんが、予約の実行時には ready になっている必要があります。そうでなければ何も公開されず、予約は failed になります。
acme-spring-sale のデプロイメント 01M4T3KQ8Z6P2W9XRC1VJ5NB7D を
2026 年 11 月 1 日 0 時(日本時間)に公開するよう予約して。edge deployments promote 01M4T3KQ8Z6P2W9XRC1VJ5NB7D --at "2026-11-01 00:00" --tz Asia/Tokyocurl -s -X POST \
https://api.edge.deca-dev.com/v1/deployments/01M4T3KQ8Z6P2W9XRC1VJ5NB7D/promote \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "at": "2026-11-01T00:00:00+09:00" }'エージェントは at を付けて edge_deployment_promote を実行します。レスポンスは promote の結果ではなく、予約の内容です。この時点では公開中のサイトは何も変わりません。
{
"schedule_id": "sch_01M4T3PZ2E7Y0QW8H6KD1RJXCA",
"action": "promote",
"deployment_id": "01M4T3KQ8Z6P2W9XRC1VJ5NB7D",
"run_at": "2026-10-31T15:00:00+00:00",
"status": "scheduled",
"pending_schedules": [ … ]
}run_at は常に UTC で返ります。2026-10-31T15:00:00+00:00 は東京の 11 月 1 日 0 時です。
公開停止を予約する
キャンペーンが終わると、公開停止は訪問者に次のどちらかで応答します。
| モード | 訪問者が受け取るもの | 使う場面 |
|---|---|---|
redirect | 指定した URL への一時的なリダイレクト(302) | メインサイトなど、案内できる行き先がある |
gone | 410 Gone | ページをただなくしたい |
リダイレクト先は、この distribution、ワークスペースで検証済みの独自ドメイン、または distribution の redirect_hosts にあるホストのいずれかでなければなりません。これにより、公開停止が自分の管理していないサイトへのリダイレクトになるのを防ぎます。
セールが終わる 2026 年 11 月 30 日 23 時 59 分(日本時間)に acme-spring-sale を
公開停止して、訪問者を https://www.acme.example/ に送って。edge distributions takedown acme-spring-sale --redirect https://www.acme.example/ \
--at "2026-11-30 23:59" --tz Asia/Tokyocurl -s -X POST \
https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/takedown \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "mode": "redirect", "location": "https://www.acme.example/", "at": "2026-11-30T23:59:00+09:00" }'エージェントは edge_distribution_takedown を実行します。at(または --at)を省くと、すぐに公開停止します。
公開停止がすること、しないこと:
- 何も削除されません:deployment、ファイル、設定はそのまま残ります。
- プレビューは引き続き使えます:サイトの停止中に次のキャンペーンを準備できます。
- promote してもサイトは戻りません:公開停止のまま新しい内容を promote できますが、復元するまで訪問者には 410 またはリダイレクトが返ります。
サイトを戻す
復元(restore)は公開停止を解除します。すぐにでも、決めた時刻にでも実行できます。
acme-spring-sale をまた公開して。edge distributions restore acme-spring-salecurl -s -X POST \
https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/restore \
-H "Authorization: Bearer $EDGE_TOKEN"エージェントは edge_distribution_restore を実行します。数秒で、公開中のホストが再び公開中の deployment を配信します。公開停止していないサイトを復元しても何も変わらず、"changed": false が返ります。
予約を確認して取り消す
acme-spring-sale に何が予約されているか見せて。公開停止の予約は取り消して。edge schedules ls acme-spring-sale
edge schedules cancel sch_01M4T3QH5V1D8N3B6K0W2YFZTRcurl -s https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/schedules \
-H "Authorization: Bearer $EDGE_TOKEN"
curl -s -X DELETE https://api.edge.deca-dev.com/v1/schedules/sch_01M4T3QH5V1D8N3B6K0W2YFZTR \
-H "Authorization: Bearer $EDGE_TOKEN"エージェントは edge_deployment_schedule_list と edge_deployment_schedule_cancel を実行します。一覧は既定で未実行の予約を表示します。実行済み、失敗、取り消し済みの予約も見るには status=all(CLI では --status all)を指定します。取り消せるのは、まだ始まっていない予約だけです。
手動の promote は予約した promote を 取り消しません。22 時に修正版を promote しても、0 時に promote が予約されていれば、予約した deployment が 0 時に公開されます。どの promote のレスポンスにも pending_schedules が含まれるので、事前に気づけます。不要になった予約は取り消してください。
実行されたら通知を受け取る
各ステップは Edge のイベント を送ります。deployment.scheduled、続いて deployment.promoted(schedule_id 付き)、distribution.taken_down、distribution.restored です。実行できなかった予約は理由とともに deployment.schedule_failed を送ります。Slack や監視ツールでメッセージを受け取るには、Edge のイベントを Webhook に送る を参照してください。
次に読む
- パッチ、公開、切り戻し
- デプロイメントのライフサイクル:
pending、ready、公開中、公開停止の意味 - 制限