最初のサイトを公開する
このページを終えると、静的サイトが 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 は予約済みで、常に使用できません。
Edge で slug「acme-marketing」が使えるか確認して。edge distributions slug-check acme-marketingcurl -s https://api.edge.deca-dev.com/v1/slugs/acme-marketing \
-H "Authorization: Bearer $EDGE_TOKEN"どれでも結果は同じです。
{ "slug": "acme-marketing", "available": true }エージェントは edge_slug_check を実行します。確認しても予約はされないため、確認から作成までの間に他者が取得する可能性はあります。
2. distribution を作る
distribution はサイトそのものです。名前、設定、URL を持ち、ずっと残ります。deployment はその中で入れ替わっていきます。
slug「acme-marketing」で static-site テンプレートの
static distribution を Edge に作って。edge distributions create --slug acme-marketing --template static-sitecurl -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"
}'{
"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 はサイト内容のひとつのバージョンです。
acme-marketing の distribution に新しい deployment を作って、
./public の中身をアップロードして。edge link --distribution acme-marketing --dir public
edge deploy# 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 が返ります。
{
"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 すると、アップロードしたファイルがワーカーに渡され、展開されてプレビューが公開されます。本番サイトには影響しません。この時点ではまだ本番サイトは存在しません。
その deployment を commit して。# 手順 3 の edge deploy で済んでいます。手元で commit する場合:
edge deployments commit 01M2QB6JJJS99B7B09VZJ8RST2curl -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 になるまで待つ
ready になるまで待って、プレビュー URL を教えて。# edge deploy はすでに待機済みです。手元で確認する場合:
edge deployments get 01M2QB6JJJS99B7B09VZJ8RST2curl -s https://api.edge.deca-dev.com/v1/deployments/01M2QB6JJJS99B7B09VZJ8RST2 \
-H "Authorization: Bearer $EDGE_TOKEN"{
"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 する
プレビューを確認したので promote して。edge deployments promote 01M2QB6JJJS99B7B09VZJ8RST2curl -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。プレビューで確認してから本番に切り替えました。
次に読む
- CLI をインストールする — サインインしてターミナルから公開する
- デプロイメントのライフサイクル — commit と promote が分かれている理由
- エンドポイントを追加する —
/_apiで自分のコードを動かす、または データオブジェクトを配信する / バックエンドをプロキシする - 公開と切り戻し — 2 回目以降の公開と、その取り消し
- 独自ドメインを割り当てる — 自分のホスト名で配信する
- アナリティクスとコンバージョンを見る — 訪問者が次に何をするかを把握する
- コンテンツをアップロードする — インライン書き込み、バンドル、上限を超えるファイル
- 制限