AstroからEmdashへの移行でハマった話（その1）

ブログを書いたり書かなかったり、もう何年も続けていますが、なかなか長続きしませんでした。Wordpress、Jekyll、Ghostなどいろいろ試して、最終的にAstroで自分のブログを構築し、これが割と長く続いています。CloudflareがWordPressの置き換えとしてEmDashを発表したとき、Vide Code製ということもあって最初は手を出しませんでしたが、数ヶ月経っても更新が続いていて、すでに移行した人も多いと知って、私も移行を始めました。

Claude Codeでの移行作業

2026年9月の今となっては、ほとんどの人がAIを使って移行するでしょうね。今のAIはもう十分優秀ですから、私はただClaude Codeを開いて、こう入力しただけです。

https://docs.emdashcms.com/existing-project/

参考这个, 把现有的astro 更改成使用 emdash 管理的CMS

するとAIがドキュメントと既存のプロジェクト構成を基に、Emdashのインストールを進めてくれます。私はCloudflareのConnectorをインストールしましたが、CCはなんとD1とR2まで直接作成してくれました。本当に手間いらずで助かりました。

しばらくして、EmDashをCFに無事デプロイできました。さらにEmDashの管理画面にPassKeyログインを設定することも成功しました（これが後々落とし穴になるのですが、それはまた別の記事で）。

初期デプロイで押さえるべき2つの重要ポイント

Claude Codeのおかげでデプロイの流れは非常にスムーズでしたが、実際にやってみて、これは絶対に事前に知っておくべきだという重要な経験が2つあります。

1. 既存のMDX記事：EmDashへの取り込みを100%確認してから削除すること！

ローカルのMarkdown/MDXファイルは、Git上にあるあなたの絶対的な資産です。EmDashにインポートした後は、管理画面とフロントエンドの両方で、データがCloudflare D1データベースに完全に存在していることを一つ一つ確認してください。**デプロイが成功したからといって、すぐにローカルの元ファイルを削除してはいけません**。まず完全なアーカイブバックアップを残し、データに問題がないことを確認してからクリーンアップしましょう。

2. 強く推奨：カスタムドメインを先に設定してから、PassKeyログインを設定すること！

これはほとんどの人（私も含めて）がまんまと引っかかる、見えにくい落とし穴です。

- デプロイ直後、多くの人はデフォルトで生成された *.workers.dev の一時ドメインで管理画面の初期設定を行い、そのまま自分のデバイスのPassKeyを登録してしまいます。

- しかし、PassKey（WebAuthn）はアクセスするドメイン（Origin / rpId）に強く紐付いています。後から独自のカスタムドメインを設定すると、**カスタムドメイン経由でアクセスした場合、workers.dev で作成したPassKeyはそのまま使えなくなり、ログインできなくなります！**

次回予告：管理画面にロックアウトされかけたPassKeyの落とし穴

前の節で触れた2つ目のポイントは、実は今回のデプロイで私が一番痛感した、身に沁みる経験でした。

当時私は workers.dev で意気揚々とPassKeyを設定しましたが、独自ドメインを紐付けた後、カスタムドメインの管理画面ではそのPassKeyがまったく表示されないことに気づきました。

そこでシステムがメールの認証コードでのログインを提案してきたのですが、ここで気まずい事態が発生——**当時、私はメールサービス（Email Provider）の設定をまだ一切していなかったんです！**

PassKeyは使えない、メールの認証コードも届かない。私は自分で作った管理画面に、危うくロックアウトされかけてしまいました……。

結局どうやって脱出したのか？Cloudflareのエッジ環境でのメールプラグインの設定方法とは？次回の記事では、この笑い話のようなPassKeyとログイン認証の落とし穴を、じっくり掘り下げていきます。