使用Golang玩轉(zhuǎn)Docker API的實踐
Docker 提供了一個與 Docker 守護進程交互的 API (稱為Docker Engine API),我們可以使用官方提供的 Go 語言的 SDK 進行構(gòu)建和擴展 Docker 應(yīng)用程序和解決方案。
安裝 SDK
通過下面的命令就可以安裝 SDK 了:
go get github.com/docker/docker/client
管理本地的 Docker
該部分會介紹如何使用 Golang + Docker API 進行管理本地的 Docker。
運行容器
第一個例子將展示如何運行容器,相當(dāng)于 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
后臺運行容器
還可以在后臺運行容器,相當(dāng)于 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 屬性達(dá)到這個目的:
// 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)服務(wù)器上運行下面的代碼。
package main import ( "context" "fmt" "github.com/docker/docker/api/types" "github.com/docker/docker/clie
獲取指定容器的日志
通過指定容器的 ID,我們可以獲取對應(yīng) ID 的容器的日志:
package main import ( "context" "io" "os" "github.com/docker/docker/api/types" "github.com/docker/docker/clie
查看鏡像列表
獲取本地所有的鏡像,相當(dāng)于 docker image ls 或 docker images:
package main import ( "context" "fmt" "github.com/docker/docker/api/types" "github.com/docker/docker/clie
拉取鏡像
拉取指定鏡像,相當(dāng)于 docker pull alpine:
package main import ( "context" "io" "os" "github.com/docker/docker/api/types" "github.com/docker/docker/clie
拉取私有鏡像
除了公開的鏡像,我們平時還會用到一些私有鏡像,可以是 DockerHub 上私有鏡像,也可以是自托管的鏡像倉庫,比如 harbor。這個時候,我們需要提供對應(yīng)的憑證才可以拉取鏡像。
值得注意的是:在使用 Docker API 的 Go SDK 時,憑證是以明文的方式進行傳輸?shù)?,所以如果是自建的鏡像倉庫,請務(wù)必使用 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
管理遠(yuǎn)程的 Docker
當(dāng)然,除了可以管理本地的 Docker, 我們同樣也可以通過使用 Golang + Docker API 管理遠(yuǎn)程的 Docker。
遠(yuǎn)程連接
默認(rèn) Docker 是通過非網(wǎng)絡(luò)的 Unix 套接字運行的,只能夠進行本地通信(/var/run/docker.sock),是不能夠直接遠(yuǎn)程連接 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 的時候需要指定遠(yuǎn)程 Docker 的地址,這樣就可以像管理本地 Docker 一樣管理遠(yuǎn)程的 Docker 了:
cli, err = client.NewClientWithOpts(client.FromEnv, client.WithAPIVersionNegotiation(), client.WithHost("tcp://192.168.59.3:2375"))
總結(jié)
現(xiàn)在已經(jīng)有很多可以管理 Docker 的產(chǎn)品,它們便是這樣進行實現(xiàn)的,比如:portainer。
到此這篇關(guān)于使用Golang玩轉(zhuǎn)Docker API的實踐的文章就介紹到這了,更多相關(guān)Golang運行Docker API內(nèi)容請搜索本站以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持本站!
版權(quán)聲明:本站文章來源標(biāo)注為YINGSOO的內(nèi)容版權(quán)均為本站所有,歡迎引用、轉(zhuǎn)載,請保持原文完整并注明來源及原文鏈接。禁止復(fù)制或仿造本網(wǎng)站,禁止在非www.sddonglingsh.com所屬的服務(wù)器上建立鏡像,否則將依法追究法律責(zé)任。本站部分內(nèi)容來源于網(wǎng)友推薦、互聯(lián)網(wǎng)收集整理而來,僅供學(xué)習(xí)參考,不代表本站立場,如有內(nèi)容涉嫌侵權(quán),請聯(lián)系alex-e#qq.com處理。