本文へスキップ
hdknr blog
戻る

稼働中のサイトを HubSpot CMS へ止めずに移す — 定石と、やってしまった例

WordPress などで稼働中の www.example.co.jp を HubSpot CMS に移すとき、悩みどころは 2 つあります。

結論から言うと、移行専用サブドメインで作り込み、切り替えの日は SSL 事前発行 → ドメイン変更 → 公開 → DNS の順に進めれば、止めずに移せます。この記事ではまず定石を整理し、後半で定石を外して苦労した実例を紹介します。

ドメイン・ID・検証用の値は伏せてあります。

前提: HubSpot は「接続済み」のドメインしか選ばせない

HubSpot にドメインを登録しただけ(DNS をまだ向けていない = 未接続)の状態では、ページ設定のドメインの選択肢に出てきません。接続済みにするには www の DNS を HubSpot に向けるしかありません。そして向けた瞬間に、旧サイトは見えなくなります。

つまり、www. そのものを確認期間の作業場所にはできません。どこか別のドメインで作り込み、切り替えの日に www. へ移す形になります。その「別のドメイン」の選び方が定石の分かれ目です。

以下、サイト(ホスト名)としては www.、DNS レコード名としては www と書き分けます。

HubSpot CMS 移行の定石 3 通り

やり方確認期間中切り替えの日向いている場面
A. 移行専用サブドメインnew.example.co.jp などを接続し、そこで作り込み、公開して確認www. を接続し、コンテンツを www. に移す一般的。ページ数が多い / 確認者が多い
B. HubSpot のシステムドメイン<portalId>.hs-sites-*.com で作るDNS 切り替え後、ページごとにドメインを付け替える小規模
C. 停止を受け入れる下書きのまま作るDNS を切り替えてから、管理画面でドメインを変えて公開ページが少ない / 停止(SSL 事前発行なしなら最大数時間の SSL エラー)を許容できる

A. 移行専用サブドメイン(おすすめ)

大事なのは「そのサブドメインには移行対象のページしか置かない」ことです。 後述の「やってしまった例」はここを外しました。

B. システムドメイン

追加の DNS 作業が要らない手軽さが利点です。ただし URL が本番の形と違い、付け替えはページごとになります。

C. 停止を受け入れる

手順は単純ですが、DNS を向けてから全ページの公開が終わるまで、www. は HubSpot の 404 になります。加えて SSL 証明書は DNS が向いてから発行されるので、事前発行(次節)をしないと数分〜4 時間ほど SSL エラーも出ます。

切り替えの日の順番 — SSL 事前発行から DNS 切り替えまで

どの定石でも、切り替えの日の原則は同じです。SSL を先に、公開を先に、DNS は最後 です。

切り替えの日の 4 手順を左から順に並べた図。1. SSL 証明書の事前発行、2. ページのドメインを www にする、3. ページを公開する、の 3 つを終えるまで訪問者には旧サイトが見え続け、最後の 4. www の DNS を HubSpot に向けた時点で TTL 分の時間をかけて新サイトに切り替わる

順番操作訪問者に見えるもの
1SSL 証明書を事前発行(pre-provision)する旧サイト
2ページのドメインを www. にする旧サイト
3ページを公開する旧サイト(DNS がまだ旧サイトを向いている)
4www の DNS を HubSpot に向けるTTL 分(例: 5 分)で新サイトに切り替わる

HubSpot 自身も「稼働中のサイトを移すときは、DNS を変える前にコンテンツを公開しておく」よう案内しています。

SSL の事前発行のやり方

画面上の表記は「事前プロビジョニング」です。「設定」→「コンテンツ」→「ドメインと URL」→「ウェブホスティング」→「ホスティングドメインを接続」と進みます(登録済みで止まっているなら「設定を続行する準備ができました」の「続ける」)。

注意: 「自動的に接続」は押さない

「ドメインを自動的に接続しますか?」で「自動的に接続」を選ぶと、DNS プロバイダー(Route 53 など)へのログインを求められ、その権限で HubSpot が DNS レコードを直接書き換えます。www まで書き換わり、その場でサイトが移ってしまいます。

選ぶのは「レコードを手動で更新」のほうです。こちらはレコードの表が出るだけです。

画面内の警告文「これらの設定を変更すると…オフラインになります」に付いた「分かりました」のチェックボックスは注意書きの確認で、チェックしても何も起きません。

バナーから事前発行する

レコードの表の上に、既存サイトに証明書がある場合だけ次のバナーが出ます。

SSL を事前プロビジョニングしてダウンタイムを回避

「あらかじめプロビジョニング」を押すと、TXT レコードの表が出ます。筆者の環境では次のホスト名でした(実際の値は画面の表示に従ってください)。

ホスト用途
_acme-challenge.www証明書の発行(DCV: Domain Control Validation、ドメイン管理権の検証)
_cf-custom-hostname.wwwホスト名の所有確認
_acme-challenge / _cf-custom-hostname直下ドメイン分(直下 → www の転送も設定している場合)

どれも www や @ とは別名の TXT なので、追加しても旧サイトには影響しません。 追加して「確認」を押すと、所有確認はすぐ終わります。証明書は数十分〜最大 4 時間で「プロビジョニングがされました」と表示されます(DNS の反映が遅い場合は、HubSpot のドキュメント上は最大 24 時間かかることもあります)。

注意点をまとめます。

dig での確認はたとえば次のとおりです。

dig +short TXT _acme-challenge.www.example.co.jp
dig +short TXT _cf-custom-hostname.www.example.co.jp

DNS 切り替えの注意

やってしまった例: 稼働中の別サイトのドメインで作り込んだ

状況

同じポータル(HubSpot アカウント)で、採用サイト recruit.example.co.jp がすでに HubSpot で稼働していました。コーポレートサイトの新ページ 33 ページとブログを、この recruit. の上に下書きで作り込みました。テンプレートだけはコーポレート用のテーマを使っています。

何が困ったか

  1. 定石 A の「まとめて移す」が使えない。 recruit. ごと www. に移すと、稼働中の採用サイト 23 ページまで移ってしまう
  2. 管理画面では www. を選べない。 未接続なので選択肢に出ない。コンテンツ担当者に「どのページを、いつ、どう切り替えるのか」を任せられない
  3. 新規ページを管理画面から作れない。 筆者の環境では、テンプレート一覧にブランドに紐づくテーマ(= 採用サイトのもの)しか出ず、コーポレートのテンプレートが選べなかった。既存ページのクローンか API で作るしかない
  4. ドメインを www. にするとプレビューが使えなくなる。 「新しいタブで開く」が DNS の向き先(旧サイト)に飛ぶ。一度 www. に移して確認できなくなり、recruit. に戻した

どう乗り切ったか

CMS Pages API の domain は、筆者の環境ではポータルに登録済みのドメインなら未接続でも受け付けました。そこで、コーポレートのテンプレート(www/templates/...)を使っているページだけを機械的に選び、API で付け替えることにしました。

PATCH /cms/v3/pages/site-pages/{id}
{"domain": "www.example.co.jp"}

# トップページは slug も空(ルート)にする。
# recruit. 上の採用サイトのトップと slug が衝突するので、
# ドメインを分けた後でないと 409 になる
{"domain": "www.example.co.jp", "slug": ""}

# ブログは新しい API でのブログ設定更新が 405(Method Not Allowed)。
# 旧 API(PUT /blogs/v3/blogs/{id})で domain を書き換えた
# ※ この旧 API は公式リファレンスでは見当たらなかったが、筆者の環境では動いた

結果として、切り替え作業は API を扱える開発者しかできない形になりました。コンテンツ担当者の作業は、recruit. 上の下書きへの入稿・確認までです。切り替えの判断材料には、対象ページの一覧(Excel)を別途作って渡しました。

おまけ: 手順書の DNS が古かった

手順書には「www は A レコード(旧サーバーの IP)」とありました。しかし実際の DNS を引くと、CloudFront への CNAME に変わっていました。手順書の「A に戻す」切り戻し手順をそのまま信じていたら、戻せなかった可能性があります。

教訓

まとめ

参考



前の記事
Claude Code を iPhone から遠隔操作する — Remote Control の設定と、通知でつまずいた話
次の記事
必須コードレビューをやめるなら、品質は何で担保するのか — レビューが担っていた 8 つの役割と AI 時代の代替手段