Skip to content

パッチ、公開、切り戻し ​

すでに公開中の 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 が公開中かを確認できます。

新しいバージョンを公開する ​

サイト全体を再ビルドする場合 ​

静的サイトジェネレータやバンドラーで全体が再生成される場合は、新しいアーカイブをアップロードします。

text
./dist を acme-marketing の distribution に新しい deployment として
公開して、プレビュー URL を教えて。promote はまだしないで。
bash
edge deploy ./dist --distribution d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38
bash
# 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 から分岐できます。

text
acme-marketing の公開中の deployment から新しい deployment を分岐して、
about.html の見出しを「チームについて」に変えて commit し、
プレビューを見せて。
bash
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
bash
# 公開中の 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 に問題があれば、前のものに戻せます。

text
acme-marketing を前の deployment に戻して。
bash
edge deployments rollback --distribution d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38
bash
curl -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 を比較する ​

text
公開中の deployment と、いま作ったものの差分を見せて。
bash
edge deployments diff 01M2QB6JJJS99B7B09VZJ8RST2 01M2QF4XK7T0N8MB2VD31HGA9C
bash
curl -s "https://api.edge.deca-dev.com/v1/deployments/01M2QB6JJJS99B7B09VZJ8RST2/diff/01M2QF4XK7T0N8MB2VD31HGA9C" \
  -H "Authorization: Bearer $EDGE_TOKEN"

エージェントは edge_deployment_diff を実行します。

キャッシュを消す ​

promote と切り戻しは、新しい公開 deployment に対してすでに /* 全体の無効化を要求します。公開中のコンテンツ deployment のパスに対してパージをやり直す必要があるときに、手動の無効化を使います。

text
acme-marketing のキャッシュを無効化して。
bash
edge distributions invalidate d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38 --path '/*'
bash
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 を予約します。キャンペーンが終わったときにサイトを公開停止することもできます。リリースと公開停止を予約する を参照してください。

次に読む ​