Golang - Docker API - 解析ImagePull的结果

时间:2017-06-09 08:14:29

标签: docker go docker-api

我正在开发一个Go脚本,该脚本使用Docker API来实现我的项目。登录到我的存储库之后,我拉出了我想要的Docker镜像,但问题是ImagePull函数返回io.ReadCloser的实例,我只能传递给系统输出通过:

io.Copy(os.Stdout, pullResp)

很酷我可以看到响应,但是我找不到一个合适的方法来解析它并根据它来实现逻辑,如果新版本的图像会做一些事情已下载,如果图像是最新的,还有其他内容 如果你有经验,如果你遇到过这个问题,我会很高兴。

3 个答案:

答案 0 :(得分:2)

@radoslav-stoyanov在使用我的例子之前做了

# docker rmi busybox

然后运行代码

package main

import (
    "encoding/json"
    "fmt"
    "github.com/docker/distribution/context"
    docker "github.com/docker/engine-api/client"
    "github.com/docker/engine-api/types"
    "io"
    "strings"
)

func main() {
    // DOCKER
    cli, err := docker.NewClient("unix:///var/run/docker.sock", "v1.28", nil, map[string]string{"User-Agent": "engine-api-cli-1.0"})
    if err != nil {
        panic(err)
    }

    imageName := "busybox:latest"

    events, err := cli.ImagePull(context.Background(), imageName, types.ImagePullOptions{})
    if err != nil {
        panic(err)
    }

    d := json.NewDecoder(events)

    type Event struct {
        Status         string `json:"status"`
        Error          string `json:"error"`
        Progress       string `json:"progress"`
        ProgressDetail struct {
            Current int `json:"current"`
            Total   int `json:"total"`
        } `json:"progressDetail"`
    }

    var event *Event
    for {
        if err := d.Decode(&event); err != nil {
            if err == io.EOF {
                break
            }

            panic(err)
        }

        fmt.Printf("EVENT: %+v\n", event)
    }

    // Latest event for new image
    // EVENT: {Status:Status: Downloaded newer image for busybox:latest Error: Progress:[==================================================>]  699.2kB/699.2kB ProgressDetail:{Current:699243 Total:699243}}
    // Latest event for up-to-date image
    // EVENT: {Status:Status: Image is up to date for busybox:latest Error: Progress: ProgressDetail:{Current:0 Total:0}}
    if event != nil {
        if strings.Contains(event.Status, fmt.Sprintf("Downloaded newer image for %s", imageName)) {
            // new
            fmt.Println("new")
        }

        if strings.Contains(event.Status, fmt.Sprintf("Image is up to date for %s", imageName)) {
            // up-to-date
            fmt.Println("up-to-date")
        }
    }
}

您可以看到用于创建结构的API格式(例如我的Event),以便在此处阅读https://docs.docker.com/engine/api/v1.27/#operation/ImageCreate

我希望它可以帮助您解决问题,谢谢。

答案 1 :(得分:1)

您可以导入github.com/docker/docker/pkg/jsonmessage并同时使用JSONMessageJSONProgress对流进行解码,但更容易调用 DisplayJSONMessagesToStream:它解析流并将消息显示为文本。以下是使用stderr显示消息的方法:

    reader, err := cli.ImagePull(ctx, myImageRef, types.ImagePullOptions{})
    if err != nil {
            return err
    }
    defer reader.Close()

    termFd, isTerm := term.GetFdInfo(os.Stderr)
    jsonmessage.DisplayJSONMessagesStream(reader, os.Stderr, termFd, isTerm, nil)

好处是它适应输出:如果这是TTY(docker pull的方式),它会更新行,但如果输出被重定向到文件则不会更新。

答案 2 :(得分:0)

我为我的目的使用了类似的方法(不是moby客户端)。通常,读取流响应的想法是相同的。试一试并实施你的。

读取任何响应类型的流响应:

reader := bufio.NewReader(pullResp)
defer pullResp.Close()  // pullResp is io.ReadCloser
var resp bytes.Buffer
for {
    line, err := reader.ReadBytes('\n')
    if err != nil {
        // it could be EOF or read error
        // handle it
        break
    }
    resp.Write(line)
    resp.WriteByte('\n')
}

// print it
fmt.Println(resp.String())

但是,评论中的示例响应似乎是有效的JSON结构。 json.Decoder是阅读JSON流的最佳方式。这只是一个想法 -

type ImagePullResponse struct {
   ID             string `json"id"`
   Status         string `json:"status"`
   ProgressDetail struct {
     Current int64 `json:"current"`
     Total   int64 `json:"total"`
   } `json:"progressDetail"`
   Progress string `json:"progress"`
}

并且

d := json.NewDecoder(pullResp)
for {
   var pullResult ImagePullResponse
  if err := d.Decode(&pullResult); err != nil {
    // handle the error
    break
  }
  fmt.Println(pullResult)
}