Comparation of Docker Go clients

[supereagle]

Choices

• go-dockerclient
• Official client (Used by Openshift S2I)

Both of them implement the Docker Engine API. But go-dockerclient is much EASIER to use as it composes the response of Docker engine APIs.

Take container logs as an example

• go-dockerclient

  
  type LogsOptions struct {
  Context           context.Context
  Container         string        `qs:"-"`
  OutputStream      io.Writer     `qs:"-"`
  ErrorStream       io.Writer     `qs:"-"`
  InactivityTimeout time.Duration `qs:"-"`
  Tail              string
  
  Since      int64
  Follow     bool
  Stdout     bool
  Stderr     bool
  Timestamps bool
  
  // Use raw terminal? Usually true when the container contains a TTY.
  RawTerminal bool `qs:"-"`
  }

func (c *Client) Logs(opts LogsOptions) error { if opts.Container == "" { return &NoSuchContainer{ID: opts.Container} } if opts.Tail == "" { opts.Tail = "all" } path := "/containers/" + opts.Container + "/logs?" + queryString(opts) return c.stream("GET", path, streamOptions{ setRawTerminal: opts.RawTerminal, stdout: opts.OutputStream, stderr: opts.ErrorStream, inactivityTimeout: opts.InactivityTimeout, context: opts.Context, }) }

* Official client
https://github.com/moby/moby/blob/v17.05.0-ce/client/container_logs.go