Cloudflare設定

Cloudflare Workers、D1データベース、R2ストレージの詳細なセットアップ方法です。

Cloudflareアカウントの作成

1. Cloudflareにアクセス
2. メールアドレスとパスワードを入力してアカウント作成
3. メール認証を完了

Cloudflare resources

Yurucommu の production resource は Takosumi で Capsule を install して 作成します。D1、R2、KV、Queue、route、Worker binding は generated root の Plan で確認し、reviewed Plan を Apply すると、StateVersion・Output・ AuditEvent に記録されます。手動で wrangler.toml に resource ID を貼り付ける導線は product install path ではありません。

Plan で確認する binding

D1: DB
R2: MEDIA
KV: KV
Queue producer: DELIVERY_QUEUE
Dead letter queue: DELIVERY_DLQ
Worker entrypoint: dist/worker.js

ProviderConnection

Cloudflare credential は Project に登録した Capsule の cloudflare provider に、どの ProviderConnection を使うかを ProviderBinding で 指定して解決します。cloudflare provider はその ProviderConnection を 使って Cloudflare へ直接アクセスします。broad Cloudflare token を CI secret に置いて直接 deploy する必要はありません。

トラブルシューティング

「認証エラー」が出る場合

ProviderConnection の status、cloudflare provider に紐づく ProviderBinding の設定、および Takosumi が Capsule を Git から読み、 検証して Plan を作成する際の provider 関連メッセージを確認します。

D1のクエリを確認したい場合

operator/debug 権限で provider console または Takosumi の Apply Run evidence から 対象の StateVersion・Output に記録された D1 binding を 確認します。一般ユーザー向け install docs では direct provider CLI を 正本にしません。

R2の内容を確認したい場合

Apply Run の StateVersion・Output と operator observability で対象 bucket を確認します。