クイックスタート

5分でYurucommuをセットアップしてデプロイする手順です。

前提条件

Bun 1.3系
Cloudflareアカウント（無料プランで可）
Git

デプロイ方法を選ぶ

yurucommu は Git URL / ref / module path で指定できる OpenTofu Capsule です。本番導入は Takosumi が Capsule を Git から読み、検証して Plan を作成し、レビューしたうえで Apply する流れで行います。手元で動作を確認したい場合は、下の「ローカルで確認する」手順を使います。

デプロイガイドを開く

ローカルで確認する

まずリポジトリをクローンして、ローカルで Worker を起動します：

git clone https://github.com/tako0614/yurucommu.git
	cd yurucommu
	bun install
	bun run dev

Worker を直接確認する場合は bunx wrangler dev --config wrangler.local.toml を使います。開発時の基本タスクは bun run build、bun run build:worker、bun run db:generate です。

本番導入（Takosumi で install）

本番は Takosumi の Capsule install フローで導入します。yurucommu は plain OpenTofu Capsule として扱われ、専用 manifest は不要です。

Step 1: Source を登録

Git URL / ref / module path で Source を Project に登録します。Takosumi が Capsule を Git から読み、検証して Plan を作成します。

Step 2: ProviderBinding と変数を確認

D1 / R2 / KV / Queue / route は generated root が作成します。cloudflare provider などにどの ProviderConnection を使うかは ProviderBinding で指定し、必要な変数・secret を確認します。

Step 3: Plan / レビュー / Apply

レビューした Plan を承認して Apply すると、Worker / D1 / R2 / KV / Queue が materialize され、StateVersion・Output・AuditEvent に public URL と launcher metadata が記録されます。ロールバックは過去の StateVersion を選んで通常の Plan -> Apply フローで行います。

初期設定

デプロイした URL にアクセスし、初回セットアップを行います：

ユーザー名を設定
表示名を設定
パスワードを設定（AUTH_PASSWORD_HASH を設定した場合）