Cloudflare でデプロイとプレビュー環境を設定する #3

Cloudflare (ut-code のアカウント ut.code();) で、デプロイとプレビューを設定する。デプロイは GitHub の CI ではなく、Cloudflare の Workers Builds が行う。手順と設定値は docs/deploy.md。

済み

• リソースの作成: D1 (kanban-db、kanban-db-preview)、R2 (kanban-files、kanban-files-preview)、キュー 4 つ。名前はすべて kanban- で始める (chore: prefix the Cloudflare resource names with kanban #35、chore: set the D1 database ids of the ut-code account #37)
• D1 のマイグレーション: 本番とプレビューの両方に適用済み。main に入るたびに、本番のデプロイの前に自動で適用する
• BETTER_AUTH_SECRET (本番、全プレビュー共通) と BETTER_AUTH_URL の設定 (chore: production and preview URLs, and a fix for the deploy scripts #38)
• main への push で本番デプロイ: kanban-web と kanban-reminder-worker の両方。feat: branch previews with Worker Previews #40 のマージで、初めての自動デプロイが成功した
  • 本番: https://kanban-web.ut-code.workers.dev
• PR ごとにプレビューデプロイ: Worker Previews を使う (別の Worker は使わない)。ブランチごとに https://<ブランチ名>-kanban-web.ut-code.workers.dev。PR のコメントに URL が出る。ログインもできる (feat: branch previews with Worker Previews #40)
  • Durable Objects はプレビューごとに別。D1、R2、キューはプレビュー用のもの (全プレビューで共有)
• ビルドのトークンを kanban 専用にした (kanban-deploy、kanban-reminder-deploy)
• リモートのマージ済みのブランチを削除し、マージしたらブランチを自動で削除する設定にした

残り

• リマインドの cron が本番で動いていることを確認する (ダッシュボードの Triggers で実行の履歴を見る)
• メールが届くことの確認 (Resend でリマインドメールを送信する #8 の Resend の設定が先)。それまで、本番のメールの送信は失敗して、デッドレターキュー (kanban-mail-dead-letter) に溜まる
• 独自ドメインを使うか決める (使うなら、BETTER_AUTH_URL と APP_URL も変える)

メモ

• Workers Builds の設定は、cf builds workers get <Worker のタグ> で、保存された値を直接確かめられる。ダッシュボードの表示と、実際の値が食い違っていたことがあった
• ブランチの最初のビルドのときに、そのときの設定 (コマンド、トークン) が、そのブランチのプレビュー専用のトリガーに写される。あとから Worker の設定を変えても、既存のブランチには効かない
• Worker Previews と cf は、どちらもベータ