DocsDigest
一覧へLanguage: EN
ClaudeCloudflare Developer Platform2026/03/25 0:00

Workers - Declare required secrets in your Wrangler configuration

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

元記事
OpenAIClaude

Quick Digest

要約

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

claudejamodel: claude-sonnet-4-20250514

Wrangler設定でWorkerの必須シークレットを宣言可能に

cloudflareworkerswranglersecretsconfigurationtypescriptdevops

Key Points

  • Wrangler設定で必須シークレットを明示的に宣言
  • ローカル開発とデプロイ時の検証機能を強化
  • シークレットベースの型生成でCI環境での実行が改善

Summary

Cloudflare WorkersのWrangler設定ファイルで、Workerが必要とするシークレット名を明示的に宣言できる新機能が追加されました。この機能により、ローカル開発とデプロイ時の検証が強化され、型生成の精度が向上します。

Key Points

  • 設定方法: wrangler.tomlまたはwrangler.jsoncのsecrets.required配列でシークレット名を宣言
  • ローカル開発: 宣言されたシークレットのみが.dev.varsや.envから読み込まれ、不足時は警告を表示
  • 型生成: .dev.varsからの推測ではなく、宣言されたシークレットから型定義を生成
  • デプロイ検証: 必須シークレットが設定されていない場合、デプロイが失敗してエラーを表示
  • 環境別対応: 環境ごとのシークレット設定をサポートし、一部環境のみのシークレットはオプショナル型として扱う

Full Translation

翻訳

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

claudejamodel: claude-sonnet-4-20250514

Workers - Wrangler設定でrequired secretsを宣言する

Workers - Wrangler設定でrequired secretsを宣言する

新しいsecrets設定プロパティにより、Wrangler設定ファイル内でWorkerが必要とするsecret名を宣言できるようになりました。required secretsはローカル開発とデプロイ時に検証され、型生成の信頼できる情報源として使用されます。

設定例

wrangler.jsonc

{
  "secrets": {
    "required": ["API_KEY", "DB_PASSWORD"]
  }
}

wrangler.toml

[secrets]
required = ["API_KEY", "DB_PASSWORD"]

ローカル開発

secretsが定義されている場合、wrangler devとvite devは.dev.varsまたは.env / process.envからsecrets.requiredにリストされたキーのみを読み込みます。これらのファイル内の追加キーは除外されます。

required secretsが不足している場合、不足している名前をリストした警告がログに記録されます。

型生成

wrangler typesは.dev.varsや.envから名前を推測する代わりに、secrets.requiredから型付きバインディングを生成します。これにより、これらのファイルが存在しないCIや他の環境でも型生成を実行できます。

環境ごとのsecretsがサポートされており、集約されたEnv型では一部の環境にのみ存在するsecretsをオプショナルとしてマークします。

デプロイ

wrangler deployとwrangler versions uploadは、操作が成功する前にsecrets.required内のすべてのsecretsがWorkerで設定されていることを検証します。required secretsが不足している場合、設定が必要なsecretsをリストしたエラーでコマンドが失敗します。

詳細については、secrets設定プロパティリファレンスを参照してください。