Cloudflare 在 2026 年 11 月 18 日公告,平台現在保留每個 Worker 最近 100 個版本,以及每個 Pages 專案最近 100 次部署;更舊且未在使用中的紀錄會被刪除。正在執行的 Worker 版本與目前的 Pages production deployment 不會因為超過序號範圍而被移除,所以這不是服務停止,也不會直接讓線上網站下線。

真正改變的是歷史可用範圍。舊 Worker version 被刪除時,它的 Version URL 與 --preview-alias 一併失效;舊 Pages deployment 被刪除時,對應 preview URL 也會消失。需要長期保留客戶驗收連結、稽核證據,或把平台版本歷史當成唯一回滾方案的團隊,應立即調整流程。

先用部署頻率換算「100 個版本」能撐多久

保留上限不是 100 天。每天部署 2 次的專案,理論上涵蓋約 50 天;每次 pull request push 都部署、一天產生 20 次版本的專案,只剩約 5 天。這只是用頻率做的規劃估算,實際刪除還要看哪些版本仍部署中,以及 Workers 與 Pages 各自建立紀錄的方式,不能把估算日期寫成平台承諾。

先從 Cloudflare dashboard、Wrangler 與 CI 紀錄盤點最近 30 天的 deployment 數量,分開計算 production、preview、機器人更新、內容發布與失敗後重跑。接著找出哪些連結被貼進 issue、工單、驗收文件或通知信。如果外部人員會在數週後才開啟 preview URL,問題不只是能否回滾,而是交付證據可能失效。

高頻 monorepo 還要檢查無關變更是否也觸發部署。若一個套件更新同時重建多個 Worker 或 Pages project,每個專案各自累積版本;應用 affected-project 判斷、路徑篩選與取消過時的 queued build,先減少沒有驗收價值的紀錄。

Worker 版本不是資料庫快照

Cloudflare 文件把 Worker version 定義為當時的 bundled code、static assets、bindings 與 compatibility settings;KV、R2、D1、Durable Objects 等儲存資源的資料狀態不包含在版本中。即使目標程式版本仍在最近 100 個之內,也不能假設按下 rollback 就能把 schema、資料與外部服務一起倒回。

官方 rollback 文件也指出,若目標版本需要的 R2 bucket、KV namespace 或 Queue 已被刪除,或 Durable Object class lifecycle 在期間發生不相容變更,回滾可能不被允許。因此資料遷移應採向前相容設計:先部署同時理解新舊欄位的程式,再遷資料,最後才移除舊欄位。對不可逆操作,要準備 forward fix、資料備份與復原腳本,而不是只保留 Worker version ID。

Pages rollback 的條件不同:成功建置的 production deployment 可以成為回滾目標,但 preview deployment 不是有效 rollback target。不要因為某個 preview URL 還能開啟,就把它視為 production 災難復原點;正式發布後應記錄可回滾的 production deployment、對應 commit 與驗收結果。

三種保留需求要用不同方案

短期測試可繼續使用 Cloudflare Version URL、Workers Previews 或 Pages preview。這些連結方便逐次驗收,但應在通知文字標示有效期間,不承諾永久保存。對 pull request,Cloudflare 特別建議使用獨立於 production 版本的 Workers Previews,而不是依賴會隨版本刪除的 --preview-alias。

中期發布回滾則應維持可重現 build:固定 lockfile、runtime、Wrangler 或 cf 版本與建置參數,保存 commit SHA、artifact digest、migration version 和部署時間。即使平台已刪除舊版本,也能從已簽章或可驗證的原始輸入重新建置。若法遵要求保存原始產物,應把 artifact 放進有 retention policy 與存取稽核的 registry 或物件儲存,不要把 Cloudflare 部署歷史當成封存庫。

長期視覺或客戶驗收可以保存截圖、測試報告、Lighthouse/E2E 結果與核准紀錄;若必須保留可操作環境,建立專用 staging release,比讓數百個臨時 preview 永久存在更容易管理權限與資料。正式資料不能任意複製到 staging,仍要遮罩個資並限制存取。

導入檢查與回滾演練

第一步列出所有 Worker 與 Pages project,記錄近 30 天版本產生速度、最舊可見版本、目前 deployed version,以及外部仍在引用的 preview URL。第二步為 CI 加入 commit、artifact 與 migration 對照表,並把重要驗收證據移出臨時網址。第三步在非正式環境做一次演練:部署新版本、修改相容資料、回滾程式,再確認 bindings、靜態資產、快取與資料讀寫都正確。

告警也要從「部署失敗」擴大到「版本接近保留邊界」。Cloudflare 沒有在公告中承諾替每個團隊提供時間型告警,所以可由部署流水線依計數與平均速度估算風險,提醒 owner 清理不必要觸發或封存關鍵產物。估算結果只用於內部治理,不應冒充官方保存期限。

這次變更的核心不是急著搬離 Cloudflare,而是把短期 preview、程式回滾、資料復原與長期稽核分開設計。部署量低、只需要近期回滾的網站多半不需改平台;高頻 CI、長驗收週期或受稽核的系統,則應把 100 個版本視為操作窗口,而不是備份策略。