عندما تقرر كتابة دراجتك للقبض على الخطافات من محور عامل الإرساء أو من السجل لتحديث / بدء الحاويات تلقائيًا على الخادم ، يمكن أن يكون Docker Cli مفيدًا للمساعدة في إدارة Docker daemon على نظامك.
للعمل ، تحتاج إلى إصدار 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)
}
الحصول على قائمة بالصور
هذا المثال يعادل تشغيل الأمر 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 الرسمية HTTPS ،
يجب أيضًا تكوين السجلات الخاصة للتواصل باستخدام 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)
}
المصدر: www.habr.com