部署紀錄
最後更新
本頁說明 CLI 在每次操作時送給 API Server 的部署資訊與操作紀錄,以及
dismiss 旗標的轉換。回報時機
| 函式 | 呼叫時機 | API | 失敗處理 |
|---|---|---|---|
removePod() | up 清掉舊容器後、clear 開始時、down 結束後 | POST /api/pod/update/:uid,body 為 dismiss 設 1、其餘欄位皆為零值的 Pod | 忽略 |
upsertPod() | up 結束時 | POST /api/pod/upsert | 回傳錯誤,up 視為失敗 |
recordPod() | 每個指令結束時,以及同步時 | POST /api/pod/record/insert | 忽略 |
CLI 固定連往
http://localhost:8080,API Server 未啟動時 up 會在最後一步回報 failed to upsert pod,但遠端容器已經啟動。紀錄內容
records.content 的值:| 值 | 來源 |
|---|---|
sync | 遠端目錄為空,首次同步 |
overwrite | 差異預覽後確認覆寫 |
up | up 完成 |
clear | clear 完成 |
down/ps/logs/restart/exec/build | 轉送指令完成,值為指令名稱 |
每筆紀錄另存執行 CLI 的主機名稱與第一個非 loopback IPv4。
records.pod_id 以 uid 查 pods.id 寫入,且欄位為 NOT NULL;首次部署的 sync 紀錄發生在 pods 寫入之前,查不到 pods.id,寫入會失敗並被忽略。dismiss 狀態
stateDiagram-v2
[*] --> 有效: up(upsert)
有效 --> 已移除: down/clear/重新 up 前清理
已移除 --> 有效: up(upsert 重設 dismiss=0)
已移除 --> [*]- stateDiagram-v2
- [*] --> 有效: up(upsert)
- 有效 --> 已移除: down/clear/重新 up 前清理
- 已移除 --> 有效: up(upsert 重設 dismiss=0)
- 已移除 --> [*]
GET /api/pod/list 只列出 dismiss = 0 的部署。upsertPod() 將 status 寫為 starting;removePod() 送出空的 status,因此已移除的部署 status = ''。資料庫位置
| 條件 | 路徑 |
|---|---|
設定 DB_PATH | DB_PATH 的值 |
存在 /.dockerenv | /data/database.db |
| 其他 | ~/.podrun/database.db,目錄不存在時自動建立 |
資料表結構見 HTTP API。