Skip to content

他のホスティングからリダイレクトを移行する ​

サイトを Edge に移すときは、古い URL が引き続き使える必要があります。検索エンジンや古いリンクからの訪問者が 404 ではなく新しいページに着くようにします。このページでは、リダイレクトの一覧をまとめてインポートし、確認してから公開します。

以降、distribution は acme-marketing(d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38)とし、移行元のホスティングはルールを redirects.csv に書き出したものとします。

csv
from,to,status
/pricing-2025,/pricing,302
/about-us,/about,302
/blog/*,/news/:splat,302

Edge は Netlify の _redirects ファイルと JSON も読めます。正確な形式は リダイレクト にあります。

どこで実行できるか ​

リダイレクトのインポートは ウェブコンソールでは実行できません。エージェント、CLI、または API を使ってください。

1. ファイルを確認する ​

インポートは、指定しない限りドライランです。何も変更せず、次のことを報告します。

  • 追加、変更、削除されるルール
  • 行番号付きのすべてのエラー
  • ループと長いリダイレクトチェーン
  • 許可されていない外部の転送先
text
redirects.csv を acme-marketing へのリダイレクトのインポートとして確認して。
まだ適用しないで、エラーと警告を見せて。
bash
edge redirects import acme-marketing redirects.csv
bash
curl -s -X POST \
  https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/redirects/import \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --rawfile source redirects.csv '{source: $source, format: "csv"}')"

エージェントは dry_run を true のまま edge_redirect_import を実行します。レポートは次のようになります。

json
{
  "dry_run": true,
  "valid": true,
  "parsed": 3,
  "rule_count": 3,
  "added": [ { "from": "/pricing-2025", "to": "/pricing", "status": 302 }, … ],
  "changed": [],
  "removed": [],
  "errors": [],
  "warnings": [],
  "kvs_bytes": 212
}

errors の項目はすべてファイル側で直し、もう一度確認してください。よくあるもの:

エラー直し方
line 7: from must be a path starting with /移行元が完全な URL を書き出しています。パスだけを残します。
redirect loop: /a -> /b -> /aふたつのルールが互いを指しています。片方を削除します。
shop.acme.example is not this distribution, …そのドメインを割り当てるか検証するか、distribution の redirect_hosts に追加します。
status 200: rewrites (200) and custom error pages are not supportedEdge はリダイレクトだけを扱います。その行を削除します。

上のファイルは 302 を使っているので、確認しているあいだブラウザはリダイレクトをキャッシュしません。確信が持てたら 301 にしてください。ブラウザは 301 を期限なしでキャッシュするので、誤ったものは取り消しにくくなります。

既定ではインポートは マージ します。同じ from を持つ既存のルールは更新され、それ以外は残ります。ファイルを表全体にしたい場合は mode: "replace"(CLI では --replace)を使います。そのとき removed に、削除されるルールが表示されます。

2. 適用する ​

text
redirects.csv を acme-marketing に適用して。promote はまだしないで。
bash
edge redirects import acme-marketing redirects.csv --apply
bash
curl -s -X POST \
  https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/redirects/import \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --rawfile source redirects.csv '{source: $source, format: "csv", dry_run: false}')"

エージェントは dry_run: false を付けて edge_redirect_import を実行します。ファイルにまだエラーがあれば何も作成されません。なければレスポンスに deployment_id が含まれます。その deployment が新しいリダイレクト表を持っています。公開中のサイトはまだ変わっていません。

3. 新しい deployment を確認する ​

promote する前に、新しい deployment でいくつかの古い URL がどこに転送されるかを確認します。

text
acme-marketing の deployment 01M4T7B2QX9K3R5N8W0YHDVJCE で、/blog/spring-launch と
/pricing-2025?utm_source=mail はどこにリダイレクトされる?
bash
edge redirects check acme-marketing "/blog/spring-launch" --deployment 01M4T7B2QX9K3R5N8W0YHDVJCE
edge redirects check acme-marketing "/pricing-2025?utm_source=mail" --deployment 01M4T7B2QX9K3R5N8W0YHDVJCE
bash
curl -s -G \
  https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/redirect-check \
  -H "Authorization: Bearer $EDGE_TOKEN" \
  --data-urlencode "path=/blog/spring-launch" \
  --data-urlencode "deployment_id=01M4T7B2QX9K3R5N8W0YHDVJCE"

エージェントは edge_redirect_check を実行します。エッジと同じ照合を使います。

json
{ "matched": true, "rule": { "from": "/blog/*", "to": "/news/:splat", "status": 302 }, "location": "/news/spring-launch", "status": 302 }

deployment のプレビュー URL を開き、古いリンクをいくつかブラウザでたどって確認することもできます。

4. promote する ​

いつもどおり deployment を promote します。パッチ、公開、切り戻し を参照してください。リダイレクトも一緒に公開されます。DNS の切り替えと合わせるなど、決めた時刻に切り替えたい場合は promote を予約します。リリースと公開停止を予約する を参照してください。

promote したあとに問題があれば、切り戻すと前の deployment と一緒に前のリダイレクト表も戻ります。

あとでエクスポートして編集する ​

あとで表を変えるには、エクスポートしてファイルを編集し、もう一度インポートします。

text
acme-marketing のリダイレクトを CSV でエクスポートして。
bash
edge redirects export acme-marketing > redirects.csv
bash
curl -s "https://api.edge.deca-dev.com/v1/distributions/d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38/redirects/export?format=csv" \
  -H "Authorization: Bearer $EDGE_TOKEN" | jq -r .content

エージェントは edge_redirect_export を実行します。

次に読む ​