Skip to main content
CloudflareとはWeb/Cloud管理画面開発環境Worker入門ローカル/デバッグ静的公開TypeScriptAPIReact連携独自ドメインCDN/キャッシュ守る基本保存先KVD1R2/ImagesDurable ObjectsQueuesCron/Workflows運用/LogsWorkers AIAI応用総仕上げ

第04章：ローカル開発と本番の秘密情報を分けよう 🧪🏭

開発中と本番では、使うAPIキーや設定を分けるのが基本です。
本番用の重要なキーをローカルで雑に使うと、事故の影響が大きくなります。
この章では、環境ごとに秘密情報を分ける考え方を学びます 😊

1. 開発用と本番用を分ける理由 🧯​

同じAPIキーを開発と本番で使うと、開発中のミスが本番に影響することがあります。

たとえば、次のような事故です。

  • 開発中にAI APIを大量に呼んでしまう
  • テスト送信が本番の通知先へ飛ぶ
  • ローカルのログに本番キーが残る
  • 本番DBへテストデータを書いてしまう

開発は開発用、本番は本番用。
この分離だけで事故の被害を小さくできます。

Separating Dev and Prod Environments

2. Wrangler environmentsの考え方 🌱​

Wranglerでは、environmentを使って設定を分けられます。
Cloudflare公式では、environmentを作ると実質的に別Worker名として扱われることが案内されています。

例です。

{
  "name": "my-worker",
  "main": "src/index.ts",
  "compatibility_date": "2026-04-24",
  "env": {
    "staging": {
      "name": "my-worker-staging"
    },
    "production": {
      "name": "my-worker-production"
    }
  }
}

こうすると、ステージングと本番を分けて考えやすくなります。

Wrangler Environments

3. Secretは環境ごとに登録する 🔐​

本番用Secretとステージング用Secretは別に登録します。

npx wrangler secret put AI_API_KEY --env staging
npx wrangler secret put AI_API_KEY --env production

同じ名前でも、環境ごとに値を変えられます。
コード側は env.AI_API_KEY と読むだけなので、環境差をコードに埋め込まずに済みます。

Secret per Environment

4. ローカルファイルはGitに入れない 🚫​

ローカル開発用の値は .dev.vars や .env 系ファイルに置くことがあります。
これらは必ずGit管理から外します。

.gitignore の例です。

.dev.vars
.dev.vars.*
.env
.env.*

ただし、.env.example のようなサンプルファイルは便利です。
値を空にして、必要なキー名だけ書きます。

AI_API_KEY=
TURNSTILE_SECRET_KEY=

.env.example Usage

5. Copilotに環境分離を見てもらう 🤖​

このCloudflare Workersプロジェクトで、stagingとproductionのSecretが混ざらないか確認してください。
wrangler.jsonc、.gitignore、.env.example の観点でレビューしてください。

実際のsecret値は貼らず、ファイル構成とキー名だけを見てもらうのが安全です。

Copilot Reviewing Environments

6. 章末チェック ✅​

  • 開発用と本番用のSecretを分ける理由が分かる
  • Wrangler environmentsの基本が分かる
  • --env 付きでSecretを登録する発想が分かる
  • .dev.vars や .env をGitに入れないと分かる
  • .env.example にはキー名だけを書くと分かる

この章で覚える一言はこれです。
開発と本番の秘密情報は混ぜない。事故を小さくする基本です 🧪🔐

Chapter 4 Summary