Skip to content

Commit 7e6b420

Browse files
committed
docs(deploy): document required Wrangler/Cloudflare secrets and CI setup for v0.1.5
1 parent 8aafa4b commit 7e6b420

File tree

1 file changed

+28
-0
lines changed

1 file changed

+28
-0
lines changed

.agent/docs/tasks/v0.1.5-tasks.md

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,34 @@ v0.1.4 に続く小リリース。統計ダッシュボード、デプロイ、
2323
- [ ] Pages + Workers のデプロイ設定とドキュメント化
2424
- [ ] `wrangler.toml` / CI の最終確認(環境変数・シークレット)
2525

26+
### Deploy: Secrets & CI 設定
27+
28+
- **必須シークレット**:
29+
- `WRANGLER_API_TOKEN`: Cloudflare API token(Workers publish 権限)
30+
- `JWT_SECRET`: Workers 側で使用する JWT の秘密鍵(`wrangler.toml` の `vars.JWT_SECRET` を上書き)
31+
- `D1_DATABASE_ID`(またはプロジェクトで使っている `DB` バインディング用のデータベース ID)
32+
- (オプション)R2 関連の `R2_BUCKET` / `R2_ACCESS_KEY` 等(画像アップロードを使う場合)
33+
34+
- **GitHub Actions にシークレットを設定する手順**:
35+
1. リポジトリの Settings → Secrets → Actions を開く
36+
2. 上記キーを追加(例: `WRANGLER_API_TOKEN`, `JWT_SECRET`, `D1_DATABASE_ID`)
37+
3. `WRANGLER_API_TOKEN` は必要最小限の権限(scripts: edit/publish)で作成する
38+
39+
- **CI の挙動**:
40+
- `.github/workflows/ci-deploy.yml` は `WRANGLER_API_TOKEN` が存在する場合に `npx wrangler publish --dry-run` を実行します。
41+
- 本番公開を CI で行うなら、`--dry-run` を外すか別ジョブで `wrangler publish` を実行するワークフローを作成してください。
42+
43+
- **ローカル検証コマンド例**:
44+
45+
```
46+
WRANGLER_API_TOKEN=xxxxx npx wrangler publish --dry-run
47+
```
48+
49+
- **注意点**:
50+
- シークレットは絶対にソース管理に含めないこと。`wrangler.toml` に直接シークレットを書かず、CI シークレットで上書きしてください。
51+
- `d1_databases` の `database_id` は Cloudflare ダッシュボードで払い出された ID を利用するか、CI シークレット経由で注入します。
52+
53+
2654
## 品質 / パフォーマンス
2755
- [ ] パフォーマンス計測( Lighthouse / ページロード)と主要改善項目の適用
2856
- [ ] 統合テスト(recipes の主要フロー)を安定化

0 commit comments

Comments
 (0)