Cloudflare公開に必要な構成を理解する
コードを動かすWorkers、記事を保存するD1、画像を保存するR2の役割を説明します。ローカルとの違いも整理します。
目次
公開先にも、記事と画像の保存場所が必要
ローカルの「週末ノート」は、自分のパソコンで動いています。インターネット上で読んでもらうには、別のコンピューターでサイトを動かし、記事と画像もそこで使えるようにします。
Cloudflareでは、主にWorkersでサイトを動かし、D1に記事や設定、R2に画像やPDFを保存します。
| 名前 | 役割 | 週末ノートで扱うもの |
|---|---|---|
| Workers | サイトのプログラムを動かす | ページ表示、管理画面、API |
| D1 | データベース | 記事、入力欄の定義、設定など |
| R2 | ファイルの保存 | アップロードした写真やPDF |
| Wrangler | パソコンからCloudflareを操作する道具 | ビルドしたサイトの配置など |
プログラムとデータの保存先は分かれています。コードを再配置しても、通常は同じD1やR2を使い続けます。名前や接続先を変えると、別の空の保存先を使ってしまう場合があります。
コードから保存先へつなぐbinding
Cloudflareでは、WorkerとD1などの接続をbindingで指定します。コードの中で使う呼び名と、実際の保存先を結び付ける設定です。
公式テンプレートでは、D1をDB、R2をMEDIAという名前で使います。Wrangler側のbinding名と、EmDashのadapterが参照する名前を一致させます。adapterは、EmDashが保存先や実行環境を使うための接続部品です。
emdash({
database: d1({ binding: "DB" }),
storage: r2({ binding: "MEDIA" }),
});これは設定の抜粋です。d1とr2は@emdash-cms/cloudflareから読み込み、Astro側にもCloudflare用adapterと管理画面に必要なReactの設定を用意します。公開手順では、揃っているテンプレートから始めます。
ローカルと公開先は、別のデータ
手元で書いた記事は、コードを公開する操作(デプロイ)だけではCloudflareへ移りません。同じコードを使っていても、手元のデータベースとCloudflare上のD1は別だからです。たとえば手元で10記事を書いた場合も、記事の転送は別に行います。
初回公開で新しいデータベースを使うと、初期設定から始まります。記事や画像を移したい場合は、サイト転送などの手順を使います。移行と復旧の違いはバックアップと復旧で説明します。
時間になったら動く処理もある
予約公開や保守処理には、一定の間隔で処理を呼び出すCron Triggerを使います。Cloudflare側の時刻指定と、Worker側のscheduled処理の両方が必要です。
ローカルでは開発用のタイマーで予約公開が動いても、Cloudflareの設定が正しい証明にはなりません。公開先で予約時刻を過ぎた記事が表示されるか、別に確認します。
プラグインのrunnerは必要な場合に加える
サイト本体から隔離して動かすサンドボックス型のプラグインを使う場合は、LOADERというWorker Loaderのbindingと、PluginBridgeの書き出しなどが必要です。この構成はWorkers Paidプランを前提にします。
通常のページと管理画面を動かす構成、サンドボックスのプラグインを追加する構成を分けて考えます。公開先の費用は、利用量や保存容量、使うサービスによって変わります。EmDash本体が無料でも、Cloudflareの利用料がかかる場合があります。
公開前に決めておくもの
Workerの名前、D1の名前、R2の名前、公開URL、管理者のログイン方法を記録します。検証用なら、それとわかる名前にして本番用と分けます。
秘密値は通常の設定ファイルへ貼らず、Workerのsecretとして登録します。特に暗号化したプラグイン設定を使う場合は、EMDASH_ENCRYPTION_KEYも保存・復旧の対象です。
この役割分担がわかったら、Cloudflareへの公開手順へ進みましょう。EmDashの構成全体は公式ガイド(別タブで開く)でも確認できます。
仕組みを手を動かして確かめたい場合は、Cloudflare公開・運用の5つの実習へ進めます。小さな練習用プログラムで、公開先・保存先・ログ・秘密情報・切り戻しを順番に試します。