zudo-cloudflare-wisdom

Type to search...

to open search from anywhere

Cloudflare セットアップ

作成2026年4月4日Takeshi Takatsudo

アカウント設定、APIトークン、Wrangler CLI の構成

API トークン

Cloudflare ダッシュボードの My Profile > API Tokens から API トークンを作成します。

Pages および Workers のデプロイには、以下の権限が必要です:

  • Account > Cloudflare Pages > Edit
  • Account > Workers Scripts > Edit
  • Account > Workers KV Storage > Edit(KV を使用する場合)
  • Account > Workers R2 Storage > Edit(R2 を使用する場合)
  • Account > D1 > Edit(D1 を使用する場合)

💡 Tip

サービスごとに別々のトークンを作るのではなく、全権限をまとめた1つのトークンを作成しましょう。GitHub リポジトリのシークレットに CLOUDFLARE_API_TOKEN として保存してください。

CI 用の環境変数

すべてのプロジェクトで以下の GitHub Actions シークレットが必要です:

シークレット説明
CLOUDFLARE_ACCOUNT_IDCloudflare アカウント ID(ダッシュボードの URL に含まれる)
CLOUDFLARE_API_TOKEN上記で作成した API トークン
IFTTT_PROD_NOTIFY(任意)デプロイ通知用の IFTTT Webhook URL

Wrangler CLI

Wrangler は Cloudflare の CLI ツールです。CI では npx wrangler@4 を使い、グローバルインストールを避けます。ローカル開発では以下のようにインストールします:

pnpm add -D wrangler

または npx で実行します:

npx wrangler@4 pages deploy dist --project-name=my-project

⚠️ Warning

破壊的変更を避けるため、メジャーバージョンを固定してください(wrangler@4)。CI では wrangler@latest を使用しないでください。

wrangler.toml

Pages Functions、KV、D1、R2 を使用するプロジェクトでは、プロジェクトルートに wrangler.toml が必要です:

# Cloudflare Pages project configuration
compatibility_date = "2024-12-01"

バインディングや設定の詳細は Wrangler 設定 を参照してください。