部署策略與流程 (Deployment Guide)

#Deployment#Cloudflare#CI-CD

部署指南 (Deployment Guide)

🚀 部署策略

本專案分為兩個獨立部分:

  1. 靜態前端 (PWA)
  2. 後端 Worker (Cloudflare Worker)

1. 部署 PWA (前端)

推薦使用 Cloudflare Pages,因為它能與我們的 Worker 後端在同一個生態系中運行,且全球訪問速度極快。

構建設定:

  • Build Command: (留空)
  • Output Directory: pwa

⚠️ 重要:緩存刷新 當你推送新代碼後,必須更新 pwa/sw.js 中的 CACHE_NAME 版本號(例如 v15 -> v16)。這會觸發 Service Worker 的更新機制,強制用戶瀏覽器清理舊緩存並下載最新資源。

2. 部署後端

使用 wrangler CLI 進行部署:

npx wrangler deploy worker.js

注意:確保 Worker 返回了正確的 CORS Headers,允許前端網域進行跨域請求。

🔄 未來優化:GitHub Actions

計畫實施自動化流水線:

  1. 推送代碼。
  2. 自動替換 sw.js 中的版本號為當前時間戳。
  3. 自動執行 Lint 檢查。
  4. 自動發布至 Cloudflare。