容器与云原生 / 知识点

Docker Compose 配置与运维速查手册

手册条目

确认当前 Docker Compose CLI 版本及命令是否可用。

检查 Docker Compose 版本

用于确认当前终端是否已加载 Compose CLI、实际版本号以及自动化脚本应调用哪种命令。版本检查不读取项目配置,也不需要 Docker 守护进程正在运行。

基本语法

优先检查新版插件式命令;--short 只输出版本号,更适合脚本采集和版本比较。

bash
docker compose version
docker compose version --short

预期输出

text
Docker Compose version v<VERSION>
<VERSION>

<VERSION> 会随安装版本变化。第一行出现 Docker Compose version 表示子命令可用;第二行应只有版本号,不要在脚本中解析第一行的展示文本。

快速排障

同时检查 Docker CLI 路径、CLI 版本和 Compose 子命令,可快速区分“Docker 未安装”与“Compose 插件缺失”。

bash
command -v docker
docker --version
docker compose version

预期输出

text
<PATH>/docker
Docker version <DOCKER_VERSION>, build <ID>
Docker Compose version v<VERSION>

若第一条无输出或提示 docker: command not found,先修复 Docker CLI 安装或 PATH。若 Docker 可用但第三条提示 docker: 'compose' is not a docker command,说明当前 CLI 未发现 Compose 插件,应安装或恢复插件,而不是反复重启业务容器。

风险与边界

不要把 docker --version 当作 Compose 版本,两者独立发布。脚本需要版本号时使用 docker compose version --short,并允许前导 v 差异;硬编码完整展示文本会在升级后导致误判。

旧环境可能只有 docker-compose version。它通常代表独立的旧式可执行文件,行为和升级路径可能与 docker compose 不同。生产脚本应统一一种调用方式,并在切换前完成配置解析和启动验证。

速查结论

看到完整版本或短版本号即可确认命令可用;只有 Docker CLI 版本、没有 Compose 输出,不能视为 Compose 已安装。

目录与阅读设置

记录一个想法

Docker Compose 配置与运维速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通