使用Golang玩轉Docker API的實踐
更新時間：2021年04月06日 11:26:14 作者：K8sCat
這篇文章主要介紹了使用Golang玩轉Docker API的實踐，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
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/client"
"github.com/docker/docker/pkg/stdcopy"
)
func main() {
ctx := context.Background()
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
if err != nil {
panic(err)
}
reader, err := cli.ImagePull(ctx, "docker.io/library/alpine", types.ImagePullOptions{})
if err != nil {
panic(err)
}
io.Copy(os.Stdout, reader)
resp, err := cli.ContainerCreate(ctx, &container.Config{
Image: "alpine",
Cmd: []string{"echo", "hello world"},
}, nil, nil, "")
if err != nil {
panic(err)
}
if err := cli.ContainerStart(ctx, resp.ID, types.ContainerStartOptions{}); err != nil {
panic(err)
}
statusCh, errCh := cli.ContainerWait(ctx, resp.ID, container.WaitConditionNotRunning)
select {
case err := <-errCh:
if err != nil {
panic(err)
}
case <-statusCh:
}
out, err := cli.ContainerLogs(ctx, resp.ID, types.ContainerLogsOptions{ShowStdout: true})
if err != nil {
panic(err)
}
stdcopy.StdCopy(os.Stdout, os.Stderr, out)
}
后臺運行容器
還可以在后臺運行容器，相當于 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/client"
)
func main() {
ctx := context.Background()
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
if err != nil {
panic(err)
}
imageName := "bfirsh/reticulate-splines"
out, err := cli.ImagePull(ctx, imageName, types.ImagePullOptions{})
if err != nil {
panic(err)
}
io.Copy(os.Stdout, out)
resp, err := cli.ContainerCreate(ctx, &container.Config{
Image: imageName,
}, nil, nil, "")
if err != nil {
panic(err)
}
if err := cli.ContainerStart(ctx, resp.ID, types.ContainerStartOptions{}); err != nil {
panic(err)
}
fmt.Println(resp.ID)
}
查看容器列表
列出正在運行的容器，就像使用 docker ps 一樣：
package main
import (
"context"
"fmt"
"github.com/docker/docker/api/types"
"github.com/docker/docker/client"
)
func main() {
ctx := context.Background()
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
if err != nil {
panic(err)
}
containers, err := cli.ContainerList(ctx, types.ContainerListOptions{})
if err != nil {
panic(err)
}
for _, container := range containers {
fmt.Println(container.ID)
}
}
如果是 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)
}
停止所有運行中的容器
通過上面的例子，我們可以獲取容器的列表，所以在這個案例中，我們可以去停止所有正在運行的容器。
注意：不要在生產(chǎn)服務器上運行下面的代碼。
package main
import (
"context"
"fmt"
"github.com/docker/docker/api/types"
"github.com/docker/docker/client"
)
func main() {
ctx := context.Background()
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
if err != nil {
panic(err)
}
containers, err := cli.ContainerList(ctx, types.ContainerListOptions{})
if err != nil {
panic(err)
}
for _, container := range containers {
fmt.Print("Stopping container ", container.ID[:10], "... ")
if err := cli.ContainerStop(ctx, container.ID, nil); err != nil {
panic(err)
}
fmt.Println("Success")
}
}
獲取指定容器的日志
通過指定容器的 ID，我們可以獲取對應 ID 的容器的日志：
package main
import (
"context"
"io"
"os"
"github.com/docker/docker/api/types"
"github.com/docker/docker/client"
)
func main() {
ctx := context.Background()
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
if err != nil {
panic(err)
}
options := types.ContainerLogsOptions{ShowStdout: true}
out, err := cli.ContainerLogs(ctx, "f1064a8a4c82", options)
if err != nil {
panic(err)
}
io.Copy(os.Stdout, out)
}
查看鏡像列表
獲取本地所有的鏡像，相當于 docker image ls 或 docker images：
package main
import (
"context"
"fmt"
"github.com/docker/docker/api/types"
"github.com/docker/docker/client"
)
func main() {
ctx := context.Background()
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
if err != nil {
panic(err)
}
images, err := cli.ImageList(ctx, types.ImageListOptions{})
if err != nil {
panic(err)
}
for _, image := range images {
fmt.Println(image.ID)
}
}
拉取鏡像
拉取指定鏡像，相當于 docker pull alpine：
package main
import (
"context"
"io"
"os"
"github.com/docker/docker/api/types"
"github.com/docker/docker/client"
)
func main() {
ctx := context.Background()
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
if err != nil {
panic(err)
}
out, err := cli.ImagePull(ctx, "alpine", types.ImagePullOptions{})
if err != nil {
panic(err)
}
defer out.Close()
io.Copy(os.Stdout, out)
}
拉取私有鏡像
除了公開的鏡像，我們平時還會用到一些私有鏡像，可以是 DockerHub 上私有鏡像，也可以是自托管的鏡像倉庫，比如 harbor。這個時候，我們需要提供對應的憑證才可以拉取鏡像。
值得注意的是：在使用 Docker API 的 Go SDK 時，憑證是以明文的方式進行傳輸?shù)?，所以如果是自建的鏡像倉庫，請務必使用 HTTPS！
package main
import (
"context"
"encoding/base64"
"encoding/json"
"io"
"os"
"github.com/docker/docker/api/types"
"github.com/docker/docker/client"
)
func main() {
ctx := context.Background()
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
if err != nil {
panic(err)
}
authConfig := types.AuthConfig{
Username: "username",
Password: "password",
}
encodedJSON, err := json.Marshal(authConfig)
if err != nil {
panic(err)
}
authStr := base64.URLEncoding.EncodeToString(encodedJSON)
out, err := cli.ImagePull(ctx, "alpine", types.ImagePullOptions{RegistryAuth: authStr})
if err != nil {
panic(err)
}
defer out.Close()
io.Copy(os.Stdout, out)
}
保存容器成鏡像
我們可以將一個已有的容器通過 commit 保存成一個鏡像：
package main
import (
"context"
"fmt"
"github.com/docker/docker/api/types"
"github.com/docker/docker/api/types/container"
"github.com/docker/docker/client"
)
func main() {
ctx := context.Background()
cli, err := client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation())
if err != nil {
panic(err)
}
createResp, err := cli.ContainerCreate(ctx, &container.Config{
Image: "alpine",
Cmd: []string{"touch", "/helloworld"},
}, nil, nil, "")
if err != nil {
panic(err)
}
if err := cli.ContainerStart(ctx, createResp.ID, types.ContainerStartOptions{}); err != nil {
panic(err)
}
statusCh, errCh := cli.ContainerWait(ctx, createResp.ID, container.WaitConditionNotRunning)
select {
case err := <-errCh:
if err != nil {
panic(err)
}
case <-statusCh:
}
commitResp, err := cli.ContainerCommit(ctx, createResp.ID, types.ContainerCommitOptions{Reference: "helloworld"})
if err != nil {
panic(err)
}
fmt.Println(commitResp.ID)
}
管理遠程的 Docker
當然，除了可以管理本地的 Docker， 我們同樣也可以通過使用 Golang + Docker API 管理遠程的 Docker。
遠程連接
默認 Docker 是通過非網(wǎng)絡的 Unix 套接字運行的，只能夠進行本地通信（/var/run/docker.sock），是不能夠直接遠程連接 Docker 的。
我們需要編輯配置文件 /etc/docker/daemon.json，并修改以下內(nèi)容（把 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
創(chuàng)建 client 的時候需要指定遠程 Docker 的地址，這樣就可以像管理本地 Docker 一樣管理遠程的 Docker 了：
cli, err = client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation(),
client.WithHost("tcp://192.168.59.3:2375"))
總結
現(xiàn)在已經(jīng)有很多可以管理 Docker 的產(chǎn)品，它們便是這樣進行實現(xiàn)的，比如：portainer。
到此這篇關于使用Golang玩轉Docker API的實踐的文章就介紹到這了,更多相關Golang運行Docker API內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
這篇文章主要介紹了Docker容器和本機之間的文件傳輸方法，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2019-03-03
本篇文章主要介紹了Docker如何使用Dockerfile構建鏡像，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-05-05
本文主要介紹了Docker安裝mysql并解決中文亂碼問題本人親自測試，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2021-12-12
Docker是一個開源的容器引擎,基于go語言開發(fā)并遵循了apache2.0協(xié)議開源,下面這篇文章主要給大家介紹了關于Docker鏡像與容器的導入導出以及常用命令總結的相關資料,文中通過實例代碼介紹的非常詳細,需要的朋友可以參考下2022-08-08
大家好，本篇文章主要講的是docke自定義網(wǎng)絡之容器互聯(lián)，感興趣的同學趕快來看一看吧，對你有幫助的話記得收藏一下，方便下次瀏覽2021-12-12
一次Docker中Redis連接暴增的問題排查實戰(zhàn)記錄
這篇文章主要給大家介紹了一次Docker中Redis連接暴增的問題排查的相關資料，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面來一起學習學習吧2020-06-06
開源框架?Matrix-Dendrite?搭建聊天服務器的詳細過程
Matrix?是一個開源、可交互、去中心化的實時通信服務框架。使用?Matrix?可以搭建安全的通信服務器，配合支持?Matrix?的客戶端可以實現(xiàn)個人、團隊間的實時聊天交互，對Matrix?Dendrite搭建聊天服務器的過程感興趣的朋友一起看看吧2022-03-03
在本篇文章里小編給大家整理的是關于Docker及Docker-Compose的實例用法，需要的朋友們可以學習參考下。2020-02-02
Windows Server 2016 安裝 Docker的過程及遇到問題
若要在 Windows Server 上安裝 Docker，可以使用由 Microsoft 發(fā)布的 OneGet 提供程序 PowerShell 模塊，接下來通過本文給大家介紹Windows Server 2016 安裝 Docker的過程及遇到問題，一起看看吧2021-09-09
Docker鏡像拉取報錯:Error response from daemon:
這篇文章主要介紹了Docker鏡像拉取報錯:Error response from daemon: Get https://registry-1.docker.io/v2/的問題解決,本文給大家介紹的非常詳細，對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2023-07-07