镜像容器：使用Golang玩转Docker API的实践

发布日期：2021-04-27 12:53 | 文章来源：脚本之家

Docker 提供了一个与 Docker 守护进程交互的 API (称为Docker Engine API)，我们可以使用官方提供的 Go 语言的 SDK 进行构建和扩展 Docker 应用程序和解决方案。

安装 SDK

通过下面的命令就可以安装 SDK 了：

go get github.com/docker/docker/client

管理本地的 Docker

该部分会介绍如何使用 Golang + Docker API 进行管理本地的 Docker。

运行容器

第一个例子将展示如何运行容器，相当于 docker run docker.io/library/alpine echo "hello world"：

package main
import (
 "context"
 "io"
 "os"
 "github.com/docker/docker/api/types"
 "github.com/docker/docker/api/types/container"
 "github.com/docker/docker/clie

后台运行容器

还可以在后台运行容器，相当于 docker run -d bfirsh/reticulate-splines：

package main
import (
 "context"
 "fmt"
 "io"
 "os"
 "github.com/docker/docker/api/types"
 "github.com/docker/docker/api/types/container"
 "github.com/docker/docker/clie

查看容器列表

列出正在运行的容器，就像使用 docker ps 一样：

package main
import (
 "context"
 "fmt"
 "github.com/docker/docker/api/types"
 "github.com/docker/docker/clie

如果是 docker ps -a，我们可以通过修改 types.ContainerListOptions 中的 All 属性达到这个目的：

// type ContainerListOptions struct {
// Quiet bool
// Size bool
// All  bool
// Latest bool
// Since string
// Before string
// Limit int
// Filters filters.Args
// }
options := types.ContainerListOptions{
 All: true,
}
containers, err := cli.ContainerList(ctx, options)
if err != nil {
 panic(err)
}

停止所有运行中的容器

通过上面的例子，我们可以获取容器的列表，所以在这个案例中，我们可以去停止所有正在运行的容器。

注意：不要在生产主机上运行下面的代码。

package main
import (
 "context"
 "fmt"
 "github.com/docker/docker/api/types"
 "github.com/docker/docker/clie

获取指定容器的日志

通过指定容器的 ID，我们可以获取对应 ID 的容器的日志：

package main
import (
 "context"
 "io"
 "os"
 "github.com/docker/docker/api/types"
 "github.com/docker/docker/clie

查看镜像列表

获取本地所有的镜像，相当于 docker image ls 或 docker images：

package main
import (
 "context"
 "fmt"
 "github.com/docker/docker/api/types"
 "github.com/docker/docker/clie

拉取镜像

拉取指定镜像，相当于 docker pull alpine：

package main
import (
 "context"
 "io"
 "os"
 "github.com/docker/docker/api/types"
 "github.com/docker/docker/clie

拉取私有镜像

除了公开的镜像，我们平时还会用到一些私有镜像，可以是 DockerHub 上私有镜像，也可以是自托管的镜像仓库，比如 harbor。这个时候，我们需要提供对应的凭证才可以拉取镜像。

值得注意的是：在使用 Docker API 的 Go SDK 时，凭证是以明文的方式进行传输的，所以如果是自建的镜像仓库，请务必使用 HTTPS！

package main
import (
 "context"
 "encoding/base64"
 "encoding/json"
 "io"
 "os"
 "github.com/docker/docker/api/types"
 "github.com/docker/docker/clie

保存容器成镜像

我们可以将一个已有的容器通过 commit 保存成一个镜像：

package main
import (
 "context"
 "fmt"
 "github.com/docker/docker/api/types"
 "github.com/docker/docker/api/types/container"
 "github.com/docker/docker/clie

管理远程的 Docker

当然，除了可以管理本地的 Docker，我们同样也可以通过使用 Golang + Docker API 管理远程的 Docker。

远程连接

默认 Docker 是通过非网络的 Unix 套接字运行的，只能够进行本地通信（/var/run/docker.sock），是不能够直接远程连接 Docker 的。
我们需要编辑配置文件 /etc/docker/daemon.json，并修改以下内容（把 192.168.59.3 改成你自己的 IP 地址），然后重启 Docker：

# vi /etc/docker/daemon.json
{
 "hosts": [
 "tcp://192.168.59.3:2375",
 "unix:///var/run/docker.sock"
 ]
}
systemctl restart docker

修改 client

创建 client 的时候需要指定远程 Docker 的地址，这样就可以像管理本地 Docker 一样管理远程的 Docker 了：

cli, err = client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation(),
 client.WithHost("tcp://192.168.59.3:2375"))

总结

现在已经有很多可以管理 Docker 的产品，它们便是这样进行实现的，比如：portainer。

到此这篇关于使用Golang玩转Docker API的实践的文章就介绍到这了,更多相关Golang运行Docker API内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站！

香港主机台湾主机美国主机日本主机韩国主机海外主机

香港服务器租用国内主机宝塔面板奇亚主机主机节点挖矿主机

上一篇：容器内存：docker 查看进程, 内存, cup消耗的情况

下一篇：容器参数：docker的一些基本指令