ファイルを置く第07章 ・ 読むのにかかる時間 約12分

R2を​つくる​:写真と​資料の​倉庫

付箋・表・倉庫を見分けて、フォルダが存在しない世界へ

写真と​資料を​置く​倉庫を​建てます。

Cloudflareには​データを​置く​場所が・・と​何種類も​ありますが、​中身は「付箋」​「表」​「倉庫」の3つです。

この本で​使うのは​倉庫の​R2。
建てるのは​頼んでから​10秒で​終わります。

大事なのは、R2には​フォルダが​存在しないと​いう​事実を​飲み込むことです。

この章でできるようになること

  • KV・D1・R2の違いを知り、写真や資料はR2に置くと判断できる
  • 自分のR2バケット(倉庫)を作り、キーという名前の付け方を決める
  • Workerに「この倉庫を使っていい」という権限を渡す
この章の内容(6節)
  1. 置き場所は3種類。この本で使うのは倉庫です
  2. バケットとは、倉庫そのもの
  3. フォルダは、ありません
  4. キーの付け方を、先に決めておく
  5. Workerに「この倉庫を使っていい」と伝える
  6. この章のまとめ

置き場所は​3種類。​この本で​使うのは​倉庫です

KV付箋の束

短い​メモを、​名前を​付けて​貼っておく

  • 例:設定・合言葉
  • 名前が​分かれば​一瞬
  • 中身での​検索は​苦手
D1表計算の表

行と​列で​並べて、​条件で​絞り込める

  • 例:会員名簿・投稿一覧
  • 「◯◯な​人だけ」が​得意
  • 大きな​ファイルは​不向き
R2倉庫

箱に​名前を​書いて​そのまま​預ける

  • 例:画像・PDF・動画
  • 大きくても平気
  • 中身は​見ずに​預かる
置く​ものの​大きさと、​あとで​どう​探したいか。​選ぶ基準は​この​2つだけです。

迷った​ときは、​この​順番で​考えます。

  1. 1ファイル​その​もの?はい → R2
  2. 2条件で​絞り込みたい?はい → D1
  3. 3名前で​1個取れれば​十分な、​短い​値?はい → KV
上から​順に​聞いて、​最初に​「はい」に​なった​ものを​選びます。

写真も​PDFも​「ファイル​その​もの」なので、​答えは​R2です。

倉庫は​中身を​開けず、​箱に​貼った​名前だけを​見て​預かります。

だから​「10月に​撮った​写真だけ出して」は​R2だけでは​答えられません。

それを​やりたくなったら、​写真は​R2に、​撮影日などの​情報は​D1に​分けます。
倉庫と​台帳の​関係です。

第1章で​見た​とおり、​R2はダウンロードされる​ときの​通信料が​かからず、​10GBまでの​保管も​無料です。

思わぬ拡散で​請求が​跳ねる​心配が​ないので、​個人が​写真や​資料を​置く​場所と​して​向いています。

オブジェクトストレージ

R2のような​仕組みの​正式な​呼び名です。
ファイルを​1つの​「かたまり​(オブジェクト)」と​して、​名前を​付けて​預かります。

世界的には​Amazonの​S3と​いう​同種の​サービスが​有名で、​R2は​それと​同じ​使い方が​できるように​作られています。

ネットの​記事に​「S3互換」と​書いて​あったら、​この​意味です。

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

R2では、​倉庫の​ことをバケットと呼びます。
バケツのです。

この​中に​ファイルを​入れていきます。

1つの​バケットに、​何万個ファイルを​入れても​構いません。

用途ごとに​分けたい​ときだけ、​バケットを​増やします。
この​教科書では​1つで​進めます。

Claude Codeにこう頼みます

画像を置くためのR2バケットを作ってください。名前は my-photos にしてください。 作ったあと、バケットの一覧を表示して、ちゃんとできているか確認してから、結果を日本語で教えてください。

作成に​成功すると、​Cloudflareが設定に​書き足すための​文章を​一緒に​返してきます。

あとで​使うので、​Claude Codeの​画面を​そのままに​しておいてください。

フォルダは、​ありません

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

パソコンでは、​写真フォルダの​中に​2026年フォルダを​作って、​その​中に​画像を​入れます。

R2には​この​入れ子が​ありません。
あるのは、​平らな​床に​並んだ箱だけです。

では、​よく​見かける​ images/photo.png と​いう​表記は​何なのか。
あれはファイルの​名前​その​ものです。

「images スラッシュ photo.png」と​いう​長い​1つの​名前であって、​imagesと​いう​入れ物が​あるわけでは​ありません。

パソコンの場合フォルダの​中に​フォルダ
  • images
    • 2026
      • photo.png
R2の場合箱が​平らに​並んでいるだけ
images/2026/photo.png
images/2026/cover.png
スラッシュは、​ただの​文字。​R2から​見れば、​長い​名前が​1つあるだけです。

キー(key)

バケットの​中で​ファイルを​特定する​ための​名前の​こと。

images/2026/photo.png のような​文字列全体が、​1つの​キーです。

同じ​キーで​2回入れると、後から​入れた​もので​上​書きされます。

この​性質は、​第11章の​画像の​差し替えで​大事に​なります。

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

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

おすすめは​3つです。

1先頭に​種類を​付けるimages/・docs/ で​始める

「images で​始まる​ものだけ出して」と​いう​取り出し方が​できます

2日本語と​スペースを​使わない英数字と​ハイフンで​作る

URLに​入れた​ときに、​化けたり記号に​置き換わったりします

3重複しない​文字を​混ぜるランダムな​文字列を​足す

photo.png のような​普通の​名前は、​別の​人が​上げると​上​書きされます

3つめは​自分で​やらなくて​大丈夫。​第8章で、​Claude Codeが​自動で​付ける​形にします。

この​倉庫には、​写真と​一緒に​講座の​レジュメや​メニュー表の​PDFも​置きます。

1つの​バケットのままで、​写真は​ images/、資料は docs/ と​先頭で​分けておく。

これだけで、​第12章の​公式ページで​写真の​区画と​資料の​置き場に​振り分けられます。

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

バケットを​作っただけでは、​あなたの​Workerは​それを​触れません。

第5章で​出てきたbindingの出番です。

設定ファイルに、​使っていい​権限を​書き足します。

Claude Codeにこう頼みます

いま作った my-photos バケットを、このプロジェクトのWorkerから使えるようにしてください。wrangler.jsonc にR2のbindingを追加して、binding名は BUCKET にしてください。 追加したあと、設定ファイルのどこが変わったかを日本語で説明してください。

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

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

意味は​そのままです。
「BUCKETと​いう​呼び名で、​my-photos と​いう​倉庫を​使って​よい」
。

この​呼び名は、​次の​章で​プログラムの​中に​出てきます。

Cloudflareの管理画面のR2オブジェクトストレージの一覧。バケットの名前・オブジェクト数・サイズが表で表示されている実際の画面
管理画面の​R2の​実際の​一覧です。​作った​バケットは、​名前・​入っている​個数・合計サイズつきで​ここに​並びます。

うまくいったか確認する

  • バケットの​一覧に​ my-photos が出てくる
  • Cloudflareの​管理画面の​R2の​項目にも、​同じ​名前が​表示されている
  • wrangler.jsonc に r2_buckets の​行が​増えている

よくあるつまずき

A bucket with this name already exists

その​名前は​使用済みです。my-photos-2026 のように​変えてください。

バケット名を​変えたら、wrangler.jsonc の bucket_name も​同じ​名前に​直す必要が​あります。

bindingを書いたのに、Workerから使えない

設定ファイルを​直しただけでは、​公開済みの​Workerには​反映されません。
もう​一度​公開する​操作が​必要です。

「変更を​公開してください」と​頼んでください。

ただし、​第8章で​アップロードの​窓口を​作った​あとは、​第12章で​合言葉を​付けるまで​公開しません。

試すのは​手元の​画面だけです。

バケットを作ったのに、管理画面に出てこない

アカウントを​複数​持っていて、​別の​アカウントに​作られている​可能性が​あります。

「いまログインしている​アカウントを​教えてください」と​頼めば、​確認は​一瞬です。

キーに日本語を使ったら、URLが変な文字列になった

日本語は​URLの​中で​長い​記号列に​変換されます。

壊れてはいませんが​読みにくいので、​キーは​英数字と​ハイフンで​作るのが​無難です。

この章のまとめ

付箋が​KV、​表が​D1、​倉庫が​R2。
この本で​使うのは​倉庫です。

その​倉庫を​建てて、​Workerに​使用許可を​渡しました。

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

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

章末チェックリスト