検証用と本番役で、データベースと画像の保存先を分ける
別々のD1とR2を用意し、同じIDのメモや同じ名前の画像が混ざらないことを、手元と公開先で確認します。
目次
検証用の変更が本番役に影響しないように、メモと画像の保存先も分けます。 公開先が2つあっても、同じ保存先を使っていれば、検証用で書き換えた内容が本番役にも表示されるためです。
1本目の公開実習を終えた教材フォルダーを使います。Node.js 24.22.1 / Wrangler 4.158.0が対象です。操作はVS Codeのコマンド入力欄で行います。Windowsはコマンドプロンプトを選びます。macOSで実行確認済みです。
D1とR2は、何を保存するもの?
D1 は、タイトルなどを表にまとめて保存するデータベースです。R2 は、画像などのファイルを保存する場所です。R2の保存先のまとまりを「バケット」と呼びます。
今回作るのは次の4つです。いずれも教材専用で、既存サイトの保存先は使いません。
| 環境 | D1 | R2 |
|---|---|---|
| 検証用 | weekend-cf-lab-staging-db | weekend-cf-lab-staging-media |
| 本番役 | weekend-cf-lab-production-demo-db | weekend-cf-lab-production-demo-media |
1本目で名前を変えた場合は、このガイドの weekend-cf-lab も変更後の名前に置き換えてください。
1. 空の保存先を作る
ローカルサーバーが起動していれば Control + C で止めます。教材フォルダーで次を順番に実行します。
npx wrangler d1 create weekend-cf-lab-staging-db
npx wrangler d1 create weekend-cf-lab-production-demo-db
npx wrangler r2 bucket create weekend-cf-lab-staging-media
npx wrangler r2 bucket create weekend-cf-lab-production-demo-mediaD1の作成時は、出力された database_id をそれぞれ控えます。D1・R2のどちらでも「設定へ自動追加するか」と聞かれたら No を選びます。次の手順で、追加する環境を指定して設定するためです。
すでに同じ名前があると言われた場合は、用途が分からない保存先を流用せず、名前を確認します。R2の利用開始を求められた場合は、Cloudflareの画面で利用条件を確認してから進めてください。
2. どの保存先を使うか設定する
次の命令の「検証用D1のID」と「本番役D1のID」を、それぞれ手順1で控えたIDに置き換えて実行します。
npm run storage -- 検証用D1のID 本番役D1のID教材の scripts/storage.mjs が wrangler.jsonc に設定を追加します。まだ公開は行いません。同じIDを2回指定した場合や、設定済みの保存先を上書きしようとした場合は止まります。
wrangler.jsonc を開き、env 内の staging と production-demo に、それぞれ次の2項目ができていることを確認します。
| 項目 | 読み方 |
|---|---|
d1_databases の binding: "DB" | プログラム内では、このD1を DB と呼ぶ |
r2_buckets の binding: "MEDIA" | プログラム内では、このR2を MEDIA と呼ぶ |
この接続設定を「バインディング」と呼びます。DB という呼び名は同じでも、接続するIDは別にできます。D1の環境別設定(別タブで開く)も、この分け方です。
3. まず手元の保存先で試す
ローカルでは、Cloudflare上のD1やR2とは別のデータを使います。教材では、手元の検証用データを .state/staging、本番役を .state/production-demo に保存します。
次の2つで、それぞれに練習用のメモを入れます。--local が「手元の保存先へ」、--persist-to が「どのフォルダーへ」を指定しています。
npx wrangler d1 execute DB --env staging --local --persist-to .state/staging --file sql/staging.sql
npx wrangler d1 execute DB --env production-demo --local --persist-to .state/production-demo --file sql/production-demo.sqlSQLは、データベースに指示を出すための言葉です。教材のファイルには「メモ用の表を作り、1件入れる」という命令が入っています。EmDash本体の表を変更する命令ではありません。
次は、検証用にだけ練習画像を入れます。
npx wrangler r2 object put weekend-cf-lab-staging-media/sample.svg --env staging --local --persist-to .state/staging --file fixtures/sample-v1.svg --content-type image/svg+xmlsample.svg は保存後の名前、fixtures/sample-v1.svg は手元のファイルです。--content-type は画像の種類を伝えています。
VS Codeで入力欄を2つ開き、片方で次を実行します。
npm run dev:stagingもう片方では次を実行します。
npm run dev:production-demoブラウザーで確認します。
| 開くURL | 期待する表示 |
|---|---|
http://127.0.0.1:8788/notes | 検証用のメモ |
http://127.0.0.1:8789/notes | 本番役のメモ |
http://127.0.0.1:8788/image | 緑色の IMAGE v1 |
http://127.0.0.1:8789/image | IMAGE_NOT_FOUND |
本番役には画像を入れていないので、最後のURLで「見つからない」を示す404エラーが返るのは正常です。同じ sample.svg という名前でも、別の保存先の画像は勝手に表示されません。
4. Cloudflare上にもデータを入れる
手元の確認が済んだら、2つの起動をそれぞれ Control + C で止めます。今度は --remote を付けて、Cloudflare上の教材用保存先へ書き込みます。
npx wrangler d1 execute DB --env staging --remote --file sql/staging.sql
npx wrangler d1 execute DB --env production-demo --remote --file sql/production-demo.sql
npx wrangler r2 object put weekend-cf-lab-staging-media/sample.svg --env staging --remote --file fixtures/sample-v1.svg --content-type image/svg+xml
npx wrangler deploy --env staging
npx wrangler deploy --env production-demo確認が出たら、対象名が今回作った教材用のものか読んでから進めます。deploy は保存先との接続設定を公開します。ローカルのデータをアップロードする命令ではないため、先に --remote でメモと画像を入れています。
検証用URLと本番役URLの末尾に、それぞれ /notes と /image を付けます。手元で見た表と同じ結果なら成功です。
保存先を間違えたかも、と思ったら
まず、そのまま書き込みを繰り返さず、次の順で確認します。
- URLは
127.0.0.1か、公開先のworkers.devか。 - 命令に
--localと--remoteのどちらを付けたか。 --envはstagingかproduction-demoか。- その環境の
database_idとbucket_nameは、控えたものと一致するか。
手元だけで「表がない」「画像がない」と言われる場合は、データを入れたときと起動したときに、同じ保存フォルダー(--persist-to)を使っているかも確認します。環境名を分けても、同じ保存先を指定すると分離できません。
EmDashで使うときは
Cloudflare用のEmDash構成でも、DB が記事や設定を保存するD1、MEDIA が画像などのR2を指します。実際の名前はプロジェクトの設定で確認します。
EmDashの検証環境では、保存先に加え、管理者・暗号鍵・メール・外部連携の送り先も確認します。今回の lab_notes を作るSQLは、EmDashの移行手順には使いません。詳しくは検証用サイトの準備へ進めます。
終了するとき・次回続けるとき
起動した入力欄で Control + C を押します。次回は2つの dev コマンドで再開できます。メモを初期化する命令は毎回実行する必要はありません。
次は、今作った公開先でエラーのログを調べる練習です。