R2をつくる

倉庫を建てます。といっても、頼んでから10秒で終わります。この章で大事なのは建てることより、R2にはフォルダが存在しないという事実を飲み込むことです。ここを勘違いしたまま進むと、あとで必ず混乱します。

バケットとは、倉庫そのもの

R2では、倉庫のことをバケットと呼びます。バケツのバケットです。この中にファイルを入れていきます。

1つのバケットに、何万個ファイルを入れても構いません。用途ごとに分けたいときだけ、バケットを増やします。この教科書では1つで進めます。

作成に成功すると、Cloudflareが設定に書き足すための文章を一緒に返してきます。あとで使うので、Claude Codeの画面をそのままにしておいてください。

フォルダは、ありません

ここが、この章の本題です。

パソコンでは、写真フォルダの中に2026年フォルダを作って、その中に画像を入れます。R2にはこの入れ子がありません。あるのは、平らな床に並んだ箱だけです。

では、よく見かける images/photo.png という表記は何なのか。あれはファイルの名前そのものです。「images スラッシュ photo.png」という長い1つの名前であって、imagesという入れ物があるわけではありません。

キーの付け方を、先に決めておく

フォルダが無いということは、名前の付け方が唯一の整理術だということです。ここを適当にすると、1年後に泣きます。おすすめは3つです。

• 先頭に種類を付ける… images/、docs/ のように始める。あとで「images で始まるものだけ出して」という取り出し方ができます
• 日本語とスペースを使わない… URLに入れたときに化けたり、記号に置き換わったりします
• 重複しない文字を混ぜる… photo.png のような普通の名前は、別の人がアップしたときに上書きされます。ランダムな文字列を混ぜると安全です

3つめは自分でやる必要はありません。第10章で、Claude Codeが自動で付ける形にします。

Workerに「この倉庫を使っていい」と伝える

バケットを作っただけでは、あなたのWorkerはそれを触れません。第6章で出てきたbindingの出番です。設定ファイルに、使っていい権限を書き足します。

設定ファイルには、こういう数行が足されます。

"r2_buckets": [
  { "binding": "BUCKET", "bucket_name": "my-photos" }
]

意味はそのままです。「BUCKETという呼び名で、my-photos という倉庫を使ってよい」。この呼び名は、次の章でプログラムの中に出てきます。

この章のまとめ

倉庫を建てて、Workerに使用許可を渡しました。そしてR2にはフォルダが無く、スラッシュ入りの長い名前で整理するということを押さえました。

次の章で、いよいよファイルを入れます。