docker.io/go-docker
Official Go SDK for Docker
Dependency management tool is required
This repository describes its dependencies in a Gopkg.toml
file as created by the dep
tool.
It also uses semantic versioning, and requires its users to use dep
-compatible dependency management tools to ensure stability and avoid breaking changes.
The canonical import path is docker.io/go-docker
.
Note: you may download it with go get -d docker.io/go-docker
, but if you omit -d
, you may have compile errors. Hence the dep
approach is preferred.
dep
in your project
How to use You can use any tool that is compatible, but in the examples below we are using dep
.
vendor/
Adding dependency to $ cd $GOPATH/src/myproject
$ dep init # only if first time use
$ dep ensure -add docker.io/go-docker@v1 # to use the latest version of v1.x.y
Updating dependency
$ cd $GOPATH/src/myproject
$ edit Gopkg.toml
$ dep ensure
Reference Documentation
Issues
Feel free to open issues on the Github issue tracker.
github.com/docker/docker/client
Migrating from If you were previously depending on github.com/docker/docker/client
, you can run the following in bash
to start using docker.io/go-docker
v1 and benefiting from semantic versioning guarantees.
files=( $(find . -name '*.go' -not -path './vendor/*') )
for rule in \
's|"github.com/docker/docker/api|"docker.io/go-docker/api|' \
's|^([[:space:]]+)"github.com/docker/docker/client|\1client "docker.io/go-docker|' \
's|"github.com/docker/docker/client|"docker.io/go-docker|' \
; do
sed -i -E "$rule" ${files[*]}
done
Note that if you aliased any import they will be preserved.