パッチ、公開、切り戻し
すでに公開中の distribution があることを前提とします。まだの場合は 最初のサイトを公開する から始めてください。
以降、distribution は d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38 とします。各手順でエージェントに頼む場合、CLI を使う場合、API を呼ぶ場合を示します。
どこで実行できるか
promote と切り戻しは ウェブコンソールでは実行できません。コンソールは distribution、deployment、ドメイン、アナリティクス、リクエストログを表示しますが、これらの操作は行えません。エージェント、CLI、または API を使ってください。
結果の 確認 にはコンソールが適しています。Deployments ページ(https://app.edge.deca-dev.com/edge/{workspaceId}/deployments)で、どの deployment が公開中かを確認できます。
新しいバージョンを公開する
サイト全体を再ビルドする場合
静的サイトジェネレータやバンドラーで全体が再生成される場合は、新しいアーカイブをアップロードします。
./dist を acme-marketing の distribution に新しい deployment として
公開して、プレビュー URL を教えて。promote はまだしないで。edge deploy ./dist --distribution d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38# deployment を開き、アップロード、commit、ポーリング、その後 promote
curl -s -X POST \
https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/deployments \
-H "Authorization: Bearer $EDGE_TOKEN"
COPYFILE_DISABLE=1 tar -czf ../bundle.tar.gz -C ./dist .
curl -s -X PUT --upload-file ../bundle.tar.gz "$UPLOAD_URL"
curl -s -X POST https://api.edge.deca-dev.com/v1/deployments/$DEPLOYMENT_ID/commit \
-H "Authorization: Bearer $EDGE_TOKEN"そのあとプレビューを確認し、チュートリアルの手順 7 と同じように promote します。
エージェントには promote しないで と明示的に伝える価値があります。promote は公開内容を切り替える操作であり、ひとつの指示のついでに実行されるのではなく、自分がプレビューを確認したあとに行われるべきだからです。
数ファイルだけ変更する場合
テキストファイルを少し直すだけなら、全体を再アップロードせず、公開中の deployment から分岐できます。
acme-marketing の公開中の deployment から新しい deployment を分岐して、
about.html の見出しを「チームについて」に変えて commit し、
プレビューを見せて。edge deployments create --distribution d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38 --from 01M2QB6JJJS99B7B09VZJ8RST2
# then write onto the new pending deployment id:
edge api PUT /v1/deployments/01M2QF4XK7T0N8MB2VD31HGA9C/content --input - <<'EOF'
{ "objects": [{ "path": "about.html", "content": "<!doctype html>…" }] }
EOF# 公開中の deployment から分岐する
curl -s -X POST \
https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/deployments \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "from_deployment": "01M2QB6JJJS99B7B09VZJ8RST2" }'
# 新しい pending deployment に変更したファイルだけ書き込む
curl -s -X PUT \
https://api.edge.deca-dev.com/v1/deployments/01M2QF4XK7T0N8MB2VD31HGA9C/content \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "objects": [{ "path": "about.html", "content": "<!doctype html>…" }] }'分岐した deployment には tarball を アップロードしないでください。commit し、プレビューを確認して promote します。ワーカーが元の deployment からすべてをコピーし、その上に書き込みを適用します。
この方法はエージェントとの相性が特に良く、ローカルにソースツリーがなくても、公開中のファイルを読んで編集し、書き戻せます。
変更前に公開中の内容を確認するには、公開中の deployment のファイルを読んでください。edge_content_list と edge_content_get、または GET /v1/deployments/{id}/content です。これらが返すのは公開済みのファイルであり、元のアーカイブの中身ではありません。
インラインでの書き込みは 1 ファイルあたり 100,000 バイト、1 回の呼び出し全体で 2 MB までです。それを超えるファイルやバイナリは、from_deployment なしで開いた deployment に完全なバンドルとして入れます。コンテンツをアップロードする と 制限 を参照してください。
切り戻す
promote した deployment に問題があれば、前のものに戻せます。
acme-marketing を前の deployment に戻して。edge deployments rollback --distribution d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38curl -s -X POST \
https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/rollback \
-H "Authorization: Bearer $EDGE_TOKEN"切り戻しは、以前の deployment の公開済みファイルを新しい deployment にコピーします。ソースからの再ビルドは発生せず、何も失われません。切り戻す前の deployment もそのまま残り、再度 promote できます。CLI はコピーが ready になるのを待って promote します。エージェントは edge_deployment_rollback を実行し、復元した deployment が ready になるのを待ってから、その deployment に edge_deployment_promote を実行します。API も同じで、切り戻しが返す deployment_id に POST /v1/deployments/{id}/promote を呼びます。
事前にふたつの deployment を比較する
公開中の deployment と、いま作ったものの差分を見せて。edge deployments diff 01M2QB6JJJS99B7B09VZJ8RST2 01M2QF4XK7T0N8MB2VD31HGA9Ccurl -s "https://api.edge.deca-dev.com/v1/deployments/01M2QB6JJJS99B7B09VZJ8RST2/diff/01M2QF4XK7T0N8MB2VD31HGA9C" \
-H "Authorization: Bearer $EDGE_TOKEN"エージェントは edge_deployment_diff を実行します。
キャッシュを消す
promote と切り戻しは、新しい公開 deployment に対してすでに /* 全体の無効化を要求します。公開中のコンテンツ deployment のパスに対してパージをやり直す必要があるときに、手動の無効化を使います。
acme-marketing のキャッシュを無効化して。edge distributions invalidate d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38 --path '/*'curl -s -X POST \
https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/invalidate \
-H "Authorization: Bearer $EDGE_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "paths": ["/*"] }'エージェントは edge_distribution_invalidate を実行します。パスは / で始まるビューアパスです。Edge はそれらを、いま公開中の deployment プレフィックスに変換します。無効化はファイルも設定も変えません。
あとで promote する
deployment をいまではなく決めた時刻に公開するには、promote を予約します。キャンペーンが終わったときにサイトを公開停止することもできます。リリースと公開停止を予約する を参照してください。
次に読む
- リリースと公開停止を予約する
- デプロイメントのライフサイクル —
pending、ready、公開中の意味 - 独自ドメインを割り当てる
- 制限