WordPressEscape

ホーム / ガイド

Workbench

528,854件のWordPressページをHugoへ移行:エンジニアリングノート

これは、社内の姉妹サイトであるUnlimited Chartersを、2026年5月にWordPressからHugoへ移行した際の作業ノートです。ビジネス面の概要はケーススタディにまとめています。ここでは、実際に作業を担当する人に向けて、50万ページ規模で何が壊れたのか、どのコマンドでつまずいたのか、そして現在では規模を問わずすべてのサイトで実行しているチェック項目を記録します。

読了まで約9分 9セクション 検索上位表示を実現する設計
このページの内容
  1. 背景
  2. コンテンツ作成前のテンプレート棚卸し
  3. 分割ビルドとファイルシステム上の落とし穴
  4. テンプレート変更と全ページへの反映で実施したパフォーマンス改善
  5. 効果が大きかったCloudflareの設定
  6. スキーマとSEOに関する詳細
  7. リード獲得は絶対に失ってはならない部分
  8. 別のやり方をするなら
  9. 参考資料・さらに詳しく
  10. よくある質問
すぐに答え

この規模になると、問題の多くはHugoそのものよりも、ファイルシステムと作業プロセスに関係します。ビルドの分割、退避したコンテンツをHugoのcontentマウント外に置くこと、同じディレクトリで2つの移行処理を同時に実行しないこと、そしてすべての修正をテンプレートの変更とサイト全体へのスクリプト適用の組み合わせとして扱うことが重要です。パフォーマンスを最も大きく改善したのは、画像サイズの明示、クリティカルCSSの同期読み込み、LCP画像の遅延読み込み解除、引用ウィジェットの遅延読み込みと表示領域の確保、そしてCloudflareのメールアドレス難読化機能の無効化でした。

01

背景

Unlimited Chartersは、WordPressEscapeと同じグループが運営しています。これは、サーバーに完全にアクセスできる状態で実施した、私たち自身の移行テストです。サイトには50万を少し超えるURLがあり、その大半はテンプレートで生成された地域ページでした。ほかにも、ハブページ、保有機材のページ、ブログが含まれていました。移行先は、Cloudflareの背後で静的ファイルとして配信するHugoサイトで、既存のパスをすべて維持することが目標でした。

02

コンテンツ作成前のテンプレート棚卸し

まず、URLパターンではなく、各ページを表示していたWordPressのテンプレートごとにURLを分類しました。テンプレート群ごとに、「Hugoのレイアウトとして再構築する」か、「当面はWordPressの出力を静的スナップショットとして配信する」かを決めました。トラフィックの多いテンプレート群から優先的に再構築し、特殊なページはスナップショット化することで、膨大なカスタムページを抱えるロングテールに足止めされず、プロジェクトを進められました。

知っておくべき注意点があります。WordPressでは、URLパスが常にpost_nameスラッグと一致するとは限りません。親ページ、カスタムリライトルール、古いインポートによって、スラッグと一致しないパスが生成されていたため、パスはデータベースではなくクロール結果から取得する必要がありました。

03

分割ビルドとファイルシステム上の落とし穴

すべてのページを一度にレンダリングすると時間がかかり、小さな変更でも大きなコストが発生します。そこで処理を分割しました。ビルド対象でないソースファイルを退避場所へ移動し、一部だけをビルドしてデプロイした後、ファイルを元に戻す方法です。ただし、4つの落とし穴に時間を取られました。

  1. 退避場所はHugoのコンテンツマウントの外に置く必要があります。マウントされたコンテンツディレクトリの下に置くと、Hugoはそこにあるすべてのファイルも走査するため、分割しても効果がありません。
  2. rsync --exclude=index.htmlは、最上位のファイルだけでなく、すべての階層にあるindex.htmlを除外します。パターンを--exclude=/index.htmlのようにルートに限定してください。
  3. 同じディレクトリを2つのプロセスが同時に移動すると、ディレクトリが入れ子になります。2つの復元プロセスが競合した結果、約367,000個のディレクトリが本来より1階層深い場所に生成されました。ビルド済みの出力を配信していたため本番環境には影響しませんでしたが、1本のスクリプトで移動してフラットな状態に戻しました。ロックを使って、ディレクトリを操作できるプロセスを1つに制限します。
  4. この規模ではmv dir/* target/は失敗します。(引数リストが長すぎるためです。)find ... -exec mv -t target {} +を使用してください。
# すべてを再ビルドせず、一部のページだけをレンダリング
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # コンテンツマウントの外に退避
  for s in $(cat targets.txt); do mv ../stash/$s content/migrated/; done
  hugo --minify -d ../staged
  find ../stash -mindepth 1 -maxdepth 1 -exec mv -t content/migrated/ {} +
'
04

テンプレート変更と全ページへの反映で実施したパフォーマンス改善

すべての改善は2段階で行いました。まず、今後のビルドが正しくなるようHugoのテンプレートを修正し、次に、全面的な再ビルドを行わずにリリースできるよう、すでに生成済みのHTMLにも修正を適用しました。特に効果が大きかったのは次の項目です。

  • 画像サイズ。あるテンプレートではwidth="1600" height="700"がハードコードされていましたが、CSSで指定されているアスペクト比とは異なっていました。527,815ページを修正しました。widthとheightは、実際に表示されるアスペクト比と一致させる必要があります。一致しないと、ブラウザが確保するスペースが不正確になります(CLSの最適化)。
  • 競合するアスペクト比のルール。2つのスタイルシートで同じセレクターに異なるaspect-ratioルールが指定されていたため、1つに統合しました。
  • 非同期ファイルに含まれていたクリティカルCSS。ファーストペイントに必要なモバイル向けルールが遅延読み込みのスタイルシートに入っていたため、後から再レイアウトが発生していました。同期読み込みのスタイルシートへ移動しました。
  • 遅延読み込みされていたヒーロー画像。ファーストビューにある画像にloading="lazy"が指定されていたため、LCPが遅れていました。fetchpriority="high"に置き換えました(LCPの最適化)。
  • サイズが大きすぎたLCP画像。より小さいバリエーションに差し替え、1ページあたり50~440KBを削減しました。
  • 見積もりウィジェット。最初の操作時に読み込む方式に変更し、タイムアウト時のフォールバックも用意しました。また、コンテナに480px(モバイルでは560px)の高さをあらかじめ確保しました。以前は、このウィジェットの表示によってページが移動し、CLSが約0.54発生していました。
05

効果が大きかったCloudflareの設定

  • Email Obfuscationを無効化。読み込み後にDOMを走査してメールリンクを書き換えるデコーダーが動作し、レイアウトシフトの原因になっていました。確認できた中で、最も継続的にCLSを発生させていた要因です。
  • Rocket Loaderを無効化。スクリプトの実行順を変更し、遅延読み込みと干渉していました。
  • デプロイ後にパージ。エッジキャッシュに古いHTMLが残っていたため、デプロイのたびにパス単位でパージし、古いページが配信されるのを防ぎました(Cloudflareのパージに関するドキュメント)。
  • ステージングではなく本番環境を測定。同じCloudflare設定を適用していないステージング環境では、ラボ計測のスコアが本番環境と一致しませんでした。
06

スキーマとSEOに関する詳細

  • Search Consoleで、ServiceエンティティにaggregateRatingとreviewが含まれていることによる構造化データのエラーが報告されました。無理に検証を通そうとはせず、これらを削除しました。マークアップは、ユーザーが実際に確認できるコンテンツを反映している必要があります(構造化データのガイドライン)。
  • ブログ記事は当初、地域ページ用のテンプレートでレンダリングされ、誤ったスキーマタイプを継承していました。現在は、各テンプレートが独自のエンティティを宣言しています。
  • 一貫性のなかった35個の保有機材ページとサービスページのパスには、正しい階層構造のページへ恒久的にリダイレクトする設定を追加しました(リダイレクト)。
  • メディアのパスを/wp-content/uploads/から/uploads/へ移行し、1つの301ルールで対応しました。並行実行したsed処理により、528,854ファイル中528,852ファイルを書き換えるのに数分しかかかりませんでした。
  • Hugoでサイトマップ、スキーマ、メタタグ、robots.txtを出力できるようになったため、Yoastを削除しました。
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

リード獲得は絶対に失ってはならない部分

見積もりフォームはサイトの収益源なので、専用のチェック項目を設けました。ウィジェットを表示する必要があるすべてのページで、ビルド後のHTMLにウィジェットのマウント先が存在すること、フィールド名が受付エンドポイントの想定と一致していること、そしてディレクトリを置き換えるデプロイによって独立した見積もりページが削除されないことを確認します。リード獲得機能が失われたままの切り替えは、SEOの各指標上は問題なく成功したように見えても、ビジネスから問い合わせを奪ってしまいます。

08

別のやり方をするなら

  1. 最初のCLS計測前に、メールアドレスの難読化を無効にする。
  2. 初日からビルドを分割する。
  3. 初日からコンテンツディレクトリを固定する。
  4. 最初の修正前に、テンプレートとコンテンツ群を一括処理するパターンを文書化する。5回目の修正後では遅すぎる。
  5. フィールドデータ(CrUX)の確認をローンチチェックリストに含める。ステージング環境でのラボスコアは、本番環境の実績を示すものではないため。

WordPressに残したものも含め、このプロジェクトをビジネス面から見た内容は、事例紹介でご覧いただけます。

09

参考資料・さらに詳しく

よくある質問

これは顧客サイトの移行ですか?

いいえ。Unlimited Chartersは、WordPressEscapeと同じグループが運営する社内向けの姉妹サイトです。私たち自身のテストケースとして使用しています。

Hugoは50万ページを処理できますか?

はい。ただし、完全な再ビルドには十分な時間がかかるため、ビルドの分割やファイルの慎重な取り扱いが重要になります。問題の大半はHugoのバグではなく、ファイルシステムや処理手順に起因していました。

最も大きなレイアウトシフトの原因は何でしたか?

予約領域を確保せずに引用ウィジェットを読み込んでいたこと(ハブページでCLSが約0.54)と、Cloudflare Email Obfuscationが読み込み後にページを書き換えていたことです。

これらの知見は小規模サイトにも当てはまりますか?

はい。同じ確認項目(URLの整合性、画像サイズ、クリティカルCSS、遅延読み込みしないヒーロー画像、遅延実行するウィジェット)が40ページ程度のサイトにも適用できます。違いは、数時間ではなく数分で完了することです。

サイトを無料でスキャンする

あなたのサイトも同じ対応が可能か確認する

無料の60秒監査では、実際のPageSpeedスコア、正確なページ数、SEO上の不足点、そして置き換えが必要なWordPress機能を確認できます。その後、WordPressEscapeがHugo上でサイトを再構築し、すべてのURLを維持したまま、初日からソースコードをお渡しします。UCの再構築も同じ方法で行いました。

サイトを無料でスキャンする
続きを読む
すべてのガイド33
関連する検索wordpressからhugoへの移行528,854ページ(社内テスト)hugoの分割ビルドcloudflareのcls対策構造化データの整理URLの完全一致