Package org.mandas.docker.client

Interface DockerClient

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

DefaultDockerClient

public interface DockerClient
extends Closeable

A client for interacting with dockerd.

Note: All methods throw DockerException on unexpected docker response status codes.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static enum	DockerClient.AttachParameter	Parameters for attachContainer(String, AttachParameter...)
static class	DockerClient.BuildParam	Flags which can be passed to the build method.
static class	DockerClient.EventsFilterParam	Filter parameter for events(EventsParam...).
static class	DockerClient.EventsParam	Parameters for events(EventsParam...)
static class	DockerClient.ExecCreateParam	Parameters for execCreate(String, String[], ExecCreateParam...)
static enum	DockerClient.ExecStartParameter	Supported parameters for execStart(java.lang.String, org.mandas.docker.client.DockerClient.ExecStartParameter...).
static interface	DockerClient.FilterParam	Marker interface to designate a parameter as a filter parameter.
static class	DockerClient.ListContainersFilterParam
static class	DockerClient.ListContainersParam	Parameters for listContainers(ListContainersParam...)
static class	DockerClient.ListImagesFilterParam	Filter parameter for listImages(ListImagesParam...).
static class	DockerClient.ListImagesParam	Parameters for listImages(ListImagesParam...).
static class	DockerClient.ListNetworksFilterParam	Filter parameter for listNetworks(ListNetworksParam...).
static class	DockerClient.ListNetworksParam	Parameters for listNetworks(ListNetworksParam...)
static class	DockerClient.ListVolumesFilterParam	Filter parameter for listVolumes(ListVolumesParam...).
static class	DockerClient.ListVolumesParam	Parameters for listVolumes(ListVolumesParam...).
static class	DockerClient.LogsParam	Parameters for logs(String, LogsParam...)
static class	DockerClient.Param
static class	DockerClient.RemoveContainerParam	Parameters for removeContainer(String).
static enum	DockerClient.Signal	Supported parameters for killContainer(String, Signal)).

Method Summary

Modifier and Type	Method	Description
InputStream	archiveContainer(String containerId, String path)	Copies an archive out of a container.
LogStream	attachContainer(String containerId, DockerClient.AttachParameter... params)	Attach to the container id.
int	auth(RegistryAuth registryAuth)	Check auth configuration.
String	build(Path directory, String name, String dockerfile, ProgressHandler handler, DockerClient.BuildParam... params)	Build a docker image.
String	build(Path directory, String name, DockerClient.BuildParam... params)	Build a docker image.
String	build(Path directory, String name, ProgressHandler handler, DockerClient.BuildParam... params)	Build a docker image.
String	build(Path directory, DockerClient.BuildParam... params)	Build a docker image.
String	build(Path directory, ProgressHandler handler, DockerClient.BuildParam... params)	Build a docker image.
void	close()	Closes any and all underlying connections to docker, and release resources.
ContainerCreation	commitContainer(String containerId, String repo, String tag, ContainerConfig config, String comment, String author)	Create a new image from a container's changes.
void	connectToNetwork(String containerId, String networkId)	Connects a docker container to a network.
void	connectToNetwork(String networkId, NetworkConnection networkConnection)	Connects a docker container to a network, with extended configuration.
void	copyToContainer(InputStream tarStream, String containerId, String path)
void	copyToContainer(Path directory, String containerId, String path)	Copies some files from host to container.
void	create(String image, InputStream imagePayload)	Creates a single image from a tarball.
void	create(String image, InputStream imagePayload, ProgressHandler handler)	Creates a single image from a tarball.
ConfigCreateResponse	createConfig(ConfigSpec config)	Create a config.
ContainerCreation	createContainer(ContainerConfig config)	Create a docker container.
ContainerCreation	createContainer(ContainerConfig config, String name)	Create a docker container.
NetworkCreation	createNetwork(NetworkConfig networkConfig)	Create a new network.
SecretCreateResponse	createSecret(SecretSpec secret)	Create a secret.
ServiceCreateResponse	createService(ServiceSpec spec)	Create a new service.
ServiceCreateResponse	createService(ServiceSpec spec, RegistryAuth registryAuth)	Create a new service.
Volume	createVolume()
Volume	createVolume(Volume volume)
void	deleteConfig(String configId)	Delete a config.
void	deleteNode(String nodeId)	Remove a node from the swarm.
void	deleteNode(String nodeId, boolean force)	Remove a node from the swarm.
void	deleteSecret(String secretId)	Delete a secret.
void	disconnectFromNetwork(String containerId, String networkId)	Disconnects a docker container to a network.
void	disconnectFromNetwork(String containerId, String networkId, boolean force)	Disconnects a docker container to a network.
EventStream	events(DockerClient.EventsParam... params)	Watches the docker API for events.
ExecCreation	execCreate(String containerId, String[] cmd, DockerClient.ExecCreateParam... params)	Sets up an exec instance in a running container id.
ExecState	execInspect(String execId)	Inspects a running or previously run exec instance id.
void	execResizeTty(String execId, Integer height, Integer width)	Resizes the tty session used by an exec command.
LogStream	execStart(String execId, DockerClient.ExecStartParameter... params)	Starts a previously set up exec instance id.
InputStream	exportContainer(String containerId)	Export a docker container as a tar archive.
Distribution	getDistribution(String imageName)	Get the distribution of a container.
String	getHost()	Get the Docker host address.
List<ImageHistory>	history(String image)	Return the history of the image.
Info	info()	Get docker instance information.
String	initSwarm(SwarmInit swarmInit)	Initialize a new swarm.
Config	inspectConfig(String configId)	Inspect a config.
ContainerInfo	inspectContainer(String containerId)	Inspect a docker container.
List<ContainerChange>	inspectContainerChanges(String containerId)	Inspect changes on a container's filesystem.
ImageInfo	inspectImage(String image)	Inspect a docker container image.
Network	inspectNetwork(String networkId)	Inspect a specific network.
NodeInfo	inspectNode(String nodeId)	Inspects a swarm node.
Secret	inspectSecret(String secretId)	Inspect a secret.
Service	inspectService(String serviceId)	Inspect an existing service.
Swarm	inspectSwarm()	Inspect the swarm.
Task	inspectTask(String taskId)	Inspect an existing task.
Volume	inspectVolume(String volumeName)
void	joinSwarm(SwarmJoin swarmJoin)	Join an existing swarm.
void	killContainer(String containerId)	Kill a docker container.
void	killContainer(String containerId, DockerClient.Signal signal)	Kill a docker container.
void	leaveSwarm()	Leave a swarm.
void	leaveSwarm(boolean force)	Leave a swarm forcefully.
List<Config>	listConfigs()	List swarm configs.
List<Config>	listConfigs(Config.Criteria criteria)	List swarm configs.
List<Container>	listContainers(DockerClient.ListContainersParam... params)	List docker containers.
List<Image>	listImages(DockerClient.ListImagesParam... params)	List docker images.
List<Network>	listNetworks(DockerClient.ListNetworksParam... params)	List all or a subset of the networks.
List<Node>	listNodes()	List swarm nodes.
List<Node>	listNodes(Node.Criteria criteria)	List swarm nodes that match the given criteria.
List<Secret>	listSecrets()	List secrets.
List<Secret>	listSecrets(Secret.Criteria criteria)	List secrets with criteria.
List<Service>	listServices()	List all services.
List<Service>	listServices(Service.Criteria criteria)	List services that match the given criteria.
List<Task>	listTasks()	List all tasks.
List<Task>	listTasks(Task.Criteria criteria)	List tasks that match the given criteria.
VolumeList	listVolumes(DockerClient.ListVolumesParam... params)
Set<String>	load(InputStream imagePayload)	Load a set of images and tags from a tarball.
Set<String>	load(InputStream imagePayload, ProgressHandler handler)	Load a set of images and tags from a tarball, using a custom ProgressMessageHandler.
LogStream	logs(String containerId, DockerClient.LogsParam... params)	Get docker container logs.
void	pauseContainer(String containerId)	Pause a docker container.
String	ping()	Ping the docker daemon.
void	pull(String image)	Pull a docker container image.
void	pull(String image, RegistryAuth registryAuth)	Pull a private docker container image.
void	pull(String image, RegistryAuth registryAuth, ProgressHandler handler)	Pull a private docker container image, using a custom ProgressMessageHandler.
void	pull(String image, ProgressHandler handler)	Pull a docker container image, using a custom ProgressMessageHandler
void	push(String image)	Push a docker container image.
void	push(String image, RegistryAuth registryAuth)
void	push(String image, ProgressHandler handler)	Push a docker container image, using a custom ProgressHandler
void	push(String image, ProgressHandler handler, RegistryAuth registryAuth)
void	removeContainer(String containerId)	Remove a docker container.
void	removeContainer(String containerId, DockerClient.RemoveContainerParam... params)	Remove a docker container.
List<RemovedImage>	removeImage(String image)	Remove a docker image.
List<RemovedImage>	removeImage(String image, boolean force, boolean noPrune)	Remove a docker image.
void	removeNetwork(String networkId)	Remove a docker network.
void	removeService(String serviceId)	Remove an existing service.
void	removeVolume(String volumeName)
void	removeVolume(Volume volume)
void	renameContainer(String containerId, String name)	Rename a docker container.
void	resizeTty(String containerId, Integer height, Integer width)	Resize container TTY This API is valid only if tty was specified as part of creating the container.
void	restartContainer(String containerId)	Restart a docker container.
void	restartContainer(String containerId, int secondsToWaitBeforeRestart)	Restart a docker container.
InputStream	save(String... images)	Get a tarball containing all images and metadata for the repository specified.
InputStream	saveMultiple(String... images)	Get a tarball containing all images and metadata for one or more repositories.
List<ImageSearchResult>	searchImages(String term)	Search for images on Docker Hub
LogStream	serviceLogs(String serviceId, DockerClient.LogsParam... params)	Get docker service logs.
void	startContainer(String containerId)	Start a docker container.
ContainerStats	stats(String containerId)	Retrieves one-time stats (stream=0) for the container with the specified id.
void	stopContainer(String containerId, int secondsToWaitBeforeKilling)	Stop a docker container by sending a SIGTERM, and following up with a SIGKILL if the container doesn't exit gracefully and in a timely manner.
void	tag(String image, String name)	Tag a docker image.
void	tag(String image, String name, boolean force)	Tag a docker image.
TopResults	topContainer(String containerId)	List processes running inside the container by using ps.
TopResults	topContainer(String containerId, String psArgs)	List processes running inside the container using ps and the given arguments.
void	unlock(UnlockKey unlockKey)	Unlock a swarm.
UnlockKey	unlockKey()	Get an unlock key for unlocking a swarm.
void	unpauseContainer(String containerId)	Unpause a docker container.
void	updateConfig(String configId, Long version, ConfigSpec configSpec)	Update a swarm config.
ContainerUpdate	updateContainer(String containerId, HostConfig config)	Update an existing container.
void	updateNode(String nodeId, Long version, NodeSpec nodeSpec)	Update a swarm node.
void	updateService(String serviceId, Long version, ServiceSpec spec)	Update an existing service.
void	updateService(String serviceId, Long version, ServiceSpec spec, RegistryAuth registryAuth)	Update an existing service.
void	updateSwarm(Long version, boolean rotateWorkerToken, boolean rotateManagerToken, boolean rotateManagerUnlockKey, SwarmSpec spec)	Update a swarm.
void	updateSwarm(Long version, boolean rotateWorkerToken, boolean rotateManagerToken, SwarmSpec spec)	Update a swarm.
void	updateSwarm(Long version, boolean rotateWorkerToken, SwarmSpec spec)	Update a swarm.
void	updateSwarm(Long version, SwarmSpec spec)	Update a swarm.
Version	version()	Get the docker version.
ContainerExit	waitContainer(String containerId)	Wait for a docker container to exit.

Method Details

ping

String ping()
     throws DockerException,
InterruptedException

Ping the docker daemon. Returns "OK" if all is well, though that it simply returns a 200 status is probably sufficient information.

Returns:

String "OK"

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

version

Version version()
         throws DockerException,
InterruptedException

Get the docker version.

Returns:

docker version

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

auth

int auth(RegistryAuth registryAuth)
  throws DockerException,
InterruptedException

Check auth configuration.

Parameters:

registryAuth - The RegistryAuth needed to pull the image.

Returns:

status code of auth request

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

info

Info info()
   throws DockerException,
InterruptedException

Get docker instance information.

Returns:

docker info

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

listContainers

List<Container> listContainers(DockerClient.ListContainersParam... params)
                        throws DockerException,
InterruptedException

List docker containers.

Parameters:

params - Container listing and filtering options.

Returns:

A list of containers.

Throws:

BadParamException - if one or more params were bad (400)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

listImages

List<Image> listImages(DockerClient.ListImagesParam... params)
                throws DockerException,
InterruptedException

List docker images.

Parameters:

params - Image listing and filtering options.

Returns:

A list of images.

Throws:

BadParamException - if one or more params were bad (400)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

inspectContainer

ContainerInfo inspectContainer(String containerId)
                        throws DockerException,
InterruptedException

Inspect a docker container.

Parameters:

containerId - The id of the container to inspect.

Returns:

Info about the container.

Throws:

ContainerNotFoundException - if container was not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

commitContainer

ContainerCreation commitContainer(String containerId,
 String repo,
 String tag,
 ContainerConfig config,
 String comment,
 String author)
                           throws DockerException,
InterruptedException

Create a new image from a container's changes.

Parameters:

containerId - The id of the container to commit.

comment - commit message.

author - image author.

tag - image tag.

repo - repository to commit to.

config - ContainerConfig to commit.

Returns:

ContainerCreation reply.

Throws:

ContainerNotFoundException - if container was not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

inspectImage

ImageInfo inspectImage(String image)
                throws DockerException,
InterruptedException

Inspect a docker container image.

Parameters:

image - The image to inspect.

Returns:

Info about the image.

Throws:

ImageNotFoundException - if image was not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

removeImage

List<RemovedImage> removeImage(String image)
                        throws DockerException,
InterruptedException

Remove a docker image.

Parameters:

image - The image to remove.

Returns:

A list describing each image which was removed.

Throws:

ImageNotFoundException - if image was not found (404)

ConflictException - conflict (409)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

removeImage

List<RemovedImage> removeImage(String image,
 boolean force,
 boolean noPrune)
                        throws DockerException,
InterruptedException

Remove a docker image.

Parameters:

image - The image to remove.

force - Force image removal.

noPrune - Do not delete untagged parents.

Returns:

A list describing each image which was removed.

Throws:

ImageNotFoundException - if image was not found (404)

ConflictException - conflict (409)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

searchImages

List<ImageSearchResult> searchImages(String term)
                              throws DockerException,
InterruptedException

Search for images on Docker Hub

This method is broken for Docker 1.7.x because of a Docker bug. See https://github.com/docker/docker/pull/14850.

Parameters:

term - the search term

Returns:

a list of matches for the given search term

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

load

Set<String> load(InputStream imagePayload)
          throws DockerException,
InterruptedException

Load a set of images and tags from a tarball.

Parameters:

imagePayload - the image's payload (i.e.: the stream corresponding to the image's .tar file).

Returns:

a set of all loaded images

Throws:

DockerException - if a server error occurred (500).

InterruptedException - if the thread is interrupted.

load

Set<String> load(InputStream imagePayload,
 ProgressHandler handler)
          throws DockerException,
InterruptedException

Load a set of images and tags from a tarball, using a custom ProgressMessageHandler.

Parameters:

imagePayload - the image's payload (i.e.: the stream corresponding to the image's .tar file).

handler - The handler to use for processing each progress message received from Docker.

Returns:

a set of all loaded images

Throws:

DockerException - if a server error occurred (500).

InterruptedException - if the thread is interrupted.

create

void create(String image,
 InputStream imagePayload)
     throws DockerException,
InterruptedException

Creates a single image from a tarball. This method also tags the image with the given image name upon loading completion.

Parameters:

image - the name to assign to the image.

imagePayload - the image's payload (i.e.: the stream corresponding to the image's .tar file).

Throws:

DockerException - if a server error occurred (500).

InterruptedException - if the thread is interrupted.

create

void create(String image,
 InputStream imagePayload,
 ProgressHandler handler)
     throws DockerException,
InterruptedException

Creates a single image from a tarball. This method also tags the image with the given image name upon loading completion.

Parameters:

image - the name to assign to the image.

imagePayload - the image's payload (i.e.: the stream corresponding to the image's .tar file).

handler - The handler to use for processing each progress message received from Docker.

Throws:

DockerException - if a server error occurred (500).

InterruptedException - if the thread is interrupted.

save

InputStream save(String... images)
          throws DockerException,
IOException,
InterruptedException

Get a tarball containing all images and metadata for the repository specified.

Parameters:

images - the name(s) of one or more images to save. If a specific name and tag (e.g. ubuntu:latest), then only that image (and its parents) are returned. If an image ID, similarly only that image (and its parents) are returned, but with the exclusion of the 'repositories' file in the tarball, as there were no image names referenced.

Returns:

the images' .tar streams.

Throws:

DockerException - if a server error occurred (500).

IOException - if the server started returning, but an I/O error occurred in the context of processing it on the client-side.

InterruptedException - if the thread is interrupted.

saveMultiple

InputStream saveMultiple(String... images)
                  throws DockerException,
IOException,
InterruptedException

Get a tarball containing all images and metadata for one or more repositories.

Parameters:

images - the name or id of the image to save. if it is a specific name and tag (e.g. ubuntu:latest), then only that image (and its parents) are returned; if it is an image ID, similarly only that image (and its parents) are returned and there would be no names referenced in the 'repositories' file for this image ID.

Returns:

a tar stream containing the image(s)

Throws:

DockerException - if a server error occurred (500).

IOException - if the server started returning, but an I/O error occurred in the context of processing it on the client-side.

InterruptedException - if the thread is interrupted.

topContainer

TopResults topContainer(String containerId)
                 throws DockerException,
InterruptedException

List processes running inside the container by using ps.

Parameters:

containerId - the id of the container to examine

Returns:

the titles and process list for the container

Throws:

DockerException - if a server error occurred (500).

InterruptedException - if the thread is interrupted.

topContainer

TopResults topContainer(String containerId,
 String psArgs)
                 throws DockerException,
InterruptedException

List processes running inside the container using ps and the given arguments.

Parameters:

containerId - the id of the container to examine

psArgs - the arguments to pass to ps inside the container, e.g., "-ef"

Returns:

the titles and process list for the container

Throws:

DockerException - if a server error occurred (500).

InterruptedException - if the thread is interrupted.

pull

void pull(String image)
   throws DockerException,
InterruptedException

Pull a docker container image.

Parameters:

image - The image to pull.

Throws:

ImageNotFoundException - if image was not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

pull

void pull(String image,
 ProgressHandler handler)
   throws DockerException,
InterruptedException

Pull a docker container image, using a custom ProgressMessageHandler

Parameters:

image - The image to pull.

handler - The handler to use for processing each progress message received from Docker.

Throws:

ImageNotFoundException - if image was not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

pull

void pull(String image,
 RegistryAuth registryAuth)
   throws DockerException,
InterruptedException

Pull a private docker container image.

Parameters:

image - The image to pull.

registryAuth - The RegistryAuth needed to pull the image.

Throws:

ImageNotFoundException - if image was not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

pull

void pull(String image,
 RegistryAuth registryAuth,
 ProgressHandler handler)
   throws DockerException,
InterruptedException

Pull a private docker container image, using a custom ProgressMessageHandler.

Parameters:

image - The image to pull.

registryAuth - The RegistryAuth needed to pull the image.

handler - The handler to use for processing each progress message received from Docker.

Throws:

ImageNotFoundException - if image was not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

push

void push(String image)
   throws DockerException,
InterruptedException

Push a docker container image.

Parameters:

image - The image to push.

Throws:

ImageNotFoundException - if image was not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

push

void push(String image,
 ProgressHandler handler)
   throws DockerException,
InterruptedException

Push a docker container image, using a custom ProgressHandler

Parameters:

image - The image to push.

handler - The handler to use for processing each progress message received from Docker.

Throws:

ImageNotFoundException - if image was not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

push

void push(String image,
 RegistryAuth registryAuth)
   throws DockerException,
InterruptedException

Throws:

DockerException

InterruptedException

push

void push(String image,
 ProgressHandler handler,
 RegistryAuth registryAuth)
   throws DockerException,
InterruptedException

Throws:

DockerException

InterruptedException

tag

void tag(String image,
 String name)
  throws DockerException,
InterruptedException

Tag a docker image.

Parameters:

image - The image to tag.

name - The new name that will be applied to the image.

Throws:

BadParamException - if one or more params were bad (400)

ImageNotFoundException - if image was not found (404)

ConflictException - conflict (409)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

tag

void tag(String image,
 String name,
 boolean force)
  throws DockerException,
InterruptedException

Tag a docker image.

Parameters:

image - The image to tag.

name - The new name that will be applied to the image.

force - Whether to force the tagging even if the tag is already assigned to another image.

Throws:

BadParamException - if one or more params were bad (400)

ImageNotFoundException - if image was not found (404)

ConflictException - conflict (409)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

build

String build(Path directory,
 DockerClient.BuildParam... params)
      throws DockerException,
InterruptedException,
IOException

Build a docker image.

Parameters:

directory - The directory containing the dockerfile.

params - Additional flags to use during build.

Returns:

The id of the built image if successful, otherwise null.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

IOException - If some IO shit happened.

build

String build(Path directory,
 String name,
 DockerClient.BuildParam... params)
      throws DockerException,
InterruptedException,
IOException

Build a docker image.

Parameters:

directory - The directory containing the dockerfile.

name - The repository name and optional tag to apply to the built image.

params - Additional flags to use during build.

Returns:

The id of the built image if successful, otherwise null.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

IOException - If some IO shit happened.

build

String build(Path directory,
 ProgressHandler handler,
 DockerClient.BuildParam... params)
      throws DockerException,
InterruptedException,
IOException

Build a docker image.

Parameters:

directory - The directory containing the dockerfile.

handler - The handler to use for processing each progress message received from Docker.

params - Additional flags to use during build.

Returns:

The id of the built image if successful, otherwise null.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

IOException - If some IO shit happened.

build

String build(Path directory,
 String name,
 ProgressHandler handler,
 DockerClient.BuildParam... params)
      throws DockerException,
InterruptedException,
IOException

Build a docker image.

Parameters:

directory - The directory containing the dockerfile.

name - The repository name and optional tag to apply to the built image.

handler - The handler to use for processing each progress message received from Docker.

params - Additional flags to use during build.

Returns:

The id of the built image if successful, otherwise null.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

IOException - If some IO shit happened.

build

String build(Path directory,
 String name,
 String dockerfile,
 ProgressHandler handler,
 DockerClient.BuildParam... params)
      throws DockerException,
InterruptedException,
IOException

Build a docker image.

Parameters:

directory - The directory containing the dockerfile.

name - The repository name and optional tag to apply to the built image.

dockerfile - The path within the build context to the Dockerfile

handler - The handler to use for processing each progress message received from Docker.

params - Additional flags to use during build.

Returns:

The id of the built image if successful, otherwise null.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

IOException - If some IO shit happened.

history

List<ImageHistory> history(String image)
                    throws InterruptedException,
DockerException

Return the history of the image.

Parameters:

image - An image name or ID.

Returns:

A List of ImageHistory

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

createContainer

ContainerCreation createContainer(ContainerConfig config)
                           throws DockerException,
InterruptedException

Create a docker container.

Parameters:

config - The container configuration.

Returns:

Container creation result with container id and eventual warnings from docker.

Throws:

ImageNotFoundException - if the requested parent image was not found (404)

DockerException - if logs cannot be attached, because container is not running (406), or if a server error occurred (500)

InterruptedException - If the thread is interrupted

createContainer

ContainerCreation createContainer(ContainerConfig config,
 String name)
                           throws DockerException,
InterruptedException

Create a docker container.

Parameters:

config - The container configuration.

name - The container name.

Returns:

Container creation result with container id and eventual warnings from docker.

Throws:

ImageNotFoundException - if the requested parent image was not found (404)

DockerException - if logs cannot be attached, because container is not running (406), or if a server error occurred (500)

InterruptedException - If the thread is interrupted

renameContainer

void renameContainer(String containerId,
 String name)
              throws DockerException,
InterruptedException

Rename a docker container.

Parameters:

containerId - The id of the container to rename.

name - The new name the container will have

Throws:

ContainerNotFoundException - if container cannot be found (404)

ContainerRenameConflictException - if name is already assigned (409)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

updateContainer

ContainerUpdate updateContainer(String containerId,
 HostConfig config)
                         throws DockerException,
InterruptedException

Update an existing container. Only available in Docker API >= 1.22.

Parameters:

containerId - the identifier of the container

config - the new container host config

Returns:

the updated container

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

startContainer

void startContainer(String containerId)
             throws DockerException,
InterruptedException

Start a docker container.

Parameters:

containerId - The id of the container to start.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

stopContainer

void stopContainer(String containerId,
 int secondsToWaitBeforeKilling)
            throws DockerException,
InterruptedException

Stop a docker container by sending a SIGTERM, and following up with a SIGKILL if the container doesn't exit gracefully and in a timely manner.

Parameters:

containerId - The id of the container to stop.

secondsToWaitBeforeKilling - Time to wait after SIGTERM before sending SIGKILL.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

pauseContainer

void pauseContainer(String containerId)
             throws DockerException,
InterruptedException

Pause a docker container.

Parameters:

containerId - The id of the container to pause.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

unpauseContainer

void unpauseContainer(String containerId)
               throws DockerException,
InterruptedException

Unpause a docker container.

Parameters:

containerId - The id of the container to pause.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

restartContainer

void restartContainer(String containerId)
               throws DockerException,
InterruptedException

Restart a docker container. with a 10 second default wait

Parameters:

containerId - The id of the container to restart.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

restartContainer

void restartContainer(String containerId,
 int secondsToWaitBeforeRestart)
               throws DockerException,
InterruptedException

Restart a docker container.

Parameters:

containerId - The id of the container to restart.

secondsToWaitBeforeRestart - number of seconds to wait before killing the container.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

waitContainer

ContainerExit waitContainer(String containerId)
                     throws DockerException,
InterruptedException

Wait for a docker container to exit.

Parameters:

containerId - The id of the container to wait for.

Returns:

Exit response with status code.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

killContainer

void killContainer(String containerId)
            throws DockerException,
InterruptedException

Kill a docker container. Note: by default SIGKILL is sent.

Parameters:

containerId - The id of the container to kill.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

killContainer

void killContainer(String containerId,
 DockerClient.Signal signal)
            throws DockerException,
InterruptedException

Kill a docker container.

Parameters:

containerId - The id of the container to kill.

signal - Signal used to kill the process.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

getDistribution

Distribution getDistribution(String imageName)
                      throws DockerException,
InterruptedException

Get the distribution of a container.

Parameters:

imageName - The name of the container.

Returns:

the container's distribution

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

removeContainer

void removeContainer(String containerId)
              throws DockerException,
InterruptedException

Remove a docker container.

Parameters:

containerId - The id of the container to remove.

Throws:

BadParamException - if one or more params were bad (400)

ContainerNotFoundException - if container is not found (404)

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

removeContainer

void removeContainer(String containerId,
 DockerClient.RemoveContainerParam... params)
              throws DockerException,
InterruptedException

Remove a docker container.

Parameters:

containerId - The id of the container to remove.

params - DockerClient.RemoveContainerParam

Throws:

BadParamException - if one or more params were bad (400)

ContainerNotFoundException - if container is not found (404)

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

exportContainer

InputStream exportContainer(String containerId)
                     throws DockerException,
InterruptedException

Export a docker container as a tar archive.

Parameters:

containerId - The id of the container to export.

Returns:

A stream in tar format that contains the contents of the container file system.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

archiveContainer

InputStream archiveContainer(String containerId,
 String path)
                      throws DockerException,
InterruptedException

Copies an archive out of a container. (API version 1.20+)

Parameters:

containerId - The id of the container to copy files from.

path - The path inside of the container to copy. If this is a directory, it will be copied recursively. If this is a file, only that file will be copied.

Returns:

A stream in tar format that contains the copied files. If a directory was copied, the directory will be at the root of the tar archive (so copy(..., "/usr/share") will result in a directory called share in the tar archive). The directory name is completely resolved, so copying "/usr/share/././." will still create a directory called "share" in the tar archive. If a single file was copied, that file will be the sole entry in the tar archive. Copying "." or equivalently "/" will result in the tar archive containing a single folder named after the container ID.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

Since:

1.20

copyToContainer

void copyToContainer(Path directory,
 String containerId,
 String path)
              throws DockerException,
InterruptedException,
IOException

Copies some files from host to container. (API version 1.20+)

Parameters:

directory - The path to sent to container

containerId - The id of the container to sent files.

path - The path inside of the container to put files.

Throws:

BadParamException - if one or more params were bad (400)

PermissionException - if the volume or container root file system is marked "read only"

ContainerNotFoundException - if container is not found (404)

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

IOException - If IOException

Since:

1.20

copyToContainer

void copyToContainer(InputStream tarStream,
 String containerId,
 String path)
              throws DockerException,
InterruptedException,
IOException

Throws:

DockerException

InterruptedException

IOException

inspectContainerChanges

List<ContainerChange> inspectContainerChanges(String containerId)
                                       throws DockerException,
InterruptedException

Inspect changes on a container's filesystem.

Parameters:

containerId - The id of the container.

Returns:

A list of the changes to the container file system.

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

logs

LogStream logs(String containerId,
 DockerClient.LogsParam... params)
        throws DockerException,
InterruptedException

Get docker container logs.

Parameters:

containerId - The id of the container to get logs for.

params - Params for controlling what streams to get and whether to tail or not.

Returns:

A log message stream.

Throws:

BadParamException - if one or more params were bad (400)

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

events

EventStream events(DockerClient.EventsParam... params)
            throws DockerException,
InterruptedException

Watches the docker API for events.

This method is broken for Docker 1.7.x because of a Docker bug. See https://github.com/docker/docker/issues/14354.

Parameters:

params - The parameters to apply to the events request

Returns:

An event stream

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

execCreate

ExecCreation execCreate(String containerId,
 String[] cmd,
 DockerClient.ExecCreateParam... params)
                 throws DockerException,
InterruptedException

Sets up an exec instance in a running container id.

Parameters:

containerId - The id of the container

cmd - shell command

params - Exec params

Returns:

ExecCreation

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

execStart

LogStream execStart(String execId,
 DockerClient.ExecStartParameter... params)
             throws DockerException,
InterruptedException

Starts a previously set up exec instance id. If detach is true, this API returns after starting the exec command. Otherwise, this API sets up an interactive session with the exec command.

Parameters:

execId - exec id

params - Exec start params

Returns:

exec output

Throws:

ExecNotFoundException - if exec instance is not found (404)

ExecStartConflictException - if container is paused (409)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

inspectSwarm

Swarm inspectSwarm()
            throws DockerException,
InterruptedException

Inspect the swarm. Only available in Docker API >= 1.24.

Returns:

Info about a swarm

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

initSwarm

String initSwarm(SwarmInit swarmInit)
          throws DockerException,
InterruptedException

Initialize a new swarm. Only available in Docker API >= 1.24.

Parameters:

swarmInit -

Returns:

Node ID

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

joinSwarm

void joinSwarm(SwarmJoin swarmJoin)
        throws DockerException,
InterruptedException

Join an existing swarm. Only available in Docker API >= 1.24.

Parameters:

swarmJoin - the swarm

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

leaveSwarm

void leaveSwarm()
         throws DockerException,
InterruptedException

Leave a swarm. Only available in Docker API >= 1.24.

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

leaveSwarm

void leaveSwarm(boolean force)
         throws DockerException,
InterruptedException

Leave a swarm forcefully. Only available in Docker API >= 1.24. Force leave swarm, even if this is the last manager or if leaving will break the cluster.

Parameters:

force - Whether to leave forcefully

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

updateSwarm

void updateSwarm(Long version,
 boolean rotateWorkerToken,
 boolean rotateManagerToken,
 boolean rotateManagerUnlockKey,
 SwarmSpec spec)
          throws DockerException,
InterruptedException

Update a swarm. Only available in Docker API >= 1.24.

Parameters:

version - The version number of the swarm object being updated. This is required to avoid conflicting writes.

rotateWorkerToken - Set to true to rotate the worker join token.

rotateManagerToken - Set to true to rotate the worker join token.

rotateManagerUnlockKey - Set to true to rotate the manager unlock key.

spec - SwarmSpec

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

updateSwarm

void updateSwarm(Long version,
 boolean rotateWorkerToken,
 boolean rotateManagerToken,
 SwarmSpec spec)
          throws DockerException,
InterruptedException

Update a swarm. Only available in Docker API >= 1.24.

Parameters:

version - The version number of the swarm object being updated. This is required to avoid conflicting writes.

rotateWorkerToken - Set to true to rotate the worker join token.

rotateManagerToken - Set to true to rotate the worker join token.

spec - SwarmSpec

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

updateSwarm

void updateSwarm(Long version,
 boolean rotateWorkerToken,
 SwarmSpec spec)
          throws DockerException,
InterruptedException

Update a swarm. Only available in Docker API >= 1.24.

Parameters:

version - The version number of the swarm object being updated. This is required to avoid conflicting writes.

rotateWorkerToken - Set to true to rotate the worker join token.

spec - SwarmSpec

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

updateSwarm

void updateSwarm(Long version,
 SwarmSpec spec)
          throws DockerException,
InterruptedException

Update a swarm. Only available in Docker API >= 1.24.

Parameters:

version - The version number of the swarm object being updated. This is required to avoid conflicting writes.

spec - SwarmSpec

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

unlockKey

UnlockKey unlockKey()
             throws DockerException,
InterruptedException

Get an unlock key for unlocking a swarm. Only available in Docker API >= 1.25.

Returns:

UnlockKey

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

unlock

void unlock(UnlockKey unlockKey)
     throws DockerException,
InterruptedException

Unlock a swarm. Only available in Docker API >= 1.25.

Parameters:

unlockKey - UnlockKey

Throws:

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

createService

ServiceCreateResponse createService(ServiceSpec spec)
                             throws DockerException,
InterruptedException

Create a new service. Only available in Docker API >= 1.24.

Parameters:

spec - the service spec

Returns:

Service creation result with service id.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

createService

ServiceCreateResponse createService(ServiceSpec spec,
 RegistryAuth registryAuth)
                             throws DockerException,
InterruptedException

Create a new service. Only available in Docker API >= 1.24.

Parameters:

spec - the service spec

registryAuth - the registry authentication configuration

Returns:

Service creation result with service id.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

inspectService

Service inspectService(String serviceId)
                throws DockerException,
InterruptedException

Inspect an existing service. Only available in Docker API >= 1.24.

Parameters:

serviceId - the id of the service to inspect

Returns:

Info about the service

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

updateService

void updateService(String serviceId,
 Long version,
 ServiceSpec spec)
            throws DockerException,
InterruptedException

Update an existing service. Only available in Docker API >= 1.24.

Parameters:

serviceId - the identifier of the service

version - the version of the service

spec - the new service spec

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

updateService

void updateService(String serviceId,
 Long version,
 ServiceSpec spec,
 RegistryAuth registryAuth)
            throws DockerException,
InterruptedException

Update an existing service. Only available in Docker API >= 1.24.

Parameters:

serviceId - the identifier of the service

version - the version of the service

spec - the new service spec

registryAuth - the registry authentication configuration

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

listServices

List<Service> listServices()
                    throws DockerException,
InterruptedException

List all services. Only available in Docker API >= 1.24.

Returns:

A list of services.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

listServices

List<Service> listServices(Service.Criteria criteria)
                    throws DockerException,
InterruptedException

List services that match the given criteria. Only available in Docker API >= 1.24.

Parameters:

criteria - Service listing and filtering options.

Returns:

A list of Services

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

removeService

void removeService(String serviceId)
            throws DockerException,
InterruptedException

Remove an existing service. Only available in Docker API >= 1.24.

Parameters:

serviceId - the id of the service to remove

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

serviceLogs

LogStream serviceLogs(String serviceId,
 DockerClient.LogsParam... params)
               throws DockerException,
InterruptedException

Get docker service logs.

Parameters:

serviceId - The id of the service to get logs for.

params - Params for controlling what streams to get and whether to tail or not.

Returns:

A log message stream.

Throws:

BadParamException - if one or more params were bad (400)

ServiceNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

inspectTask

Task inspectTask(String taskId)
          throws DockerException,
InterruptedException

Inspect an existing task. Only available in Docker API >= 1.24.

Parameters:

taskId - the id of the task to inspect

Returns:

Info about the task

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

listTasks

List<Task> listTasks()
              throws DockerException,
InterruptedException

List all tasks. Only available in Docker API >= 1.24.

Returns:

A list of tasks.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

listTasks

List<Task> listTasks(Task.Criteria criteria)
              throws DockerException,
InterruptedException

List tasks that match the given criteria. Only available in Docker API >= 1.24.

Parameters:

criteria - Task.Criteria

Returns:

A list of tasks.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

execResizeTty

void execResizeTty(String execId,
 Integer height,
 Integer width)
            throws DockerException,
InterruptedException

Resizes the tty session used by an exec command. This API is valid only if tty was specified as part of creating and starting the exec command.

Parameters:

execId - exec id

height - height of tty session

width - width of tty session

Throws:

BadParamException - if both height and width are null or zero

ExecNotFoundException - if exec instance is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

execInspect

ExecState execInspect(String execId)
               throws DockerException,
InterruptedException

Inspects a running or previously run exec instance id.

Parameters:

execId - exec id

Returns:

state of this exec instance.

Throws:

ExecNotFoundException - if exec instance is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

stats

ContainerStats stats(String containerId)
              throws DockerException,
InterruptedException

Retrieves one-time stats (stream=0) for the container with the specified id.

Parameters:

containerId - The id of the container to retrieve stats for.

Returns:

The container stats

Throws:

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

resizeTty

void resizeTty(String containerId,
 Integer height,
 Integer width)
        throws DockerException,
InterruptedException

Resize container TTY This API is valid only if tty was specified as part of creating the container.

Parameters:

containerId - The id of the container whose TTY will be resized.

height - New height of TTY

width - New width of TTY

Throws:

BadParamException - if both height and width are null or zero

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

listNetworks

List<Network> listNetworks(DockerClient.ListNetworksParam... params)
                    throws DockerException,
InterruptedException

List all or a subset of the networks. Filters were added in Docker 1.10, API version 1.22.

Parameters:

params - the list network parameters

Returns:

networks

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

inspectNetwork

Network inspectNetwork(String networkId)
                throws DockerException,
InterruptedException

Inspect a specific network.

Parameters:

networkId - The id of the network

Returns:

network information

Throws:

NetworkNotFoundException - if network is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

createNetwork

NetworkCreation createNetwork(NetworkConfig networkConfig)
                       throws DockerException,
InterruptedException

Create a new network.

Parameters:

networkConfig - The network creation parameters

Returns:

NetworkCreation

Throws:

NetworkNotFoundException - if network is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

removeNetwork

void removeNetwork(String networkId)
            throws DockerException,
InterruptedException

Remove a docker network.

Parameters:

networkId - The id of the network to remove.

Throws:

NetworkNotFoundException - if network is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

connectToNetwork

void connectToNetwork(String containerId,
 String networkId)
               throws DockerException,
InterruptedException

Connects a docker container to a network.

Parameters:

containerId - The id of the container to connect.

networkId - The id of the network to connect.

Throws:

NotFoundException - if either container or network is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

connectToNetwork

void connectToNetwork(String networkId,
 NetworkConnection networkConnection)
               throws DockerException,
InterruptedException

Connects a docker container to a network, with extended configuration. This is useful when you want to set specific details (aliases, gateway, etc...) for your container inside the network.

Parameters:

networkId - The id of the network to connect.

networkConnection - The target connection parameters.

Throws:

NotFoundException - if either container or network is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - if the thread is interrupted

disconnectFromNetwork

void disconnectFromNetwork(String containerId,
 String networkId)
                    throws DockerException,
InterruptedException

Disconnects a docker container to a network.

Parameters:

containerId - The id of the container to disconnect.

networkId - The id of the network to disconnect.

Throws:

NotFoundException - if either container or network is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

disconnectFromNetwork

void disconnectFromNetwork(String containerId,
 String networkId,
 boolean force)
                    throws DockerException,
InterruptedException

Disconnects a docker container to a network.

Parameters:

containerId - The id of the container to disconnect.

networkId - The id of the network to disconnect.

force - Force the container to disconnect from the network.

Throws:

NotFoundException - if either container or network is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

close

void close()

Closes any and all underlying connections to docker, and release resources.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

attachContainer

LogStream attachContainer(String containerId,
 DockerClient.AttachParameter... params)
                   throws DockerException,
InterruptedException

Attach to the container id.

Parameters:

containerId - The id of the container to get logs for.

params - Params for controlling what streams to get and whether to tail or not.

Returns:

A log message stream.

Throws:

BadParamException - if one or more params were bad (400)

ContainerNotFoundException - if container is not found (404)

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

IllegalStateException - If the container is not running

getHost

String getHost()

Get the Docker host address.

Returns:

the docker host name or IP

createVolume

Volume createVolume()
             throws DockerException,
InterruptedException

Throws:

DockerException

InterruptedException

createVolume

Volume createVolume(Volume volume)
             throws DockerException,
InterruptedException

Throws:

DockerException

InterruptedException

inspectVolume

Volume inspectVolume(String volumeName)
              throws DockerException,
InterruptedException

Throws:

DockerException

InterruptedException

removeVolume

void removeVolume(Volume volume)
           throws DockerException,
InterruptedException

Throws:

DockerException

InterruptedException

removeVolume

void removeVolume(String volumeName)
           throws DockerException,
InterruptedException

Throws:

DockerException

InterruptedException

listVolumes

VolumeList listVolumes(DockerClient.ListVolumesParam... params)
                throws DockerException,
InterruptedException

Throws:

DockerException

InterruptedException

listSecrets

List<Secret> listSecrets()
                  throws DockerException,
InterruptedException

List secrets.

Returns:

A list of Secrets

Throws:

DockerException - if a server error occurred (500)

InterruptedException

Since:

Docker 1.13, API version 1.25

listSecrets

List<Secret> listSecrets(Secret.Criteria criteria)
                  throws DockerException,
InterruptedException

List secrets with criteria.

Parameters:

criteria - Config listing and filtering options

Returns:

A list of Secrets

Throws:

DockerException - if a server error occurred (500)

InterruptedException

Since:

Docker 1.13, API version 1.25

createSecret

SecretCreateResponse createSecret(SecretSpec secret)
                           throws DockerException,
InterruptedException

Create a secret.

Parameters:

secret - The spec for the secret.

Returns:

SecretCreateResponse

Throws:

ConflictException - conflict (409)

DockerException - if node is not part of a swarm (406) or a server error occurred (500)

InterruptedException

Since:

Docker 1.13, API version 1.25

inspectSecret

Secret inspectSecret(String secretId)
              throws DockerException,
InterruptedException

Inspect a secret.

Parameters:

secretId - The id of the secret.

Returns:

Secret

Throws:

NotFoundException - secret not found (404)

DockerException - if node is not part of a swarm (406) or a server error occurred (500)

InterruptedException

Since:

Docker 1.13, API version 1.25

deleteSecret

void deleteSecret(String secretId)
           throws DockerException,
InterruptedException

Delete a secret.

Parameters:

secretId - The id of the secret.

Throws:

NotFoundException - not found (404)

DockerException - if a server error occurred (500)

InterruptedException

Since:

Docker 1.13, API version 1.25

listConfigs

List<Config> listConfigs()
                  throws DockerException,
InterruptedException

List swarm configs. Only available in Docker API >= 1.30.

Returns:

a list of configs

Throws:

DockerException - if a server error occurred (500)

InterruptedException - if the thread is interrupted

Since:

Docker 1.13, API version 1.30

listConfigs

List<Config> listConfigs(Config.Criteria criteria)
                  throws DockerException,
InterruptedException

List swarm configs. Only available in Docker API >= 1.30.

Parameters:

criteria - Config listing and filtering options

Returns:

a list of configs.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - if the thread is interrupted

Since:

Docker 1.13, API version 1.30

createConfig

ConfigCreateResponse createConfig(ConfigSpec config)
                           throws DockerException,
InterruptedException

Create a config. Only available in Docker API >= 1.30.

Parameters:

config - The spec for the config.

Returns:

ConfigCreateResponse

Throws:

ConflictException - conflict (409)

DockerException - if node is not part of a swarm (503) or a server error occurred (500)

InterruptedException

Since:

Docker 1.13, API version 1.30

inspectConfig

Config inspectConfig(String configId)
              throws DockerException,
InterruptedException

Inspect a config. Only available in Docker API >= 1.30.

Parameters:

configId - The id of the config.

Returns:

Config

Throws:

NotFoundException - config not found (404)

DockerException - if node is not part of a swarm (503) or a server error occurred (500)

InterruptedException

Since:

Docker 1.13, API version 1.30

deleteConfig

void deleteConfig(String configId)
           throws DockerException,
InterruptedException

Delete a config. Only available in Docker API >= 1.30.

Parameters:

configId - The id of the config.

Throws:

NotFoundException - config not found (404)

DockerException - if node is not part of a swarm (503) or a server error occurred (500)

InterruptedException

Since:

Docker 1.13, API version 1.30

updateConfig

void updateConfig(String configId,
 Long version,
 ConfigSpec configSpec)
           throws DockerException,
InterruptedException

Update a swarm config. Only available in Docker API >= 1.30.

Parameters:

configId - The id of the config to update

version - The version number of the config object being updated. This is required to avoid conflicting writes

configSpec - the config specification

Throws:

NodeNotFoundException - If the config doesn't exist (404)

NonSwarmNodeException - If the config is not part of a swarm (503)

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

Since:

Docker 1.13, API version 1.30

listNodes

List<Node> listNodes()
              throws DockerException,
InterruptedException

List swarm nodes. Only available in Docker API >= 1.24.

Returns:

A list of nodes.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

Since:

Docker 1.12, API version 1.24

listNodes

List<Node> listNodes(Node.Criteria criteria)
              throws DockerException,
InterruptedException

List swarm nodes that match the given criteria. Only available in Docker API >= 1.24.

Parameters:

criteria - Node listing and filtering options.

Returns:

A list of nodes.

Throws:

DockerException - if a server error occurred (500)

InterruptedException - If the thread is interrupted

Since:

Docker 1.12, API version 1.24

inspectNode

NodeInfo inspectNode(String nodeId)
              throws DockerException,
InterruptedException

Inspects a swarm node. Only available in Docker API >= 1.24.

Parameters:

nodeId - The id of the swarm node to inspect

Returns:

info about the node

Throws:

NonSwarmNodeException - if the node is not part of a swarm (503)

DockerException - if a server error occurred (500)

InterruptedException - if the thread is interrupted

Since:

Docker 1.12, API Version 1.24

updateNode

void updateNode(String nodeId,
 Long version,
 NodeSpec nodeSpec)
         throws DockerException,
InterruptedException

Update a swarm node. Only available in Docker API >= 1.24.

Parameters:

nodeId - The id of the node to update

version - The version number of the node object being updated. This is required to avoid conflicting writes

nodeSpec - the node specification

Throws:

NodeNotFoundException - If the node doesn't exist (404)

NonSwarmNodeException - If the node is not part of a swarm (503)

DockerException - If a server error occurred (500)

InterruptedException - If the thread is interrupted

Since:

Docker 1.12, API version 1.24

deleteNode

void deleteNode(String nodeId)
         throws DockerException,
InterruptedException

Remove a node from the swarm.

Parameters:

nodeId - The id of the node to remove.

Throws:

DockerException

InterruptedException

deleteNode

void deleteNode(String nodeId,
 boolean force)
         throws DockerException,
InterruptedException

Remove a node from the swarm.

Parameters:

nodeId - The id of the node to remove.

force - Forcefully remove the node.

Throws:

DockerException

InterruptedException