如何使用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 < 30; i++ {
    inspect, _ := cli.ContainerInspect(ctx, containerID)
    if inspect.State.Status == "exited" {
        break
    }
    time.Sleep(500 * time.Millisecond)
}

删除容器前先确认是否在运行，否则 `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())
}