他のホスティングからリダイレクトを移行する
サイトを Edge に移すときは、古い URL が引き続き使える必要があります。検索エンジンや古いリンクからの訪問者が 404 ではなく新しいページに着くようにします。このページでは、リダイレクトの一覧をまとめてインポートし、確認してから公開します。
以降、distribution は acme-marketing(d3f7a1c4-90b2-4e6a-8f15-6c2b7e0a9d38)とし、移行元のホスティングはルールを redirects.csv に書き出したものとします。
from,to,status
/pricing-2025,/pricing,302
/about-us,/about,302
/blog/*,/news/:splat,302Edge は Netlify の _redirects ファイルと JSON も読めます。正確な形式は リダイレクト にあります。
どこで実行できるか
リダイレクトのインポートは ウェブコンソールでは実行できません。エージェント、CLI、または API を使ってください。
1. ファイルを確認する
インポートは、指定しない限りドライランです。何も変更せず、次のことを報告します。
- 追加、変更、削除されるルール
- 行番号付きのすべてのエラー
- ループと長いリダイレクトチェーン
- 許可されていない外部の転送先
redirects.csv を acme-marketing へのリダイレクトのインポートとして確認して。
まだ適用しないで、エラーと警告を見せて。edge redirects import acme-marketing redirects.csvcurl -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 を実行します。レポートは次のようになります。
{
"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 supported | Edge はリダイレクトだけを扱います。その行を削除します。 |
上のファイルは 302 を使っているので、確認しているあいだブラウザはリダイレクトをキャッシュしません。確信が持てたら 301 にしてください。ブラウザは 301 を期限なしでキャッシュするので、誤ったものは取り消しにくくなります。
既定ではインポートは マージ します。同じ from を持つ既存のルールは更新され、それ以外は残ります。ファイルを表全体にしたい場合は mode: "replace"(CLI では --replace)を使います。そのとき removed に、削除されるルールが表示されます。
2. 適用する
redirects.csv を acme-marketing に適用して。promote はまだしないで。edge redirects import acme-marketing redirects.csv --applycurl -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 がどこに転送されるかを確認します。
acme-marketing の deployment 01M4T7B2QX9K3R5N8W0YHDVJCE で、/blog/spring-launch と
/pricing-2025?utm_source=mail はどこにリダイレクトされる?edge redirects check acme-marketing "/blog/spring-launch" --deployment 01M4T7B2QX9K3R5N8W0YHDVJCE
edge redirects check acme-marketing "/pricing-2025?utm_source=mail" --deployment 01M4T7B2QX9K3R5N8W0YHDVJCEcurl -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 を実行します。エッジと同じ照合を使います。
{ "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 と一緒に前のリダイレクト表も戻ります。
あとでエクスポートして編集する
あとで表を変えるには、エクスポートしてファイルを編集し、もう一度インポートします。
acme-marketing のリダイレクトを CSV でエクスポートして。edge redirects export acme-marketing > redirects.csvcurl -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 を実行します。
次に読む
- リダイレクト: ルールの形式、照合の順序、ステータスコード
- 独自ドメインを割り当てる
- 制限