コードを push する。
数十秒後、世界に出る。

What you get

この構成でできること

接続方式は2通りありますが、設定が最も簡単な Workers Builds（Cloudflare 純正の Git 連携） を推奨構成として解説します。API トークンの管理が不要で、ダッシュボード操作だけで完結します。

Prerequisites

前提条件

Setup · 6 steps

構築手順

上から順に進めれば、push するだけで本番反映される状態が完成します。

npm create cloudflare@latest your-app
cd your-app

{
  "name": "your-app",
  "main": "src/index.ts",
  "compatibility_date": "YYYY-MM-DD",  // 作成日を入れる
  "assets": { "directory": "./public" }
}

git init
git add -A
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/your-account/your-repo.git
git push -u origin main

Daily flow

日常の運用フロー

構築後は、これだけで本番が更新されます。デプロイの成否は GitHub のコミット横のチェックから確認できます。

# ローカルでコードを編集
$ git add -A
$ git commit -m "Update layout"
$ git push
# → 数十秒〜数分後、独自ドメインに自動反映

Optional

環境変数・Secrets・データベース

Worker に値を渡す3つの方法

機密値はコードや設定ファイルに書かず、Secrets として登録します。コードからは環境変数として読めます。ローカル開発用の値は .dev.vars に記述し、必ず Git 管理から除外します。

npx wrangler secret put SECRET_NAME
# → 値の入力を求められる。値はリポジトリに残らない

データベース（D1）を使う

リレーショナル DB が必要なら、Cloudflare 純正の D1（サーバーレス SQLite）が最も手軽です。DB は Secrets ではなく バインディングで接続するため、パスワード管理は不要です。

npx wrangler d1 create your-db

出力された database_id を wrangler.jsonc に追記します（ID は秘密情報ではないため Git に載せて問題ありません）。

{
  "d1_databases": [
    { "binding": "DB", "database_name": "your-db", "database_id": "..." }
  ]
}

Troubleshooting

動作確認とトラブルシュート

Best practices

セキュリティのベストプラクティス

• GitHub アプリのアクセス範囲は「Only select repositories」で対象リポジトリのみに限定する
• 機密値（API キー・トークン・DB 認証情報）はソースコードや wrangler.jsonc に絶対に書かず、wrangler secret put で登録する
• .dev.vars / .env は .gitignore に追加し、コミットしない
• 本番・ステージング・開発で別々の値を使う場合は、環境（environments）ごとに Secrets を分離する

Appendix

代替方式：GitHub Actions を使う

CI 内でテストや Lint を挟みたい場合は、Workers Builds の代わりに GitHub Actions + 公式アクションでデプロイできます。この場合は Cloudflare の API トークンを GitHub Secrets に登録する必要があります。

name: Deploy
on:
  push:
    branches: [main]
jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - name: Deploy
        uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

まずは Workers Builds で運用を始め、CI に独自処理を足したくなった段階で Actions へ移行するのが無理のない流れです。