当前位置：首页 > news >正文

使用 Go SDK 玩转 Docker：从容器到多架构构建

news 2025/9/28 6:46:41

使用 Go SDK 玩转 Docker：从容器到多架构构建

Docker 提供了丰富的命令行工具，但在某些场景下（如平台开发、CI/CD 系统、自动化工具），我们更希望直接在代码里调用 Docker API。Go SDK 是官方推荐的方式，可以直接通过 Go 语言管理 Docker 容器、镜像和构建流程。

本文将带你使用 Go SDK（github.com/docker/docker/client）实现几个典型的功能，并展示如何进行多架构镜像构建。

1. 环境准备

go mod init docker-sdk-demo
go get github.com/docker/docker/client
go get github.com/docker/docker/api/types
go get github.com/docker/docker/api/types/container
go get github.com/docker/docker/api/types/strslice

2. 创建并运行容器

最简单的例子就是拉取镜像并运行一个容器。

package mainimport ("context""fmt""github.com/docker/docker/api/types/container""github.com/docker/docker/client"
)func main() {ctx := context.Background()cli, _ := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())// 创建容器resp, err := cli.ContainerCreate(ctx, &container.Config{Image: "alpine",Cmd:   []string{"echo", "Hello from Docker SDK"},}, nil, nil, nil, "my-alpine")if err != nil {panic(err)}// 启动容器if err := cli.ContainerStart(ctx, resp.ID, container.StartOptions{}); err != nil {panic(err)}fmt.Println("容器已启动:", resp.ID[:10])
}

运行结果会打印一行 Hello from Docker SDK。

3. 执行命令并获取日志

除了运行一次性命令，还可以通过 SDK 捕获容器日志。

package mainimport ("context""fmt""io""os""github.com/docker/docker/api/types""github.com/docker/docker/api/types/container""github.com/docker/docker/client"
)func main() {ctx := context.Background()cli, _ := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())resp, _ := cli.ContainerCreate(ctx, &container.Config{Image: "alpine",Cmd:   []string{"sh", "-c", "echo hello && sleep 2 && echo world"},}, nil, nil, nil, "")cli.ContainerStart(ctx, resp.ID, container.StartOptions{})// 获取日志out, _ := cli.ContainerLogs(ctx, resp.ID, types.ContainerLogsOptions{ShowStdout: true, Follow: true})io.Copy(os.Stdout, out)
}

输出将会是：

hello
world

4. 构建镜像（单架构）

我们先来实现一个基本的镜像构建。

Dockerfile:

FROM alpine
CMD ["echo", "Hello from custom image"]

Go 代码:

package mainimport ("archive/tar""bytes""context""os""github.com/docker/docker/api/types""github.com/docker/docker/client"
)func main() {ctx := context.Background()cli, _ := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())// 将 Dockerfile 打包成 tardockerfile := []byte(`FROM alpine
CMD ["echo", "Hello from custom image"]`)buf := new(bytes.Buffer)tw := tar.NewWriter(buf)tw.WriteHeader(&tar.Header{Name: "Dockerfile",Size: int64(len(dockerfile)),})tw.Write(dockerfile)tw.Close()// 构建镜像buildResp, _ := cli.ImageBuild(ctx, buf, types.ImageBuildOptions{Tags:       []string{"myimage:latest"},Dockerfile: "Dockerfile",Remove:     true,})defer buildResp.Body.Close()io.Copy(os.Stdout, buildResp.Body)
}

运行后就能得到 myimage:latest。

5. 推送镜像到仓库

要推送到 Docker Hub 或 GitHub Packages，需要登录信息。

import ("encoding/base64""encoding/json"
)authConfig := types.AuthConfig{Username: "myuser",Password: "mypassword",
}
encodedJSON, _ := json.Marshal(authConfig)
authStr := base64.URLEncoding.EncodeToString(encodedJSON)// 推送镜像
pushResp, _ := cli.ImagePush(ctx, "myuser/myimage:latest", types.ImagePushOptions{RegistryAuth: authStr,
})
defer pushResp.Close()
io.Copy(os.Stdout, pushResp)

6. 多架构构建

Docker 官方推荐使用 buildx 进行多架构构建。但在 SDK 中同样可以指定平台。

import "github.com/docker/docker/api/types/versions"options := types.ImageBuildOptions{Tags:     []string{"myuser/myimage:multi"},Platform: "linux/amd64,linux/arm64", // 多架构
}

不过 Go SDK 直接支持单平台构建，要实现多平台通常需要借助 docker buildx bake 或者 buildkitd。一种可行做法是：

在 SDK 中分平台循环构建
推送到远端 registry
通过 docker manifest create 合并为多架构镜像

示例：

platforms := []string{"linux/amd64", "linux/arm64"}for _, p := range platforms {buildResp, _ := cli.ImageBuild(ctx, buf, types.ImageBuildOptions{Tags:     []string{"myuser/myimage:" + p},Platform: p,Remove:   true,})io.Copy(os.Stdout, buildResp.Body)
}