16 lines
761 B
Markdown
16 lines
761 B
Markdown
# 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`。
|
||
|