本番に触れずに、Cloudflareの練習用公開先を作る

共通教材をパソコンで起動し、Cloudflareに2つの練習用ページを公開します。公開・保存先・ログ・秘密情報・切り戻しの5つの実習はここから始めます。

目次

公開の練習は、今動いているサイトと別の場所でできます。この実習では、Cloudflareに「検証用」と「本番役」の2つの小さなページを作ります。本番役も、今回新しく作る練習用です。 会社の本番サイトには接続しません。

まず、画面に「staging」と出れば検証用、「production-demo」と出れば本番役、という見分け方を覚えましょう。次の実習で、データや画像の保存先も分けます。

この5つの実習で作るもの

順番試すこと
1・このガイドパソコンで動かし、2つの公開先を作る
2・保存先を分けるデータベースと画像の保存先を、それぞれ別にする
3・ログを見るわざと起こしたエラーの原因を調べ、直す
4・秘密情報を登録するパソコン用と公開先用の設定を分ける
5・前のコードに戻すコードを戻しても、記事や画像が戻らないことを確かめる

教材は、Cloudflareの仕組みを覚えるための小さなプログラムです。EmDashの管理画面や記事編集機能は入っていません。 EmDash本体を公開する手順はCloudflareへの公開ガイドにあります。それぞれの実習の最後で、EmDashのどの設定につながるかを説明します。

先に用意するもの

5つの実習で使う教材をダウンロードする(ZIP)

必要なのは、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 check

npm ci は教材の部品を、指定した版でそろえる命令です。Wranglerは、手元での起動やCloudflareへの公開に使う道具です。版の確認で 4.158.0 が表示され、check がエラーなく終われば準備できています。

2. パソコンの中で開く

npm run dev:staging

Ready 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の名前用途
stagingweekend-cf-lab-staging変更を試す検証用
production-demoweekend-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つの実習で使う間は残し、終わったら最後のガイドの片付けを行ってください。

公式の参照元

関連ガイド

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

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