OpenAICloudflare Developer Platform2026/07/02 0:00

Workers - Work across multiple accounts with Wrangler auth profiles

要点だけを先に読めるように短く再構成したセクションです。

元記事

Quick Digest

要約

要点だけを先に読めるように短く再構成したセクションです。

openaijamodel: gpt-5-mini-2025-08-07

Wranglerの認証プロファイルで複数アカウントを安全に切替

Key Points

  • ディレクトリ単位の認証
  • 複数アカウント自動切替
  • CIはAPIトークン優先

Summary

Wrangler CLIが「認証プロファイル」をサポートしました。プロファイルはディレクトリに紐づけられた名前付きOAuthログインで、作業ディレクトリ(とそのサブディレクトリ)に応じて対応するCloudflareアカウントに自動で切り替わります。エージェンシー作業やステージング/本番で別アカウントを使う場面で便利です。

Key Points

  • プロファイルはディレクトリ単位の名前付きログイン(OAuth)。該当ディレクトリ内で実行したコマンドはそのアカウントを使用する。
  • プロファイルの作成・有効化例:
    • wrangler auth create client-a
    • wrangler auth activate client-a ~/clients/client-a
  • 単発コマンドでプロファイルを指定するには --profile を使用:
    • wrangler deploy --profile personal
  • セーフガードとして、プロファイルに対応する account_idwrangler.toml に明示しておくと、誤ったアカウントへの操作を防げる。
  • CI/自動化環境では CLOUDFLARE_API_TOKEN がプロファイルより優先される(既存トークンの動作は変更なし)。
  • 詳細な解決順序やコマンドリファレンスは公式の「Authentication profiles」を参照すること。

Practical tips

  • クライアントごとにプロファイルを作り、各クライアントのプロジェクトルートで wrangler auth activate を実行しておく。
  • デプロイ前にローカルでプロファイルが期待どおりに動くか wrangler のステータスコマンドで確認する習慣を付けると安全。

Full Translation

翻訳

原文の流れを保ったまま読める翻訳セクションです。

openaijamodel: gpt-5-mini-2025-08-07

Workers - Wrangler の認証プロファイルで複数アカウントをまたいで作業する

Wrangler の認証プロファイルで複数アカウントをまたいで作業する

Workers の Wrangler CLI は認証プロファイル (auth profiles) をサポートするようになりました。認証プロファイルは、特定の Cloudflare アカウントに紐づけた名前付きログインで、作業しているディレクトリに基づいて自動的に切り替わります。

  • プロファイルはディレクトリに結び付けられた名前付きの OAuth ログインです。
  • そのディレクトリおよびサブディレクトリで実行されるコマンドは、対応するアカウントを使用します。つまり、wrangler login を再実行せずにアカウント間を移動できます。
  • エージェンシーでクライアントごとにログインを分けたり、ステージングと本番で別アカウントを使い分けたりする用途に便利です。
  • Wrangler の設定ファイルに account_id をプロファイルに紐づけることで、コマンドが誤ったアカウントに到達するのを防げます。

使い方(例)

各アカウント用にプロファイルを作成し、どのディレクトリでそのプロファイルが有効になるかを指定します。例えば:

wrangler auth create client-a
wrangler auth activate client-a ~/clients/client-a
wrangler auth create client-b
wrangler auth activate client-b ~/clients/client-b

単一コマンドで明示的にプロファイルを指定するには、--profile フラグを使います:

wrangler deploy --profile personal

CI やその他の自動化環境では、環境変数 CLOUDFLARE_API_TOKEN がすべてのプロファイルに優先して使用されます。

セットアップ手順、解決順(resolution order)、およびコマンドの完全なリファレンスについては、Authentication profiles のドキュメントを参照してください。