Калі вы вырашыце напісаць, свой ровар па лоўлі хукаў з docker hub або з registry для аўтаматычнага абнаўлення/запуску кантэйнераў на серверы, вам можа спатрэбіцца Docker Cli, які дапаможа кіраваць дэманам Docker у вашай сістэме.
Для працы спатрэбіцца Go версіі не ніжэй за 1.9.4
Калі вы ўсё яшчэ не перайшлі на модулі ўсталюеце Cli наступнай камандай:
go get github.com/docker/docker/client
Запуск кантэйнера
Наступны прыклад паказвае як запусціць кантэйнер з дапамогай Docker API. У камандным радку вы б выкарыстоўвалі каманду docker run
, але мы без працы зладзімся з гэтай задачай у нашым сэрвісе.
Гэты прыклад эквівалентны запуску каманды docker run alpine echo hello world
package main {
ctx := context.Background()
cli, err := client.NewEnvClient()
if err != nil {
panic(err)
}
// Делаем docker pull
reader, err := cli.ImagePull(ctx, "docker.io/library/alpine", types.ImagePullOptions{})
if err != nil {
panic(err)
}
io.Copy(os.Stdout, reader)
hostBinding := nat.PortBinding{
HostIP: "0.0.0.0",
HostPort: "8000",
}
containerPort, err := nat.NewPort("tcp", "80")
if err != nil {
panic("Unable to get the port")
}
portBinding := nat.PortMap{containerPort: []nat.PortBinding{hostBinding}}
// Создаем контейнер с заданной конфигурацией
resp, err := cli.ContainerCreate(ctx, &container.Config{
Image: "alpine",
Cmd: []string{"echo", "hello world"},
Tty: true,
}, &container.HostConfig{
PortBindings: portBinding,
}, nil, "")
if err != nil {
panic(err)
}
// Запускаем контейнер
if err := cli.ContainerStart(ctx, resp.ID, types.ContainerStartOptions{}); err != nil {
panic(err)
}
// Получаем логи контейнера
out, err := cli.ContainerLogs(ctx, resp.ID, types.ContainerLogsOptions{ShowStdout: true})
if err != nil {
panic(err)
}
io.Copy(os.Stdout, out)
}
Атрыманне спісу запушчаных кантэйнераў
Гэты прыклад эквівалентны запуску каманды docker ps
package main
import (
"context"
"fmt"
"github.com/docker/docker/api/types"
"github.com/docker/docker/client"
)
func main() {
cli, err := client.NewEnvClient()
if err != nil {
panic(err)
}
// Получение списка запуцщенных контейнеров(docker ps)
containers, err := cli.ContainerList(context.Background(), types.ContainerListOptions{})
if err != nil {
panic(err)
}
// Вывод всех идентификаторов контейнеров
for _, container := range containers {
fmt.Println(container.ID)
}
}
Прыпынак усіх запушчаных кантэйнераў
Пасля таго як вы навучыліся ствараць і запускаць кантэйнеры, прыйшоў час навучыцца кіраваць імі. Наступны прыклад спыніць усе запушчаныя кантэйнеры.
Не запускайце гэты код на прадакшн серверы!
package main
import (
"context"
"fmt"
"github.com/docker/docker/api/types"
"github.com/docker/docker/client"
)
func main() {
ctx := context.Background()
cli, err := client.NewEnvClient()
if err != nil {
panic(err)
}
// Получение списка запуцщенных контейнеров(docker ps)
containers, err := cli.ContainerList(ctx, types.ContainerListOptions{})
if err != nil {
panic(err)
}
for _, c := range containers {
fmt.Print("Stopping container ", c.ID[:10], "... ")
if err := cli.ContainerStop(ctx, c.ID, nil); err != nil {
panic(err)
}
fmt.Println("Success")
}
}
Вывад логаў асобна ўзятага кантэйнера
Вы можаце працаваць з асобна ўзятымі кантэйнерамі. У наступным прыкладзе выводзяцца логі кантэйнера з паказаным ідэнтыфікатарам. Перад запускам вам трэба змяніць ідэнтыфікатар кантэйнера, чые логі вы хочаце атрымаць.
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.NewEnvClient()
if err != nil {
panic(err)
}
options := types.ContainerLogsOptions{ShowStdout: true}
// Измените id контейнера здесь
out, err := cli.ContainerLogs(ctx, "f1064a8a4c82", options)
if err != nil {
panic(err)
}
io.Copy(os.Stdout, out)
}
Атрыманне спіса images
Гэты прыклад эквівалентны запуску каманды docker image ls
package main
import (
"context"
"fmt"
"github.com/docker/docker/api/types"
"github.com/docker/docker/client"
)
func main() {
cli, err := client.NewEnvClient()
if err != nil {
panic(err)
}
// Получение списка образов
images, err := cli.ImageList(context.Background(), types.ImageListOptions{})
if err != nil {
panic(err)
}
for _, image := range images {
fmt.Println(image.ID)
}
}
Пацягнуць
Гэты прыклад эквівалентны запуску каманды docker pull
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.NewEnvClient()
if err != nil {
panic(err)
}
// docker pull alpine
out, err := cli.ImagePull(ctx, "docker.io/library/alpine", types.ImagePullOptions{})
if err != nil {
panic(err)
}
defer out.Close()
io.Copy(os.Stdout, out)
}
Спампоўка выявы з аўтэнтыфікацыяй карыстальніка
Гэты прыклад эквівалентны запуску каманды docker pull
, з аўтэнтыфікацыяй.
Дадзеныя аўтэнтыфікацыі адпраўляюцца ў адчыненым выглядзе. Афіцыйныя docker registry выкарыстоўваюць HTTPS,
прыватныя registry таксама павінны быць настроены на перадачу дадзеных з выкарыстаннем 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.NewEnvClient()
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, "docker.io/library/alpine", types.ImagePullOptions{RegistryAuth: authStr})
if err != nil {
panic(err)
}
defer out.Close()
io.Copy(os.Stdout, out)
}
Крыніца: habr.com