検証用と本番役で、データベースと画像の保存先を分ける

別々のD1とR2を用意し、同じIDのメモや同じ名前の画像が混ざらないことを、手元と公開先で確認します。

目次

検証用の変更が本番役に影響しないように、メモと画像の保存先も分けます。 公開先が2つあっても、同じ保存先を使っていれば、検証用で書き換えた内容が本番役にも表示されるためです。

1本目の公開実習を終えた教材フォルダーを使います。Node.js 24.22.1 / Wrangler 4.158.0が対象です。操作はVS Codeのコマンド入力欄で行います。Windowsはコマンドプロンプトを選びます。macOSで実行確認済みです。

D1とR2は、何を保存するもの?

D1 は、タイトルなどを表にまとめて保存するデータベースです。R2 は、画像などのファイルを保存する場所です。R2の保存先のまとまりを「バケット」と呼びます。

今回作るのは次の4つです。いずれも教材専用で、既存サイトの保存先は使いません。

環境D1R2
検証用weekend-cf-lab-staging-dbweekend-cf-lab-staging-media
本番役weekend-cf-lab-production-demo-dbweekend-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-media

D1の作成時は、出力された 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.sql

SQLは、データベースに指示を出すための言葉です。教材のファイルには「メモ用の表を作り、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+xml

sample.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/imageIMAGE_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 を付けます。手元で見た表と同じ結果なら成功です。

保存先を間違えたかも、と思ったら

まず、そのまま書き込みを繰り返さず、次の順で確認します。

  1. URLは 127.0.0.1 か、公開先の workers.dev か。
  2. 命令に --local と --remote のどちらを付けたか。
  3. --env は staging か production-demo か。
  4. その環境の database_id と bucket_name は、控えたものと一致するか。

手元だけで「表がない」「画像がない」と言われる場合は、データを入れたときと起動したときに、同じ保存フォルダー(--persist-to)を使っているかも確認します。環境名を分けても、同じ保存先を指定すると分離できません。

EmDashで使うときは

Cloudflare用のEmDash構成でも、DB が記事や設定を保存するD1、MEDIA が画像などのR2を指します。実際の名前はプロジェクトの設定で確認します。

EmDashの検証環境では、保存先に加え、管理者・暗号鍵・メール・外部連携の送り先も確認します。今回の lab_notes を作るSQLは、EmDashの移行手順には使いません。詳しくは検証用サイトの準備へ進めます。

終了するとき・次回続けるとき

起動した入力欄で Control + C を押します。次回は2つの dev コマンドで再開できます。メモを初期化する命令は毎回実行する必要はありません。

次は、今作った公開先でエラーのログを調べる練習です。

公式の参照元

関連ガイド

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

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