本番に触れずに、Cloudflareの練習用公開先を作る
共通教材をパソコンで起動し、Cloudflareに2つの練習用ページを公開します。公開・保存先・ログ・秘密情報・切り戻しの5つの実習はここから始めます。
目次
公開の練習は、今動いているサイトと別の場所でできます。この実習では、Cloudflareに「検証用」と「本番役」の2つの小さなページを作ります。本番役も、今回新しく作る練習用です。 会社の本番サイトには接続しません。
まず、画面に「staging」と出れば検証用、「production-demo」と出れば本番役、という見分け方を覚えましょう。次の実習で、データや画像の保存先も分けます。
この5つの実習で作るもの
| 順番 | 試すこと |
|---|---|
| 1・このガイド | パソコンで動かし、2つの公開先を作る |
| 2・保存先を分ける | データベースと画像の保存先を、それぞれ別にする |
| 3・ログを見る | わざと起こしたエラーの原因を調べ、直す |
| 4・秘密情報を登録する | パソコン用と公開先用の設定を分ける |
| 5・前のコードに戻す | コードを戻しても、記事や画像が戻らないことを確かめる |
教材は、Cloudflareの仕組みを覚えるための小さなプログラムです。EmDashの管理画面や記事編集機能は入っていません。 EmDash本体を公開する手順はCloudflareへの公開ガイドにあります。それぞれの実習の最後で、EmDashのどの設定につながるかを説明します。
先に用意するもの
必要なのは、Node.js、VS Code、ブラウザー、インターネット接続です。公開まで進む場合はCloudflareアカウントも使います。次の実習ではR2という画像などの保存サービスを使うため、アカウントでR2を利用できる状態にしておきます。
対象は Node.js 24.22.1 / Wrangler 4.158.0。macOSで実行確認しました。Windowsのコマンドはコマンドプロンプト用に書いていますが、Windows実機での確認はまだです。準備が済んでいなければパソコンの準備から進めてください。
Cloudflareへ公開すると、利用量はそのアカウントに計上されます。無料枠があっても、他のサイトの利用量や契約によって請求は変わります。Workersの料金(別タブで開く)、D1の料金(別タブで開く)、R2の料金(別タブで開く)を確認してください。ローカル起動までならCloudflareへのログインは不要です。
今回の公開URLは、URLを知っている人なら開けます。教材は架空のメモだけを扱います。noindex は検索結果に載せないための指定で、閲覧を禁止する設定ではありません。
1. 教材のフォルダーを開く
ZIPを展開し、できた emdash-cloudflare-labs フォルダーをVS Codeの「ファイル → フォルダーを開く」で開きます。
「ターミナル → 新しいターミナル」を選ぶと、画面下にコマンド入力欄が出ます。Windowsでは欄の右上のメニューから Command Prompt(コマンドプロンプト) を選びます。Macは通常のzshで進められます。
次を1行ずつ入力して、その都度Enterを押します。5つの実習のコマンドは、すべてこのフォルダーで実行します。
node -v
npm ci
npx wrangler --version
npm run checknpm ci は教材の部品を、指定した版でそろえる命令です。Wranglerは、手元での起動やCloudflareへの公開に使う道具です。版の確認で 4.158.0 が表示され、check がエラーなく終われば準備できています。
2. パソコンの中で開く
npm run dev:stagingReady on http://127.0.0.1:8788 が出たら、ブラウザーでそのURLを開きます。「週末ノート Cloudflare実習」「環境:staging」「コード:v1」が表示されれば成功です。
127.0.0.1 は自分のパソコンを指します。この段階ではインターネットへ公開していません。ポート番号8788が使用中と言われたら、以前の実習が起動したままになっていないか確認してください。
この時点では、データベースと画像のリンクはまだ使えません。次の実習で保存先を設定します。「公開先を確認する」を押すと、次のような情報が出ます。
{
"environment": "staging",
"release": "v1",
"ok": true
}実際にはリクエストIDなども含まれます。environment が使っている環境、release が教材コードの版です。
3. 公開用の名前を確認する
VS Codeで wrangler.jsonc を開きます。教材では、次の2つの環境を用意しています。環境とは、同じプログラムを動かす別々の場所です。
| 設定名 | 公開されるWorkerの名前 | 用途 |
|---|---|---|
staging | weekend-cf-lab-staging | 変更を試す検証用 |
production-demo | weekend-cf-lab-production-demo | 影響がないかを確かめる本番役 |
WorkerはCloudflare上でこのプログラムを動かす単位です。name の weekend-cf-lab に環境名が付きます。すでに同じ名前のWorkerを使っている場合は、そのまま進めないでください。 name を別の名前に変え、その後のコマンドの weekend-cf-lab の部分もそろえて変更します。
この教材はWrangler用の設定ファイルを含むため、Wranglerで進めます。別のAstroプロジェクトへ、このファイルを丸ごと上書きする必要はありません。
4. 自分のCloudflareへログインする
ローカル起動中の入力欄で Control + C を押して止めてから実行します。Macでも、この終了操作はCommandではなくControlです。
npx wrangler login
npx wrangler whoamiログインではブラウザーが開きます。使いたいCloudflareアカウントを選び、続く whoami の表示でもアカウント名を確認します。複数のアカウントがある場合は、wrangler.jsonc の一番外側に account_id を追加して、今回使うIDを指定できます。アカウントIDは操作するアカウントを指定する番号です。認証に使う秘密情報のAPIトークンとは区別してください。
認証エラーが出たら、先にログインをやり直します。秘密のトークンをガイドのコメント欄やチャットへ貼る必要はありません。
5. 検証用と本番役を公開する
まず、公開用ファイルを準備できるか調べます。
npx wrangler deploy --env staging --dry-run--dry-run は準備の確認です。この命令だけでは公開しません。エラーがなければ、次を1行ずつ実行します。
npx wrangler deploy --env staging
npx wrangler deploy --env production-demo各命令の最後に https://...workers.dev のURLが表示されます。これをそれぞれ 検証用URL、本番役URL として控えます。末尾の Current Version ID はコードの版を識別するIDです。最後の「前のコードに戻す」実習でも使います。
2つのURLをブラウザーで開いて、片方が staging、もう片方が production-demo になることを確認してください。同じ表示なら、同じURLを2回開いていないか見直します。
--env staging のような指定は、どちらへ操作するかを選ぶ部分です。以後も省略しません。環境を使った設定方法はCloudflare公式の説明(別タブで開く)でも確認できます。
EmDashで使うときは
EmDashでも、変更を試す検証用サイトを用意できます。ただし、Workerの名前だけを分けても、記事や画像の保存先が同じならデータは共有されます。次の保存先を分ける実習で、この違いを確かめます。
終了するとき・次回続けるとき
ローカル起動は Control + C で止められます。次回は同じフォルダーで npm run dev:staging を実行します。
Cloudflareの公開先は、手元の画面を閉じても動き続けます。5つの実習で使う間は残し、終わったら最後のガイドの片付けを行ってください。