K8s 叢集建立與復原平台：以 AI Agent 開發的內部工具
從零建置 K8s 叢集與長期 LAB 練習，讓我清楚它的複雜與上手門檻。為了讓 MIS 也能自行建立與做基礎設定，2025-08 起以 AI Agent 開發 Go 管理平台：在 Proxmox 上 20–30 分鐘建立一套地端 VM 版 K8s 叢集（依硬體 I/O 而定），並以分項驗收確認備份與復原能力。
本人範圍
需求與使用情境、架構與元件選型、K8s 領域知識、驗收標準、實體主機實測。Go 程式碼由 AI Agent 產出，本人負責閱讀、審查與驗證。
做法
- Claude Code 協作開發；Go、React、OpenTofu、Proxmox API。
- 單一控制器整合版本化 API、SQLite／WAL 工作流程、OpenTofu／Proxmox 佈建與 mTLS 節點 Agent；叢集元件與復原能力依版本和驗收紀錄確認。
- 自備實體 Proxmox 主機反覆測試建立、加入節點與還原。
驗證方式
實體主機上完整建立與還原演練；產品處 K8s 測試叢集 POC 成功；單元測試全數通過。
結果
| 指標 | 數值 | 出處 | 資料來源 |
|---|---|---|---|
| 建立一套地端 VM 版 K8s 叢集 | 20–30 分鐘（保守估計） | 本人實測 | 本人估計 |
| 單元測試 | 5,099 個通過 5,020、略過 79、失敗 0 | go test -short，2026-10-21 | 系統紀錄 |
| 整體敘述覆蓋率 | 52.2%（domain 層 78.5%） | 同上 | 系統紀錄 |
| 相關投入工時 | 656.5 h | 工時表，2024–2026 | 系統紀錄 |
| 工時拆分：本人／AI 執行 | 本人約 277 h、AI 執行約 380 h | 本人估計；2025-02-22 起依當期人機比例拆分，僅計公司登記工時 | 本人估計 |
限制與後續
Go 語言層面依賴 AI Agent。覆蓋率 0% 的套件多為程式進入點、自動產生的 gRPC 程式與測試輔助。最終定位為測試環境的快速建立與復原工具，未用於正式環境。
使用技術
- Go
- React
- OpenTofu
- Proxmox
- RKE2
- Longhorn
- Calico
- Claude Code