761 B

Raw Blame History

ADR-0008：部署仅支持 Docker Compose v2 + Engine ≥ 25

状态：Accepted
触发背景：服务器上旧版 docker-compose v1（Python 实现）在 Docker Engine 25+ 上因读取 ContainerConfig 字段崩溃（KeyError: 'ContainerConfig'）。

决策

仅支持 Docker Compose v2（docker compose 子命令）部署；弃用 v1。deploy.sh 中 get_compose_cmd 优先探测 v2，回退 v1 仅作兼容提示。

后果

升级路径：安装 docker-compose-plugin（v2）并卸载 v1 后即可用 ./deploy.sh upgrade 或 docker compose up -d --build。
docker-compose.yml 顶部 version: 仅产生弃用警告，不影响功能。

关联

NFR-6, OI-2；部署细节见 DEPLOY.md、README_DOCKER.md。