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

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

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

1. 环境准备

bash 复制代码

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. 创建并运行容器

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

go 复制代码

package main

import (
	"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 捕获容器日志。

go 复制代码

package main

import (
	"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:

dockerfile 复制代码

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

Go 代码:

go 复制代码

package main

import (
	"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 打包成 tar
	dockerfile := []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，需要登录信息。

go 复制代码

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 中同样可以指定平台。

go 复制代码

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 合并为多架构镜像

示例：

go 复制代码

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)
}

然后再用命令行或 SDK 调用 docker manifest API 将这些镜像合并成一个 multi-arch 镜像。

总结

通过 Go SDK，我们实现了：

创建和运行容器
捕获日志
构建和推送镜像
多架构构建流程

适合场景：

内部 CI/CD 系统
自动化构建平台
IoT / 边缘计算环境中的动态部署