独自ドメインを割り当てる
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. ドメインを登録する
www.example.com を Edge に登録して、必要な DNS レコードを教えて。edge api POST /v1/domains --input - <<'EOF'
{ "fqdn": "www.example.com" }
EOFcurl -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. 検証する
DNS レコードを追加したので www.example.com を検証して。edge api POST /v1/domains/www.example.com/verifycurl -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 に割り当てる
www.example.com を acme-marketing の distribution に割り当てて。edge api POST /v1/domains/www.example.com/attach --input - <<'EOF'
{ "distribution_id": "d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38" }
EOFcurl -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 になるまで待つ
www.example.com が active になるまで待って、配信開始したら教えて。edge api GET /v1/domains/www.example.comcurl -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
割り当て解除と削除
ドメインの登録を残したまま配信を止めるには次のようにします。
www.example.com を distribution から外して。登録は残して。edge api POST /v1/domains/www.example.com/detachcurl -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 が返ります。ループで再試行せず待ってください。制限 を参照してください。
次に読む
- パッチ、公開、切り戻し
- エラー — 各ステータスコードの意味