Cloudflareへ公開して動作確認する
Cloudflare用テンプレートから新しい検証サイトを作り、配置、初期設定、記事と画像の確認まで進めます。
目次
新しい検証サイトを公開する
このガイドでは、Cloudflare用テンプレートからweekend-note-cloudを作り、別の検証サイトとして公開します。手元で動かしているweekend-noteはそのまま残し、今回専用の保存先を用意します。
必要なのはCloudflareアカウント、Node.js 22.23.4以上、npm、ブラウザーとコマンド入力画面です。VS Codeのターミナルを使い、Windowsではコマンドプロンプトを選びます。入力画面の開き方も参照してください。対象はEmDash 1.4.0です。Cloudflare上にWorkerやデータベースなどを作る前に、使用するアカウントと利用条件を確認してください。
1. Cloudflare向けプロジェクトを作る
プロジェクトを保存したい親フォルダーで実行します。同名の既存フォルダーがないことを確認してください。
npm create emdash@latest weekend-note-cloud -- --template cloudflare:blog --pm npm --yes
cd weekend-note-cloud@latestは実行時点の最新版です。このガイドで参照した1.4.0と生成結果が違う場合は、生成されたREADMEと現在の公式手順を優先して差を確認します。
作成が終わったらpackage.json、astro.config.mjs、wrangler.jsonc、src/worker.tsを確認します。本文を表示するテーマだけでなく、Cloudflareへ接続する設定も含まれるテンプレートです。
2. 名前と接続先を確認する
wrangler.jsoncの次の項目を確認します。
| 項目 | 確認すること |
|---|---|
name | 今回のWorkerの名前か |
d1_databases | DBが今回のデータベースを指すか |
r2_buckets | MEDIAが今回の画像保存先を指すか |
main | Workerの入口ファイルを指すか |
compatibility_flags | 必要なnodejs_compatがあるか |
triggers.crons | 予約公開・定期処理の設定があるか |
既存サイトと同じ名前を使うと、そのサイトの保存先へ接続する可能性があります。今回の検証サイトには別の名前を付けてください。公式テンプレートでは、名前を指定したデータベースや画像保存先を、最初の配置時にWranglerが作成します。次回以降の配置でも同じ保存先を使います。
サンドボックスを使わない場合、sandboxRunnerとLOADERは必須ではありません。使う場合はプラグイン方式の説明にある有料プランとrunnerの条件を満たします。
3. Cloudflareへログインする
weekend-note-cloudで実行します。
npx wrangler loginブラウザーが開くので、使うCloudflareアカウントを確認して認証します。複数アカウントを持っている場合は、続けてnpx wrangler whoamiで現在の認証先を確認します。このログイン操作だけでは、サイトは公開されません。
4. ビルドして配置する
同じプロジェクトで、次を順番に実行します。
npm run build
npx wrangler deploy最初の命令は公開用ファイルの作成、次の命令はCloudflareへの配置です。deployではリソース作成やインターネットへの公開が起こるため、表示される対象名を確認して進めます。
ビルドが失敗したら配置へ進まず、エラーのファイルと内容を確認します。配置後はWranglerが示したHTTPSのURLを控えます。ここでは、そのURLを「公開先URL」と呼びます。
5. 公開先で初期設定する
公開先URLの/_emdash/admin/を開き、サイト名、管理者、ログイン方法を設定します。公開先のデータベースが新しければ、ローカルとは別の初期設定になります。
既定では最初のアクセスでEmDash内部のデータベース変更が適用されます。既存サイトの更新や大きな移行で503になる場合は、初期設定を何度もやり直さず、更新と移行の手順を確認してください。
管理画面のサイトURLも、現在使う公開URLと合っているか確認します。独自ドメインへ変更する場合は、ログインやメール内のリンクも新しいURLで確認します。
6. 秘密値が必要な機能を準備する
暗号化した設定を保存する前に、生成済みの.envなどにあるEMDASH_ENCRYPTION_KEYの管理場所を確認します。公開先にまだ登録していなければ、次でWorkerのsecretとして登録します。
npx wrangler secret put EMDASH_ENCRYPTION_KEY表示された入力欄へ、管理しているキーを渡します。キーがまだなければnpx emdash secrets generateで生成できます。すでに暗号化した値がある環境では、理由なく別のキーへ置き換えないでください。キー自体を記事、Git、通常の設定ファイルへ貼りません。
メールを使う場合はログインとメールも設定します。開発用のメール表示は、本番の送信設定には引き継がれません。
7. 読者と管理者、両方の状態を確かめる
公開先で練習記事を1件作り、画像を追加して公開します。管理画面の確認に加え、ログアウトした別のブラウザーでも記事と画像を開きます。下書きが一般向け一覧に出ないことも確認します。
予約公開を使うなら、src/worker.tsにscheduled処理があり、Cron Triggerが登録されていることを確認します。npx emdash doctorで確認できるのは、手元の設定が正しくつながっているかどうかです。公開先で予約時刻どおりに記事が表示されるかは、別に確認します。
ログを見るにはnpx wrangler tailを使います。定期処理のOkだけで公開成功と判断せず、公開のログと記事の表示を確かめます。ログ表示を終えるときはControl + Cです。公開サイトそのものは止まりません。
既存のローカル記事を持っていきたい場合は、サイト転送と復旧の違いへ進みます。