Skip to content

最初のサイトを公開する ​

このページを終えると、静的サイトが your-slug.edge.deca-dev.com で公開され、 訪問者が見る前にプレビュー URL で確認できている状態になります。この環境のホストは 環境とドメイン にまとめています。

作業の進め方は三つあり、各手順で示します。

  • エージェントに任せる — やりたいことを伝えると、コーディングエージェントや DECA Agent が MCP ツールを呼び出します。ほとんどのサイトはこの方法で公開されています。
  • CLI を使う — ターミナルで edge を実行します。初回は CLI をインストールする で入れてください。
  • API を呼ぶ — スクリプトやターミナルから自分で HTTP リクエストを送ります。

どれも同じ操作です。各 MCP ツールと対応する HTTP ルートは同じハンドラと同じ権限チェックを通り、CLI はそのルートを代わりに呼ぶため、途中で切り替えても構いません。

事前に必要なもの ​

エージェントを使う場合は、エージェントが Edge の MCP サーバーに接続済みである必要があります。まだの場合は エージェントを接続する を先にどうぞ。CLI を使う場合は edge がインストール済みで、edge login でサインイン済みである必要があります。自分で API を呼ぶ場合は https://api.edge.deca-dev.com 向けのベアラートークンが必要です。

組織はトークンから決まり、こちらから渡すことはありません。複数のワークスペースに所属している場合は指定できます。指定しなければ組織の default ワークスペースが使われます。

公開するファイル群も必要です。直下に index.html があるフォルダを想定し、ここでは ./public とします。

1. 名前を決める ​

slug が URL になります。まず空いているか確認してください。mcp、api、www、preview、ip は予約済みで、常に使用できません。

text
Edge で slug「acme-marketing」が使えるか確認して。
bash
edge distributions slug-check acme-marketing
bash
curl -s https://api.edge.deca-dev.com/v1/slugs/acme-marketing \
  -H "Authorization: Bearer $EDGE_TOKEN"

どれでも結果は同じです。

json
{ "slug": "acme-marketing", "available": true }

エージェントは edge_slug_check を実行します。確認しても予約はされないため、確認から作成までの間に他者が取得する可能性はあります。

2. distribution を作る ​

distribution はサイトそのものです。名前、設定、URL を持ち、ずっと残ります。deployment はその中で入れ替わっていきます。

text
slug「acme-marketing」で static-site テンプレートの
static distribution を Edge に作って。
bash
edge distributions create --slug acme-marketing --template static-site
bash
curl -s -X POST https://api.edge.deca-dev.com/v1/distributions \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "slug": "acme-marketing",
        "distribution_type": "static",
        "template": "static-site"
      }'
json
{
  "id": "d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38",
  "slug": "acme-marketing",
  "live_deployment_id": null,
  …
}

static-site は通常の HTML ページ向けのテンプレートです。ほかに embed-script と strict-security があります。新しい distribution の種類は、別の値を指定しない限り site です。distribution の種類 を参照してください。エージェントは edge_distribution_create を実行します。

この id は以降すべてで使います。エージェントに任せている場合は内部で保持されるので、必要なら聞いてください。

レスポンスに含まれる deployment id は無視してください

distribution を作成すると、記録用の deployment 行が作られます。ファイルは添付されておらず、ジョブも登録されません。これを commit しても何も起きず、原因がわかりにくいだけです。実際に使うのは次の手順で作成する deployment です。

まともなエージェントはこの点を理解しています。もし誤った id を commit して何も起きない場合は、これが原因です。

3. deployment を作ってファイルをアップロードする ​

deployment はサイト内容のひとつのバージョンです。

text
acme-marketing の distribution に新しい deployment を作って、
./public の中身をアップロードして。
bash
edge link --distribution acme-marketing --dir public
edge deploy
bash
# 1. deployment を作る
curl -s -X POST \
  https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/deployments \
  -H "Authorization: Bearer $EDGE_TOKEN"

# 2. フォルダの「中」からアーカイブを作り、アップロードする
COPYFILE_DISABLE=1 tar -czf ../bundle.tar.gz -C ./public .
curl -s -X PUT --upload-file ../bundle.tar.gz "$UPLOAD_URL"

deployment を作ると、その id と署名付きの upload_url が返ります。

json
{
  "id": "01M2QB6JJJS99B7B09VZJ8RST2",
  "status": "pending",
  "upload_url": "https://deca-edge-uploads-….s3.ap-northeast-1.amazonaws.com/…?X-Amz-Algorithm=AWS4-HMAC-SHA256&…"
}

エージェントは edge_deployment_create を実行し、その URL にアーカイブを PUT します。CLI の edge deploy はフォルダを固め、deployment を作り、アップロードし、commit し、プレビューが ready になるまで待ちます。CLI を使う場合は、下の commit と待機の手順を省略できます。URL は S3 を指し、有効期限は 1 時間です。MCP サーバーの前段にあるファイアウォールは、このアップロードを検査しません。サイズの上限と、インライン書き込みに入らないファイルの扱いは コンテンツをアップロードする にあります。

gzip 圧縮した tar で、ファイルはアーカイブ直下に

Edge が読むのは .tar.gz だけです。.zip はアップロード自体は成功し、そのあとの処理で失敗します。またアーカイブ直下がサイトのファイルである必要があります。index.html が public/ の下ではなく最上位にある状態です。-C ./public . はそのための指定です。edge deploy はこのアーカイブを自動で作ります。

4. commit する ​

commit すると、アップロードしたファイルがワーカーに渡され、展開されてプレビューが公開されます。本番サイトには影響しません。この時点ではまだ本番サイトは存在しません。

text
その deployment を commit して。
bash
# 手順 3 の edge deploy で済んでいます。手元で commit する場合:
edge deployments commit 01M2QB6JJJS99B7B09VZJ8RST2
bash
curl -s -X POST \
  https://api.edge.deca-dev.com/v1/deployments/01M2QB6JJJS99B7B09VZJ8RST2/commit \
  -H "Authorization: Bearer $EDGE_TOKEN"

手順 2 ではなく手順 3 の deployment id を使ってください。エージェントは edge_deployment_commit を実行します。

5. ready になるまで待つ ​

text
ready になるまで待って、プレビュー URL を教えて。
bash
# edge deploy はすでに待機済みです。手元で確認する場合:
edge deployments get 01M2QB6JJJS99B7B09VZJ8RST2
bash
curl -s https://api.edge.deca-dev.com/v1/deployments/01M2QB6JJJS99B7B09VZJ8RST2 \
  -H "Authorization: Bearer $EDGE_TOKEN"
json
{
  "id": "01M2QB6JJJS99B7B09VZJ8RST2",
  "status": "ready",
  "preview_published": true,
  "preview_url": "https://01m2qb6jjjs99b7b09vzj8rst2.preview.edge.deca-dev.com"
}

status が ready、preview_published が true になるまで待ちます。status が failed になった場合は理由がレスポンスに含まれます。アーカイブを直して手順 3 からやり直してください。エージェントは edge_deployment_get を実行します。

コンソールの Deployments ページ(https://app.edge.deca-dev.com/edge/{workspaceId}/deployments)でも確認できます。

プレビューは少し待ってください

preview_published: true はプレビューのポインタが書き込まれたという意味で、すべてのエッジロケーションに反映済みという意味ではありません。最初の数秒はプレビュー URL が 404 を返すことがあり、ページごとに反映のタイミングが少しずれることもあります。その場合は commit をやり直さず、待ってから再読み込みしてください。deployment 自体に問題はありません。

6. プレビューを確認する ​

preview_url をブラウザで開きます。本番とまったく同じ配信方法で、誰も知らない URL 上に自分のサイトが表示されます。

ここはきちんと確認してください。この手順があるから、本番への切り替えが安全になります。そしてここは、エージェントが代わりにできない唯一の手順です。

7. promote する ​

text
プレビューを確認したので promote して。
bash
edge deployments promote 01M2QB6JJJS99B7B09VZJ8RST2
bash
curl -s -X POST \
  https://api.edge.deca-dev.com/v1/deployments/01M2QB6JJJS99B7B09VZJ8RST2/promote \
  -H "Authorization: Bearer $EDGE_TOKEN"

これが本番のトラフィックを切り替える手順です。サイトは https://acme-marketing.edge.deca-dev.com で公開されました。エージェントは edge_deployment_promote を実行します。

問題があれば前の deployment に戻せます。公開と切り戻し を参照してください。

できあがったもの ​

  • distribution acme-marketing。URL を保持し、個々の deployment より長く存在します。
  • その中の deployment。プレビューで確認してから本番に切り替えました。

次に読む ​