Skip to content

独自ドメインを割り当てる ​

distribution は公開された時点で your-slug.edge.deca-dev.com からアクセスできます。このページでは、www.example.com のような所有ドメインで配信する方法を説明します。

各手順でエージェントに頼む場合、CLI を使う場合、API を呼ぶ場合を示します。途中の DNS レコード作成だけは、どちらの場合も自分で行う必要があります。エージェントは DNS プロバイダーを操作できません。

事前に必要なもの ​

対象ドメインの DNS レコードを追加できる必要があります。

ドメインは ウェブコンソールからは管理できません。Domains ページ(https://app.edge.deca-dev.com/edge/{workspaceId}/domains)は一覧と状態を表示するため作業中の確認には役立ちますが、操作は API のみです。

1. ドメインを登録する ​

text
www.example.com を Edge に登録して、必要な DNS レコードを教えて。
bash
edge api POST /v1/domains --input - <<'EOF'
{ "fqdn": "www.example.com" }
EOF
bash
curl -s -X POST https://api.edge.deca-dev.com/v1/domains \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "fqdn": "www.example.com" }'

レスポンスに、作成すべき DNS レコードが含まれます。所有権を証明する TXT レコードもここに含まれます。

エージェント相当: edge_domain_create

2. DNS レコードを作成する ​

DNS プロバイダーで、手順 1 の TXT レコードと、指定された A/AAAA または CNAME レコードを Edge 向けに追加します。

次に進む前に反映を待ってください。検証は実際の DNS 応答を見るため、未反映のレコードは存在しないものとして扱われます。

3. 検証する ​

text
DNS レコードを追加したので www.example.com を検証して。
bash
edge api POST /v1/domains/www.example.com/verify
bash
curl -s -X POST https://api.edge.deca-dev.com/v1/domains/www.example.com/verify \
  -H "Authorization: Bearer $EDGE_TOKEN"

失敗する場合は TXT レコードがまだ見えていません。ドメインを作り直さず、待ってから再試行してください。

エージェント相当: edge_domain_verify

4. distribution に割り当てる ​

text
www.example.com を acme-marketing の distribution に割り当てて。
bash
edge api POST /v1/domains/www.example.com/attach --input - <<'EOF'
{ "distribution_id": "d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38" }
EOF
bash
curl -s -X POST https://api.edge.deca-dev.com/v1/domains/www.example.com/attach \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "distribution_id": "d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38" }'

割り当てには検証済みである必要があります。未検証のまま割り当てると 409 が返ります。

エージェント相当: edge_domain_attach

5. active になるまで待つ ​

text
www.example.com が active になるまで待って、配信開始したら教えて。
bash
edge api GET /v1/domains/www.example.com
bash
curl -s https://api.edge.deca-dev.com/v1/domains/www.example.com \
  -H "Authorization: Bearer $EDGE_TOKEN"

status が active になるまで待ちます。この間に証明書が発行されるため、即座には完了しません。status が failed になった場合は理由がレスポンスに含まれます。

active になると https://www.example.com で配信されます。your-slug.edge.deca-dev.com も引き続き利用できます。

エージェント相当: edge_domain_get

割り当て解除と削除 ​

ドメインの登録を残したまま配信を止めるには次のようにします。

text
www.example.com を distribution から外して。登録は残して。
bash
edge api POST /v1/domains/www.example.com/detach
bash
curl -s -X POST https://api.edge.deca-dev.com/v1/domains/www.example.com/detach \
  -H "Authorization: Bearer $EDGE_TOKEN"

完全に削除するには DELETE /v1/domains/www.example.com を呼び、ボディの confirm_fqdn に同じ FQDN を入れます。この確認は意図的なものです。ドメインの削除は公開中のホスト名を停止させます。

つまずきやすい点 ​

  • プレビュー URL では独自ドメインは使われません。 deployment のプレビューは、distribution にどのドメインが割り当てられていても常に *.preview.edge.deca-dev.com です。
  • 検証は一度きりの証明ではありません。 TXT レコードは残しておいてください。
  • ドメイン作成にはレート制限があります。 ワークスペースあたり 1 時間に 10 件までで、1 つの distribution に割り当てられるドメインは 10 件までです。超過すると 429 が返ります。ループで再試行せず待ってください。制限 を参照してください。

次に読む ​