如何判断 docker exec 命令是否执行完成-Golang-PHP中文网

如何判断 docker exec 命令是否执行完成

Docker 提供了两种官方机制判断 docker exec 命令是否结束：非分离模式下 WebSocket 自动关闭即表示完成；分离模式下可通过 /exec/{id}/json 接口轮询 Running 字段状态。

docker 提供了两种官方机制判断 `docker exec` 命令是否结束：非分离模式下 websocket 自动关闭即表示完成；分离模式下可通过 `/exec/{id}/json` 接口轮询 `running` 字段状态。

在使用 Docker REST API 执行容器内命令（例如触发 Maven 构建）时，准确感知命令生命周期至关重要——这直接关系到构建结果的获取、错误处理和后续流程编排。Docker 原生支持两种可靠的方式实现完成态检测：

✅ 方式一：非分离模式（Detach: false）——推荐用于短时同步任务
当调用 /exec/{id}/start 时，不设置 Detach: true（即保持 Detach: false），Docker 会将 exec 进程的标准输入/输出/错误流通过 WebSocket 或长连接返回，并在命令退出后自动关闭连接。客户端只需监听连接关闭事件（如 onclose 或 HTTP 流 EOF），即可确认命令已终止。此时还可通过响应头中的 X-Content-Length 或响应体末尾的 {"stream":false,"error":"..."} 结构获取退出码与错误信息（需启用 Tty: false 以获得结构化输出）。

示例（cURL 启动非分离 exec 并等待结束）：

# 1. 创建 exec 实例（注意：Stdin=true, Tty=false）
curl -s -X POST \
  --header "Content-Type: application/json" \
  --data '{"AttachStdin":true,"AttachStdout":true,"AttachStderr":true,"Cmd":["mvn","clean","package"],"Tty":false,"Privileged":false}' \
  http://localhost:2375/v1.25/containers/my-app/exec

# 响应返回 exec ID，例如：{"Id":"abc123..."}
# 2. 启动 exec 并阻塞等待完成（WebSocket 或 HTTP chunked stream）
curl -s -N -X POST \
  --header "Content-Type: application/json" \
  --data '{"Detach":false,"Tty":false}' \
  http://localhost:2375/v1.25/exec/abc123/start
# → 连接将在 mvn 命令退出后自动断开

✅ 方式二：分离模式（Detach: true）——适用于后台长期任务或需复用连接场景
若必须分离执行（如避免连接阻塞），则需配合 /exec/{id}/json 接口轮询。关键字段为 Running（布尔值）和 ExitCode（整数）。当 Running 变为 false 且 ExitCode 存在时，即表示命令已退出。建议轮询间隔 ≥500ms，避免高频请求影响 API 性能。

# 轮询检查（Bash 示例）
EXEC_ID="abc123"
while true; do
  status=$(curl -s http://localhost:2375/v1.25/exec/$EXEC_ID/json | jq '.Running')
  if [[ "$status" == "false" ]]; then
    exit_code=$(curl -s http://localhost:2375/v1.25/exec/$EXEC_ID/json | jq '.ExitCode')
    echo "Command finished with exit code: $exit_code"
    break
  fi
  sleep 1
done

⚠️ 注意事项与常见陷阱

Docker Cli

使用 Docker CLI 构建、运行、停止、检查和管理容器与镜像的助手。用于执行容器相关任务。

下载

若通过 exec 启动交互式 shell（如 /bin/sh）并持续写入命令但未关闭 stdin，shell 将保持运行状态（Running: true），即使所有命令已执行完毕——这与宿主机中 sh -c 'cmd' 的行为一致。解决方案是显式关闭 stdin（如 curl 中不传 --data-binary @- 或发送 FIN 包），或改用非交互式执行（如 sh -c 'mvn clean package'）。
Tty: true 会禁用结构化输出，导致无法可靠解析 ExitCode，生产环境建议始终设为 false。
所有 exec 实例默认无超时，长时间运行任务建议在应用层添加超时控制（如 timeout 命令包裹或客户端定时中断）。