CircleCI

目標:做一個本機優先的自用 CI/CD 工作台,從 Git 儲存庫觸發可重現的測試與建置工作。 技術棧建議:Python FastAPI + SQLite + Docker SDK,前端用原生 HTML/CSS/JavaScript,工作執行以 Docker container 為主。 需求: - 讀取本機 Git 儲存庫,支援手動觸發與定時觸發建置 - 使用 YAML 定義 pipeline、job、步驟、環境變數與依賴順序 - 每個 job 在獨立 Docker container 執行,限制 CPU、記憶體與最長執行時間 - 支援 shell 指令、工作目錄、映像檔與成功條件設定 - 以有向無環圖順序執行相依 job,可平行執行沒有依賴的 job - 即時顯示執行狀態、每一步的標準輸出與錯誤輸出 - 支援成功、失敗、逾時、取消與重試狀態,可手動停止執行中的 job - 保存每次建置的 log、commit、分支、開始時間、結束時間與執行結果 - 支援指定目錄作為建置產物,提供下載與刪除功能 - 以內容 hash 快取指定目錄,可設定快取鍵與清除快取 - 建置完成後可透過桌面通知或 SMTP 寄送成功與失敗通知 - 提供管理頁查看 pipeline、歷史建置、job 詳情與磁碟用量 - 所有 pipeline、建置記錄與設定都能匯出為 JSON、YAML 或 ZIP 明確不做(out of scope):多人帳號與權限、公開託管 runner、跨區域高可用、雲端併發擴充、完整 GitHub/GitLab OAuth、正式金鑰託管與商用 SLA。 README 要求:說明本機安裝、Docker 權限、YAML 格式、環境變數、pipeline 範例、匯出與還原方式,並列出不適合放入秘密的設定。