telegraf/Godeps/_workspace/src/github.com/fsouza/go-dockerclient
Cameron Sparr 1d741cbfc5 Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
..
external/github.com godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
testing Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
.gitignore Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
.travis.yml Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
AUTHORS Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
DOCKER-LICENSE godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
LICENSE godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
Makefile godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
README.markdown godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
auth.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
auth_test.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
build_test.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
change.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
change_test.go godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
client.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
client_test.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
container.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
container_test.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
env.go godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
env_test.go godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
event.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
event_test.go godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
example_test.go godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
exec.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
exec_test.go godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
image.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
image_test.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
misc.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
misc_test.go godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
network.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
network_test.go godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
signal.go godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
tar.go godep: vendor all dependencies & add circle-test.sh 2015-08-17 17:38:44 -06:00
tls.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
volume.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00
volume_test.go Update godep of go-dockerclient for Label access 2015-09-23 14:25:26 -07:00

README.markdown

go-dockerclient

Drone Travis GoDoc

This package presents a client for the Docker remote API. It also provides support for the extensions in the Swarm API.

This package also provides support for docker's network API, which is a simple passthrough to the libnetwork remote API. Note that docker's network API is only available in docker 1.8 and above, and only enabled in docker if DOCKER_EXPERIMENTAL is defined during the docker build process.

For more details, check the remote API documentation.

Vendoring

If you are having issues with Go 1.5 and have GO15VENDOREXPERIMENT set with an application that has go-dockerclient vendored, please update your vendoring of go-dockerclient :) We recently moved the vendor directory to external so that go-dockerclient is compatible with this configuration. See 338 and 339 for details.

Example

package main

import (
	"fmt"

	"github.com/fsouza/go-dockerclient"
)

func main() {
	endpoint := "unix:///var/run/docker.sock"
	client, _ := docker.NewClient(endpoint)
	imgs, _ := client.ListImages(docker.ListImagesOptions{All: false})
	for _, img := range imgs {
		fmt.Println("ID: ", img.ID)
		fmt.Println("RepoTags: ", img.RepoTags)
		fmt.Println("Created: ", img.Created)
		fmt.Println("Size: ", img.Size)
		fmt.Println("VirtualSize: ", img.VirtualSize)
		fmt.Println("ParentId: ", img.ParentID)
	}
}

Using with TLS

In order to instantiate the client for a TLS-enabled daemon, you should use NewTLSClient, passing the endpoint and path for key and certificates as parameters.

package main

import (
	"fmt"

	"github.com/fsouza/go-dockerclient"
)

func main() {
	endpoint := "tcp://[ip]:[port]"
	path := os.Getenv("DOCKER_CERT_PATH")
	ca := fmt.Sprintf("%s/ca.pem", path)
	cert := fmt.Sprintf("%s/cert.pem", path)
	key := fmt.Sprintf("%s/key.pem", path)
	client, _ := docker.NewTLSClient(endpoint, cert, key, ca)
	// use client
}

If using docker-machine, or another application that exports environment variables DOCKER_HOST, DOCKER_TLS_VERIFY, DOCKER_CERT_PATH, you can use NewClientFromEnv.

package main

import (
	"fmt"

	"github.com/fsouza/go-dockerclient"
)

func main() {
	client, _ := docker.NewClientFromEnv()
	// use client
}

See the documentation for more details.

Developing

All development commands can be seen in the Makefile.

Commited code must pass:

Running make test will check all of these. If your editor does not automatically call gofmt, make fmt will format all go files in this repository.