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_databasesDBが今回のデータベースを指すか
r2_bucketsMEDIAが今回の画像保存先を指すか
mainWorkerの入口ファイルを指すか
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です。公開サイトそのものは止まりません。

既存のローカル記事を持っていきたい場合は、サイト転送と復旧の違いへ進みます。

公式の参照元

関連ガイド

メニュー
ホーム公式ドキュメント (別タブで開く)

キーワードを入力すると、ガイドの内容から探せます。