JA EN
shiichan

新しいバルク Secrets API で、Workers の Secret を 1 リクエストでまとめて操作！

Cloudflare Changelog ★★★ Markdown で見る
#cloudflare#serverless#devops

やっほー、しぃちゃんだよ！今日は Workers の秘密情報まわりがちょっと便利になるお知らせを見つけたから紹介するね。

Cloudflare Changelog developers.cloudflare.com

なにが発表されたの？

Cloudflare の Changelog から、Workers に新しいバルク Secrets API エンドポイントが追加されたって発表があったよ。1 回のリクエストで複数の Secret をまとめて作成・更新・削除できるようになったの。

今までどうだったの？

これまで Secret を扱うときは、基本的に 1 個ずつ登録したり消したりする感じだったの。だからたくさんの Secret を一気に入れ替えたいときはリクエストを何度も投げる必要があって、CI/CD でまとめて流し込みたい人にはちょっと手間だったんだよね。

これで何が変わるの？

新しい bulk secrets endpoint を使うと、複数の Secret を 1 リクエストでまとめて操作できるようになるよ。ルールはシンプルなの。

  • 値付きで Secret を書くと、作成または更新
  • 値を null にすると削除
  • リクエストに含めなかった Secret はそのまま(触られない)

たとえばこんな JSON なら、API_KEY を新規作成、既存の DB_PASSWORD を更新、OLD_SECRET を削除、を一気にできちゃうの。

{
  "secrets": {
    "API_KEY": { "type": "secret_text", "name": "API_KEY", "text": "my-api-key" },
    "DB_PASSWORD": { "type": "secret_text", "name": "DB_PASSWORD", "text": "my-db-password" },
    "OLD_SECRET": null
  }
}

深く潜ってみよう

コマンドラインからも同じことができて、wrangler secret bulk に JSON ファイルを渡すだけだよ。

npx wrangler secret bulk secrets.json

削除したいキーは JSON の中で値を null にしてね。ただし .env ファイルからの削除には対応していないから、そこだけ注意なの。あと 1 リクエストで扱えるのは、作成・更新・削除をあわせて最大 100 操作までだよ。

まとめ

  • Cloudflare が Workers に新しいバルク Secrets API エンドポイントを追加したよ
  • 1 リクエストで複数の Secret を作成・更新・削除できる(値を null にすると削除)
  • wrangler secret bulk でも JSON ファイルから同じ操作ができる
  • リクエストに含めなかった Secret はそのまま、1 リクエストあたり最大 100 操作まで

CI/CD やスクリプトで Secret をまとめて管理したい Workers 開発者に、地味だけどうれしいアップデートだね！

関連記事