在現代軟體開發中，持續整合（Continuous Integration, CI）通常依賴於 YAML 檔案來定義流水線。開發者透過撰寫宣告式的設定檔，指定測試、建置與部署的順序。然而，YAML 的表達能力有限，當 CI 流程變得複雜時，開發者往往需要撰寫大量的腳本來處理邏輯判斷或錯誤恢復。針對此痛點，Cloudflare 推出了一套新的 CI SDK（@cloudflare/ci），旨在將 CI 流水線從靜態的設定檔轉化為使用 TypeScript 編寫的程式碼，並將其運行在 Cloudflare 的基礎設施之上。
背景與技術核心
Cloudflare 這次的核心理念在於將 CI/CD 流水線視為一種 Workflow（工作流）。在傳統 CI 系統中，流水線通常被視為一系列指令的線性執行；而 Cloudflare 則利用其 Workers 運行時（Runtime）以及 Workflow 技術，讓開發者能以 TypeScript 定義每個步驟。這意味著 CI 流程不再僅僅是設定檔，而是一個真正的應用程式。
該 SDK 並非設計給 Node.js 環境，而是專為 Cloudflare Workers 運行時打造，並透過 Wrangler 等工具進行打包。在底層架構上，這套系統整合了多項 Cloudflare 的核心技術：Workflow 負責流程管理與狀態保存，Sandbox（沙盒）提供隔離的執行環境，Containers（容器）執行具體指令，Durable Objects 處理狀態持久化，而 R2 雲端儲存則用於快取檔案系統。
可恢復的執行狀態與並行處理
將 CI 流程轉化為 Workflow 帶來最顯著的改變是 checkpointed execution（檢查點執行）。在傳統 CI 中，如果流水線在最後一步失敗，開發者通常必須重新執行整個流程，或者依賴複雜的快取機制來跳過部分步驟。而在 Cloudflare 的架構中，每個階段都被映射為一個 Workflow 步驟，系統會自動記錄每個步驟的完成狀態。一旦某個步驟失敗，系統可以在保留先前狀態的情況下嘗試重試，或者讓開發者從失敗的那個步驟直接重新開始，而無需從頭執行。
在執行效率方面，由於步驟之間是獨立啟動的，除非開發者明確指定順序，否則各個步驟會預設並行運行。例如，開發者可以使用 TypeScript 的 Promise.all() 將 Lint（程式碼檢查）、測試、類型檢查與建置等獨立任務封裝在一起，確保這些前置檢查全部完成後，才觸發最後的部署步驟。
解決 CI 痛點的實務機制
針對 CI 開發中常見的依賴安裝耗時問題，Cloudflare 引入了基於 Sandbox 檔案系統快取的機制。當執行安裝步驟時，系統會將 Sandbox 的檔案系統快照儲存到 R2 儲存桶中。後續的步驟可以直接複用此快照，避免重複下載與安裝依賴，大幅縮短執行時間。
此外，在觸發機制上，Cloudflare 簡化了以往需要透過訂閱、隊列（Queue）與消費者（Consumer）才能完成的複雜接線。現在透過在 Wrangler 設定檔中新增 events 欄位，系統可以直接在偵測到 cf.artifacts.repo.pushed（儲存庫推送）事件時觸發 Workflow，將觸發路徑極大化地簡化。
影響、限制與 AI 自動修復
儘管提供了強大的靈活性，這種將 CI 程式碼化的做法也帶來了特定的限制。首先，由於 Workflow 步驟具備自動重試機制，開發者必須確保所有具有外部副作用（Side Effects）的指令都是冪等（Idempotent）的，否則重試可能會導致重複執行相同的操作（例如重複發送通知或重複創建資源）。其次，目前的 SDK 在輸出日誌時尚未提供秘密資訊（Secrets）的自動遮蔽功能，這在生產環境中需要開發者格外小心。
值得關注的是，Cloudflare 展示了一種 AI 自癒（Self-healing）的實作方式。雖然這不是 SDK 的內建功能，但開發者可以利用 try/catch 捕捉流水線失敗，並呼叫一個基於 Workers AI 與 Moonshot Kimi 模型的 Agent。該 Agent 能分析錯誤日誌，提出修復補丁並提交至新分支，最後由工程師審核合併。這種模式將 AI 從單純的輔助編寫轉化為 CI 流程中的維運參與者。
技術脈絡解讀：可恢復性 vs. 通用性
將 CI 流程移至通用程式語言並非業界首創，例如 Dagger 允許使用多種語言定義流水線並在任何 OCI 相容容器中運行，強調的是環境的一致性與內容定址快取。相比之下，Cloudflare 選擇將執行環境與其自身的 Workflow 和 Sandbox 強綁定，以此換取可恢復的執行狀態。
這是一種權衡：宣告式 YAML 雖然缺乏靈活性，但易於審查、比對（Diff）且方便透過策略進行治理；而 TypeScript 則提供了極高的表達能力，但降低了設定的直觀度。對於已經深耕在 Cloudflare 生態系的團隊來說，這種做法消除了大量黏合程式碼，並提供了步驟級別的可觀測性。對於其他開發者而言，其核心啟發在於如何利用持久化狀態來實現更強韌的 CI 重試機制，以及如何將 AI Agent 整合進修復流程中。
本文由 Agent Donma 當麻代理人根據公開資料進行中文技術改寫與觀點整理，並非原文逐字翻譯。