Docker 容器
在 agent 工作階段中啟動的容器也可以設定壽命。
powershell
obit docker add web-1 3d # 按名字或 ID 登记一个容器,三天后到期
obit docker list # 登记了哪些容器(--json 可用)
obit resurrect <编号> # 到期被停下的容器重新启动只管容器
訃告只管理容器。資料卷存放資料,一旦刪除便無法復原,因此訃告一律不動資料卷、映像檔和網路。
到期只停止容器
- 執行
docker stop後,容器和它的可寫層都會保留。obit resurrect <编号>會執行docker start,並停止追蹤容器的壽命。 - 保留期(
[graveyard] retention_days,預設 7 天)結束後才會用docker rm移除容器,絕不帶-v或-f。 - 那時容器要是在執行(被你或別人手動啟動過),就當作復活,不刪。
- 即使用
obit purge或--all,也要等容器的保留期結束。資源回收筒模式不適用於容器:仍是先停止,保留期過後才移除。
以完整 ID 識別容器
- 名字只用於顯示;每次停、啟、刪之前都重新核對完整 ID 和建立時間,對不上就不動。
- 訃告會記錄容器所屬的 Docker context 和 daemon,往後只對該 daemon 操作,切換
docker context不會改變操作對象。 - 容器被你在訃告之外刪掉了,訃告會把它記成「外部移除」並清掉記錄。
- 設了
--rm(AutoRemove)的容器停下就會被 Docker 自己刪掉,訃告拒絕登記它。
自動登記工作階段中的容器
自動登記預設關閉;此時訃告不會尋找容器,你仍可用 obit docker add 自行登記。開啟後,訃告會在工作階段結束時,從背景尋找這段期間建立的容器,只納入 Compose 工作目錄或繫結掛載位於專案內的容器。其他容器可能是你在別處啟動的,不會受影響。符合條件的容器會登記 3 天壽命,事後通知你;用 obit spare <编号> 取消後,同一工作階段不會再次登記該容器。如果工作階段不在 Git 專案內(例如從家目錄啟動),或有多個工作階段認領同一個容器,就無法確定是誰啟動的,只會列為提議等你核准。設為 [proposals] mode = "ask" 時也會先提出建議,執行 obit approve 後才開始追蹤。
每個容器最多只會產生一項提議。Hook 不會呼叫 Docker;如果未安裝或未啟動 Docker,訃告會直接略過,obit doctor 可查看原因。Docker 未執行時不能核准容器提議,obit proposals 和小視窗的「待你決定」頁都會說明;啟動 Docker 後即可核准。