Zarządzanie kontenerami Docker w Go

Dokumentacja!

Kiedy zdecydujesz się napisać swój skrypt do pobierania obrazów z Docker Hub lub z rejestru do automatycznej aktualizacji/startu kontenerów na serwerze, przydatne będzie Docker CLI, które pomoże zarządzać demonem Docker w twoim systemie.

Do pracy wymagana jest wersja Go nie niższa niż 1.9.4

Jeśli jeszcze nie przeszedłeś na moduły, zainstaluj CLI następującą komendą:

go get github.com/docker/docker/client

Uruchamianie kontenera

Następny przykład pokazuje, jak uruchomić kontener za pomocą API Docker. W wierszu poleceń użyłbyś polecenia docker run, ale bez trudu poradzimy sobie z tym zadaniem w naszym serwisie.
Ten przykład odpowiada uruchomieniu polecenia docker run alpine echo hello world

package main {
    ctx := context.Background()
    cli, err := client.NewEnvClient()
    if err != nil {
        panic(err)
    }

    

    // Pobieramy obraz 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("Nie można uzyskać portu")
    }
    portBinding := nat.PortMap{containerPort: []nat.PortBinding{hostBinding}}

    

    // Tworzymy kontener z zaprogramowaną konfiguracją
    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)
    }

    

    // Uruchamiamy kontener
    if err := cli.ContainerStart(ctx, resp.ID, types.ContainerStartOptions{}); err != nil {
        panic(err)
    }

    

    // Odbieramy logi kontenera
    out, err := cli.ContainerLogs(ctx, resp.ID, types.ContainerLogsOptions{ShowStdout: true})
    if err != nil {
        panic(err)
    }
    io.Copy(os.Stdout, out)
}

Pobieranie listy uruchomionych kontenerów

Ten przykład odpowiada uruchomieniu polecenia 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)
    }

    // Pobieranie listy uruchomionych kontenerów (docker ps)
    containers, err := cli.ContainerList(context.Background(), types.ContainerListOptions{})
    if err != nil {
        panic(err)
    }

    // Wyświetlanie wszystkich identyfikatorów kontenerów
    for _, container := range containers {
        fmt.Println(container.ID)
    }
}

Zatrzymywanie wszystkich uruchomionych kontenerów

Po tym, jak nauczyłeś się tworzyć i uruchamiać kontenery, nadszedł czas, aby nauczyć się nimi zarządzać. Następny przykład zatrzyma wszystkie uruchomione kontenery.

Nie uruchamiaj tego kodu w środowisku produkcyjnym serwerze!

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)
    }

    // Pobieranie listy uruchomionych kontenerów (docker ps)
    containers, err := cli.ContainerList(ctx, types.ContainerListOptions{})
    if err != nil {
        panic(err)
    }

    for _, c := range containers {
        fmt.Print("Zatrzymywanie kontenera ", c.ID[:10], "... ")
        if err := cli.ContainerStop(ctx, c.ID, nil); err != nil {
            panic(err)
        }
        fmt.Println("Sukces")
    }
}

Wyświetlanie logów pojedynczego kontenera

Możesz pracować z pojedynczymi kontenerami. W następnym przykładzie wyświetlane są logi kontenera o podanym identyfikatorze. Przed uruchomieniem należy zmienić identyfikator kontenera, których logi chcesz uzyskać.

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}
    // Zmień id kontenera tutaj
    out, err := cli.ContainerLogs(ctx, "f1064a8a4c82", options)
    if err != nil {
        panic(err)
    }
    io.Copy(os.Stdout, out)
}

Pobieranie listy obrazów

Ten przykład odpowiada uruchomieniu polecenia 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)
    }

    // Pobieranie listy obrazów
    images, err := cli.ImageList(context.Background(), types.ImageListOptions{})
    if err != nil {
        panic(err)
    }

    for _, image := range images {
        fmt.Println(image.ID)
    }
}

Pobierz

Ten przykład odpowiada uruchomieniu polecenia 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)
}

Pobieranie obrazu z autoryzacją użytkownika

Ten przykład odpowiada uruchomieniu polecenia docker pull, z autoryzacją.

Dane autoryzacyjne są przesyłane w formie otwartej. Oficjalne rejestry docker wykorzystują HTTPS,
prywatne rejestry również powinny być skonfigurowane do przesyłania danych z użyciem 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)
    }

    // Tworzenie konfiguracji z danymi do uwierzytelniania
    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)
}

Źródło: habr.com