Golang管理Docker容器全攻略

从现在开始，我们要努力学习啦！今天我给大家带来《Golang管理Docker容器方法详解》，感兴趣的朋友请继续看下去吧！下文中的内容我们主要会涉及到等等知识点，如果在阅读本文过程中有遇到不清楚的地方，欢迎留言呀！我们一起讨论，一起学习！

使用 docker-go 启动容器必须显式设置 HostConfig，否则容器会立即退出；ContainerStop 是异步操作，需轮询 ContainerInspect 确认状态变为 "exited" 再执行删除。

用 docker-go 启动容器时必须显式设置 HostConfig

Go 调用 Docker API 启动容器，不填 HostConfig 会导致容器启动后立刻退出（状态为 Exited (0)）。这是因为默认配置下容器没有绑定任何终端、没指定重启策略、也没分配资源限制，Docker 守护进程认为它“完成任务”就结束了。

• HostConfig 至少要包含 AutoRemove: false 和 RestartPolicy（如需自动重启）
• 若运行的是交互式命令（如 /bin/sh），必须同时设 AttachStdin: true、AttachStdout: true、Tty: true
• 使用 docker-go 的 ContainerCreate 时，HostConfig 是独立参数，不能塞进 Config 里

resp, err := cli.ContainerCreate(ctx, &container.Config{
    Image: "alpine:latest",
    Cmd:   []string{"/bin/sh", "-c", "sleep 30"},
}, &container.HostConfig{
    AutoRemove: false,
    RestartPolicy: container.RestartPolicy{
        Name: "no",
    },
}, nil, nil, "my-container")

停止容器别只调 ContainerStop，得等状态真正变更

ContainerStop 是异步触发，调完立即返回，不代表容器已停。直接跟 ContainerRemove 连用大概率报错 conflict: unable to remove filesystem for xxx: device or resource busy。

• 必须轮询 ContainerInspect 查 State.Status 是否变成 "exited"
• 建议加超时（比如 15 秒），避免卡死；time.Sleep 固定延时不可靠，容器负载高时可能还没停完
• 注意：State.Status 是字符串，不是布尔值，别写成 if state.Status == true

err := cli.ContainerStop(ctx, containerID, container.StopOptions{Timeout: 10})
if err != nil {
    return err
}
// 等待真正停止
for i := 0; i 
删除容器前先确认是否在运行，否则 ContainerRemove 会失败
即使容器已退出，ContainerRemove 默认不删，除非显式传 Force: true 或 RemoveVolumes: true。但更稳妥的做法是先 Inspect 再判断——尤其在批量清理场景下，避免误删还在跑的同名容器。

• ContainerRemove 的 Force 参数相当于 docker rm -f，会强制终止再删，慎用
• 如果容器挂载了匿名卷，且你希望一并清理，必须设 RemoveVolumes: true，否则卷残留
• 错误信息典型是：Error response from daemon: conflict: unable to remove repository reference ... (must force)

inspect, _ := cli.ContainerInspect(ctx, containerID)
if inspect.State.Running {
    // 可选：先 stop，或直接 force remove
}
_, err := cli.ContainerRemove(ctx, containerID, types.ContainerRemoveOptions{
    Force:         true,
    RemoveVolumes: true,
})

容器日志读取要用 ContainerLogs 流式处理，别一次性读完

容器日志量大时，ContainerLogs 返回的 io.ReadCloser 如果直接 io.ReadAll，容易 OOM。尤其日志没做轮转、容器跑了几天的情况。

• 用 bufio.Scanner 按行读，或 io.Copy 流式导出到文件
• 注意设置 stdout/stderr 选项，否则可能拿不到任何输出（默认两者都关）
• 日志时间戳默认不带纳秒级精度，如需对齐业务时间，得自己加 Since/Until 参数过滤

logs, _ := cli.ContainerLogs(ctx, containerID, types.ContainerLogsOptions{
    ShowStdout: true,
    ShowStderr: true,
    Timestamps: true,
})
scanner := bufio.NewScanner(logs)
for scanner.Scan() {
    fmt.Println(scanner.Text())
}

Docker 容器生命周期控制的坑，多数出在「假设 API 是同步的」或「忽略状态检查」。Go 客户端不会替你等容器停稳，也不会帮你判断该不该强删——这些逻辑得自己写清楚，尤其在自动化脚本或 operator 场景里。

今天关于《Golang管理Docker容器全攻略》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！