Skip to content

コンテンツをアップロードする ​

deployment にファイルを置く方法は 2 つあります。どちらも本番サイトは変えません。 commit はプレビューを公開し、promote が本番のトラフィックを切り替えます。distribution が まだない場合は、最初のサイトを公開する から始めてください。

数値は 制限 にあります。

どこで行うか ​

アップロードは Web コンソールではできません。コンソールは deployment の一覧で、どれが 本番かを確認する場所です。エージェント、CLI、または API を使います。

テキストをインラインで書く ​

すべてのファイルがテキストで、各ファイルが 100,000 バイト以下で、既にある deployment を 修正するときに使います。

text
acme-marketing の本番 deployment から新しい deployment を分岐して、
新しい about.html を書いて。バンドルはアップロードしないで。まだ promote しないで。
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
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" }'

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>…" }] }'

エージェントは from_deployment 付きで edge_deployment_create を実行し、続けて edge_content_write を実行します。API は PUT /v1/deployments/{id}/content です。

一部のファイルが入りきらなくても、呼び出し自体は成功します。results の各項目は written または error です。既に書き込まれた項目はそのまま残ります。

  • call total exceeds 2000000 bytes で、失敗したファイル自体が 100,000 バイト未満: 失敗したパスだけを、より小さい呼び出しで送り直す。
  • object exceeds 100000 bytes、または 1 ファイルだけで呼び出し合計のエラーが返る: そこで止める。そのファイルはここには書けず、呼び出しを分割しても書けない。 バンドルでアップロードする。バイナリも同じです。

バンドルをアップロードする ​

初回の公開、全体の再ビルド、バイナリ、インライン上限を超えるファイルに使います。 アーカイブは新しいファイルだけではなく、サイト全体です。from_deployment は付けません。

text
acme-marketing に、本番から分岐しない新しい deployment を作って、
./dist を gzip tar でアップロードし、プレビュー URL を教えて。
まだ promote しないで。
bash
edge deploy ./dist --distribution d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38
bash
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"

deployment を開くと upload_url が返ります。エージェントは edge_deployment_create を 実行し、その URL にアーカイブを PUT します。URL は S3 のアドレスで、有効期限は 1 時間 (3,600 秒)です。期限が切れたら、別の deployment を開きます。古い URL は再利用しません。

gzip tar をそのまま PUT します。Content-Type は付けず、暗号化ヘッダーも送りません。 アーカイブは .tar.gz だけで、.zip は不可です。サイトのファイルは直下に置きます (index.html は dist/ の下ではなく最上位)。-C ./dist . がその指定です。

PUT は S3 に直接届きます。MCP サーバーも HTTP API も経由しないので、それらの前段にある ファイアウォールはこのファイルを検査しません。100,000 バイトと 2 MB のインライン上限も この PUT には適用されません。S3 は 5 GiB を超える単一の PUT を拒否します。この URL に マルチパートアップロードはありません。

commit はそのあと、アーカイブ全体をメモリに読み込みます。S3 が受け取ったアップロードでも、 アーカイブが非常に大きいと commit で失敗することがあります。その場合はアーカイブを小さくして、 新しい deployment からやり直します。

分岐した deployment はアップロードを無視する ​

from_deployment を付けて開いた deployment では、ワーカーは前の deployment をコピーし、 インラインの書き込みを適用します。PUT が 200 を返しても upload_url は読みません。 バイナリや上限を超えたファイルは、from_deployment なしで deployment を開き、 完全なアーカイブをアップロードします。

commit してから promote する ​

commit は本番サイトを変えません。deployment が ready になりプレビューが公開されるまで 待ち、プレビューを見てから promote します。commit 以降の手順は 最初のサイトを公開する と同じです。promote と切り戻しは 修正、公開、切り戻し にあります。

あわせて読む ​