public class DefaultDockerClient extends Object implements DockerClient, Closeable
| Modifier and Type | Class and Description |
|---|---|
static class |
DefaultDockerClient.Builder |
DockerClient.AttachParameter, DockerClient.BuildParam, DockerClient.EventsFilterParam, DockerClient.EventsParam, DockerClient.ExecCreateParam, DockerClient.ExecStartParameter, DockerClient.ListContainersFilterParam, DockerClient.ListContainersParam, DockerClient.ListImagesFilterParam, DockerClient.ListImagesParam, DockerClient.ListVolumesFilterParam, DockerClient.ListVolumesParam, DockerClient.LogsParam, DockerClient.RemoveContainerParam| Modifier | Constructor and Description |
|---|---|
protected |
DefaultDockerClient(DefaultDockerClient.Builder builder)
Create a new client using the configuration of the builder.
|
|
DefaultDockerClient(String uri)
Create a new client with default configuration.
|
|
DefaultDockerClient(URI uri)
Create a new client with default configuration.
|
|
DefaultDockerClient(URI uri,
DockerCertificates dockerCertificates)
Create a new client with default configuration.
|
| Modifier and Type | Method and 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(AuthConfig authConfig)
Check auth configuration.
|
String |
build(Path directory,
DockerClient.BuildParam... params)
Build a docker image.
|
String |
build(Path directory,
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,
String name,
String dockerfile,
ProgressHandler handler,
DockerClient.BuildParam... params)
Build a docker image.
|
static DefaultDockerClient.Builder |
builder()
Create a new
DefaultDockerClient builder. |
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.
|
InputStream |
copyContainer(String containerId,
String path)
Deprecated.
|
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.
|
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.
|
ServiceCreateResponse |
createService(ServiceSpec spec)
Create a new service.
|
ServiceCreateResponse |
createService(ServiceSpec spec,
AuthConfig config)
Create a new service.
|
Volume |
createVolume() |
Volume |
createVolume(Volume volume) |
void |
disconnectFromNetwork(String containerId,
String networkId)
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.
|
static DefaultDockerClient.Builder |
fromEnv()
Create a new
DefaultDockerClient builder prepopulated with values loaded from the
DOCKER_HOST and DOCKER_CERT_PATH environment variables. |
String |
getHost()
Get the Docker host address.
|
List<ImageHistory> |
history(String image)
Return the history of the image.
|
Info |
info()
Get docker instance information.
|
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.
|
Service |
inspectService(String serviceId)
Inspect an existing service.
|
Swarm |
inspectSwarm()
Inspect the Swarm cluster.
|
Task |
inspectTask(String taskId)
Inspect an existing task.
|
Volume |
inspectVolume(String volumeName) |
void |
killContainer(String containerId)
Kill a docker container.
|
List<Container> |
listContainers(DockerClient.ListContainersParam... params)
List docker containers.
|
List<Image> |
listImages(DockerClient.ListImagesParam... params)
List docker images.
|
List<Network> |
listNetworks()
List all networks.
|
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) |
void |
load(InputStream imagePayload)
Load a set of images and tags from a tarball.
|
void |
load(String image,
InputStream imagePayload)
Deprecated.
|
void |
load(String image,
InputStream imagePayload,
AuthConfig authConfig)
Deprecated.
|
void |
load(String image,
InputStream imagePayload,
AuthConfig authConfig,
ProgressHandler handler)
Deprecated.
|
void |
load(String image,
InputStream imagePayload,
ProgressHandler handler)
Deprecated.
|
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,
AuthConfig authConfig)
Pull a private docker container image.
|
void |
pull(String image,
AuthConfig authConfig,
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,
AuthConfig authconfig) |
void |
push(String image,
ProgressHandler handler)
Push a docker container image, using a custom ProgressHandler
|
void |
push(String image,
ProgressHandler handler,
AuthConfig authConfig) |
void |
removeContainer(String containerId)
Remove a docker container.
|
void |
removeContainer(String containerId,
boolean removeVolumes)
Deprecated.
|
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 |
save(String image,
AuthConfig authConfig)
Deprecated.
|
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
|
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 |
unpauseContainer(String containerId)
Unpause a docker container.
|
void |
updateService(String serviceId,
Long version,
ServiceSpec spec)
Update an existing service.
|
Version |
version()
Get the docker version.
|
ContainerExit |
waitContainer(String containerId)
Wait for a docker container to exit.
|
public DefaultDockerClient(String uri)
uri - The docker rest api uri.public DefaultDockerClient(URI uri)
uri - The docker rest api uri.public DefaultDockerClient(URI uri, DockerCertificates dockerCertificates)
uri - The docker rest api uri.dockerCertificates - The certificates to use for HTTPS.protected DefaultDockerClient(DefaultDockerClient.Builder builder)
builder - DefaultDockerClient builderpublic String getHost()
DockerClientgetHost in interface DockerClientpublic void close()
DockerClientclose in interface DockerClientclose in interface Closeableclose in interface AutoCloseablepublic String ping() throws DockerException, InterruptedException
DockerClientping in interface DockerClientDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic Version version() throws DockerException, InterruptedException
DockerClientversion in interface DockerClientDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic int auth(AuthConfig authConfig) throws DockerException, InterruptedException
DockerClientauth in interface DockerClientauthConfig - The authentication config needed to pull the image.DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic Info info() throws DockerException, InterruptedException
DockerClientinfo in interface DockerClientDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic List<Container> listContainers(DockerClient.ListContainersParam... params) throws DockerException, InterruptedException
DockerClientlistContainers in interface DockerClientparams - Container listing and filtering options.BadParamException - if one or more params were bad (400)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic List<Image> listImages(DockerClient.ListImagesParam... params) throws DockerException, InterruptedException
DockerClientlistImages in interface DockerClientparams - Image listing and filtering options.BadParamException - if one or more params were bad (400)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic ContainerCreation createContainer(ContainerConfig config) throws DockerException, InterruptedException
DockerClientcreateContainer in interface DockerClientconfig - The container configuration.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 interruptedpublic ContainerCreation createContainer(ContainerConfig config, String name) throws DockerException, InterruptedException
DockerClientcreateContainer in interface DockerClientconfig - The container configuration.name - The container name.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 interruptedpublic void startContainer(String containerId) throws DockerException, InterruptedException
DockerClientstartContainer in interface DockerClientcontainerId - The id of the container to start.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void pauseContainer(String containerId) throws DockerException, InterruptedException
DockerClientpauseContainer in interface DockerClientcontainerId - The id of the container to pause.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void unpauseContainer(String containerId) throws DockerException, InterruptedException
DockerClientunpauseContainer in interface DockerClientcontainerId - The id of the container to pause.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void restartContainer(String containerId) throws DockerException, InterruptedException
DockerClientrestartContainer in interface DockerClientcontainerId - The id of the container to restart.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void restartContainer(String containerId, int secondsToWaitBeforeRestart) throws DockerException, InterruptedException
DockerClientrestartContainer in interface DockerClientcontainerId - The id of the container to restart.secondsToWaitBeforeRestart - number of seconds to wait before killing the container.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void killContainer(String containerId) throws DockerException, InterruptedException
DockerClientkillContainer in interface DockerClientcontainerId - The id of the container to kill.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void stopContainer(String containerId, int secondsToWaitBeforeKilling) throws DockerException, InterruptedException
DockerClientstopContainer in interface DockerClientcontainerId - The id of the container to stop.secondsToWaitBeforeKilling - Time to wait after SIGTERM before sending SIGKILL.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic ContainerExit waitContainer(String containerId) throws DockerException, InterruptedException
DockerClientwaitContainer in interface DockerClientcontainerId - The id of the container to wait for.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void removeContainer(String containerId) throws DockerException, InterruptedException
DockerClientremoveContainer in interface DockerClientcontainerId - The id of the container to remove.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@Deprecated public void removeContainer(String containerId, boolean removeVolumes) throws DockerException, InterruptedException
DockerClientremoveContainer in interface DockerClientcontainerId - The id of the container to remove.removeVolumes - Whether to remove volumes as well.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 interruptedpublic void removeContainer(String containerId, DockerClient.RemoveContainerParam... params) throws DockerException, InterruptedException
DockerClientremoveContainer in interface DockerClientcontainerId - The id of the container to remove.params - DockerClient.RemoveContainerParamBadParamException - 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 interruptedpublic InputStream exportContainer(String containerId) throws DockerException, InterruptedException
DockerClientexportContainer in interface DockerClientcontainerId - The id of the container to export.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interrupted@Deprecated public InputStream copyContainer(String containerId, String path) throws DockerException, InterruptedException
DockerClientcopyContainer in interface DockerClientcontainerId - 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.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.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)UnsupportedApiVersionException - If client API is greater than or equal to 1.24InterruptedException - If the thread is interruptedpublic InputStream archiveContainer(String containerId, String path) throws DockerException, InterruptedException
DockerClientarchiveContainer in interface DockerClientcontainerId - 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.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.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic TopResults topContainer(String containerId) throws DockerException, InterruptedException
DockerClientps.topContainer in interface DockerClientcontainerId - the id of the container to examineDockerException - if a server error occurred (500).InterruptedException - if the thread is interrupted.public TopResults topContainer(String containerId, String psArgs) throws DockerException, InterruptedException
DockerClientps and the given arguments.topContainer in interface DockerClientcontainerId - the id of the container to examinepsArgs - the arguments to pass to ps
inside the container, e.g., "-ef"DockerException - if a server error occurred (500).InterruptedException - if the thread is interrupted.public void copyToContainer(Path directory, String containerId, String path) throws DockerException, InterruptedException, IOException
DockerClientcopyToContainer in interface DockerClientdirectory - The path to sent to containercontainerId - The id of the container to sent files.path - The path inside of the container to put files.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 interruptedIOException - If IOExceptionpublic List<ContainerChange> inspectContainerChanges(String containerId) throws DockerException, InterruptedException
DockerClientinspectContainerChanges in interface DockerClientcontainerId - The id of the container.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic ContainerInfo inspectContainer(String containerId) throws DockerException, InterruptedException
DockerClientinspectContainer in interface DockerClientcontainerId - The id of the container to inspect.ContainerNotFoundException - if container was not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic ContainerCreation commitContainer(String containerId, String repo, String tag, ContainerConfig config, String comment, String author) throws DockerException, InterruptedException
DockerClientcommitContainer in interface DockerClientcontainerId - The id of the container to commit.repo - repository to commit to.tag - image tag.config - ContainerConfig to commit.comment - commit message.author - image author.ContainerNotFoundException - if container was not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void renameContainer(String containerId, String name) throws DockerException, InterruptedException
DockerClientrenameContainer in interface DockerClientcontainerId - The id of the container to rename.name - The new name the container will haveContainerNotFoundException - 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 interruptedpublic List<ImageSearchResult> searchImages(String term) throws DockerException, InterruptedException
DockerClientThis method is broken for Docker 1.7.x because of a Docker bug. See https://github.com/docker/docker/pull/14850.
searchImages in interface DockerClientterm - the search termDockerException - if a server error occurred (500)InterruptedException - If the thread is interrupted@Deprecated public void load(String image, InputStream imagePayload) throws DockerException, InterruptedException
DockerClientload in interface DockerClientimage - the name to assign to the image.imagePayload - the image's payload (i.e.: the stream corresponding to the image's .tar
file).DockerException - if a server error occurred (500).InterruptedException - if the thread is interrupted.@Deprecated public void load(String image, InputStream imagePayload, AuthConfig authConfig) throws DockerException, InterruptedException
DockerClientload in interface DockerClientimage - the name to assign to the image.imagePayload - the image's payload (i.e.: the stream corresponding to the image's .tar
file).authConfig - The authentication config needed to pull the image.DockerException - if a server error occurred (500).InterruptedException - if the thread is interrupted.@Deprecated public void load(String image, InputStream imagePayload, ProgressHandler handler) throws DockerException, InterruptedException
DockerClientload in interface DockerClientimage - 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.DockerException - if a server error occurred (500).InterruptedException - if the thread is interrupted.@Deprecated public void load(String image, InputStream imagePayload, AuthConfig authConfig, ProgressHandler handler) throws DockerException, InterruptedException
DockerClientload in interface DockerClientimage - the name to assign to the image.imagePayload - the image's payload (i.e.: the stream corresponding to the image's .tar
file).authConfig - The authentication config needed to pull the image.handler - The handler to use for processing each progress message received from
Docker.DockerException - if a server error occurred (500).InterruptedException - if the thread is interrupted.public void load(InputStream imagePayload) throws DockerException, InterruptedException
DockerClientload in interface DockerClientimagePayload - the image's payload (i.e.: the stream corresponding to the image's .tar
file).DockerException - if a server error occurred (500).InterruptedException - if the thread is interrupted.public void create(String image, InputStream imagePayload) throws DockerException, InterruptedException
DockerClientcreate in interface DockerClientimage - the name to assign to the image.imagePayload - the image's payload (i.e.: the stream corresponding to the image's .tar
file).DockerException - if a server error occurred (500).InterruptedException - if the thread is interrupted.public void create(String image, InputStream imagePayload, ProgressHandler handler) throws DockerException, InterruptedException
DockerClientcreate in interface DockerClientimage - 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.DockerException - if a server error occurred (500).InterruptedException - if the thread is interrupted.public InputStream save(String... images) throws DockerException, IOException, InterruptedException
DockerClientsave in interface DockerClientimages - 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.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.@Deprecated public InputStream save(String image, AuthConfig authConfig) throws DockerException, IOException, InterruptedException
DockerClientsave in interface DockerClientimage - the name or id of the image 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.authConfig - The authentication config needed to pull the image.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.public InputStream saveMultiple(String... images) throws DockerException, IOException, InterruptedException
DockerClientsaveMultiple in interface DockerClientimages - 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.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.public void pull(String image) throws DockerException, InterruptedException
DockerClientpull in interface DockerClientimage - The image to pull.ImageNotFoundException - if image was not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void pull(String image, ProgressHandler handler) throws DockerException, InterruptedException
DockerClientpull in interface DockerClientimage - The image to pull.handler - The handler to use for processing each progress message received from Docker.ImageNotFoundException - if image was not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void pull(String image, AuthConfig authConfig) throws DockerException, InterruptedException
DockerClientpull in interface DockerClientimage - The image to pull.authConfig - The authentication config needed to pull the image.ImageNotFoundException - if image was not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void pull(String image, AuthConfig authConfig, ProgressHandler handler) throws DockerException, InterruptedException
DockerClientpull in interface DockerClientimage - The image to pull.authConfig - The authentication config needed to pull the image.handler - The handler to use for processing each progress message received from
Docker.ImageNotFoundException - if image was not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void push(String image) throws DockerException, InterruptedException
DockerClientpush in interface DockerClientimage - The image to push.ImageNotFoundException - if image was not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void push(String image, AuthConfig authconfig) throws DockerException, InterruptedException
push in interface DockerClientDockerExceptionInterruptedExceptionpublic void push(String image, ProgressHandler handler) throws DockerException, InterruptedException
DockerClientpush in interface DockerClientimage - The image to push.handler - The handler to use for processing each progress message received from Docker.ImageNotFoundException - if image was not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void push(String image, ProgressHandler handler, AuthConfig authConfig) throws DockerException, InterruptedException
push in interface DockerClientDockerExceptionInterruptedExceptionpublic void tag(String image, String name) throws DockerException, InterruptedException
DockerClienttag in interface DockerClientimage - The image to tag.name - The new name that will be applied to the image.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 interruptedpublic void tag(String image, String name, boolean force) throws DockerException, InterruptedException
DockerClienttag in interface DockerClientimage - 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.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 interruptedpublic String build(Path directory, DockerClient.BuildParam... params) throws DockerException, InterruptedException, IOException
DockerClientbuild in interface DockerClientdirectory - The directory containing the dockerfile.params - Additional flags to use during build.DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedIOException - If some IO shit happened.public String build(Path directory, String name, DockerClient.BuildParam... params) throws DockerException, InterruptedException, IOException
DockerClientbuild in interface DockerClientdirectory - 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.DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedIOException - If some IO shit happened.public String build(Path directory, ProgressHandler handler, DockerClient.BuildParam... params) throws DockerException, InterruptedException, IOException
DockerClientbuild in interface DockerClientdirectory - 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.DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedIOException - If some IO shit happened.public String build(Path directory, String name, ProgressHandler handler, DockerClient.BuildParam... params) throws DockerException, InterruptedException, IOException
DockerClientbuild in interface DockerClientdirectory - 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.DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedIOException - If some IO shit happened.public String build(Path directory, String name, String dockerfile, ProgressHandler handler, DockerClient.BuildParam... params) throws DockerException, InterruptedException, IOException
DockerClientbuild in interface DockerClientdirectory - 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 Dockerfilehandler - The handler to use for processing each progress message received from
Docker.params - Additional flags to use during build.DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedIOException - If some IO shit happened.public ImageInfo inspectImage(String image) throws DockerException, InterruptedException
DockerClientinspectImage in interface DockerClientimage - The image to inspect.ImageNotFoundException - if image was not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic List<RemovedImage> removeImage(String image) throws DockerException, InterruptedException
DockerClientremoveImage in interface DockerClientimage - The image to remove.ImageNotFoundException - if image was not found (404)ConflictException - conflict (409)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic List<RemovedImage> removeImage(String image, boolean force, boolean noPrune) throws DockerException, InterruptedException
DockerClientremoveImage in interface DockerClientimage - The image to remove.force - Force image removal.noPrune - Do not delete untagged parents.ImageNotFoundException - if image was not found (404)ConflictException - conflict (409)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic List<ImageHistory> history(String image) throws DockerException, InterruptedException
DockerClienthistory in interface DockerClientimage - An image name or ID.ImageHistoryDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic LogStream logs(String containerId, DockerClient.LogsParam... params) throws DockerException, InterruptedException
DockerClientlogs in interface DockerClientcontainerId - The id of the container to get logs for.params - Params for controlling what streams to get and whether to tail or not.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 interruptedpublic EventStream events(DockerClient.EventsParam... params) throws DockerException, InterruptedException
DockerClientThis method is broken for Docker 1.7.x because of a Docker bug. See https://github.com/docker/docker/issues/14354.
events in interface DockerClientparams - The parameters to apply to the events requestDockerException - If a server error occurred (500)InterruptedException - If the thread is interruptedpublic LogStream attachContainer(String containerId, DockerClient.AttachParameter... params) throws DockerException, InterruptedException
DockerClientattachContainer in interface DockerClientcontainerId - The id of the container to get logs for.params - Params for controlling what streams to get and whether to tail or not.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 interruptedpublic ExecCreation execCreate(String containerId, String[] cmd, DockerClient.ExecCreateParam... params) throws DockerException, InterruptedException
DockerClientexecCreate in interface DockerClientcontainerId - The id of the containercmd - shell commandparams - Exec paramsExecCreationDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic LogStream execStart(String execId, DockerClient.ExecStartParameter... params) throws DockerException, InterruptedException
DockerClientexecStart in interface DockerClientexecId - exec idparams - Exec start paramsExecNotFoundException - 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 interruptedpublic Swarm inspectSwarm() throws DockerException, InterruptedException
DockerClientinspectSwarm in interface DockerClientDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic ServiceCreateResponse createService(ServiceSpec spec) throws DockerException, InterruptedException
DockerClientcreateService in interface DockerClientspec - the service specDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic ServiceCreateResponse createService(ServiceSpec spec, AuthConfig config) throws DockerException, InterruptedException
DockerClientcreateService in interface DockerClientspec - the service specconfig - the registry authentication configurationDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic Service inspectService(String serviceId) throws DockerException, InterruptedException
DockerClientinspectService in interface DockerClientserviceId - the id of the service to inspectDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void updateService(String serviceId, Long version, ServiceSpec spec) throws DockerException, InterruptedException
DockerClientupdateService in interface DockerClientserviceId - the identifier of the serviceversion - the version of the servicespec - the new service specDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic List<Service> listServices() throws DockerException, InterruptedException
DockerClientlistServices in interface DockerClientDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic List<Service> listServices(Service.Criteria criteria) throws DockerException, InterruptedException
DockerClientlistServices in interface DockerClientcriteria - Service listing and filtering options.ServicesDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void removeService(String serviceId) throws DockerException, InterruptedException
DockerClientremoveService in interface DockerClientserviceId - the id of the service to removeDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic Task inspectTask(String taskId) throws DockerException, InterruptedException
DockerClientinspectTask in interface DockerClienttaskId - the id of the task to inspectDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic List<Task> listTasks() throws DockerException, InterruptedException
DockerClientlistTasks in interface DockerClientDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic List<Task> listTasks(Task.Criteria criteria) throws DockerException, InterruptedException
DockerClientlistTasks in interface DockerClientcriteria - Task.CriteriaDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void execResizeTty(String execId, Integer height, Integer width) throws DockerException, InterruptedException
DockerClienttty was specified as part
of creating and
starting the exec command.execResizeTty in interface DockerClientexecId - exec idheight - height of tty sessionwidth - width of tty sessionBadParamException - if both height and width are null or zeroExecNotFoundException - if exec instance is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic ExecState execInspect(String execId) throws DockerException, InterruptedException
DockerClientexecInspect in interface DockerClientexecId - exec idExecNotFoundException - if exec instance is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic ContainerStats stats(String containerId) throws DockerException, InterruptedException
DockerClientstats in interface DockerClientcontainerId - The id of the container to retrieve stats for.ContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void resizeTty(String containerId, Integer height, Integer width) throws DockerException, InterruptedException
DockerClienttty was specified as
part of creating the container.resizeTty in interface DockerClientcontainerId - The id of the container whose TTY will be resized.height - New height of TTYwidth - New width of TTYBadParamException - if both height and width are null or zeroContainerNotFoundException - if container is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic List<Network> listNetworks() throws DockerException, InterruptedException
DockerClientlistNetworks in interface DockerClientDockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic Network inspectNetwork(String networkId) throws DockerException, InterruptedException
DockerClientinspectNetwork in interface DockerClientnetworkId - The id of the networkNetworkNotFoundException - if network is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic NetworkCreation createNetwork(NetworkConfig networkConfig) throws DockerException, InterruptedException
DockerClientcreateNetwork in interface DockerClientnetworkConfig - The network creation parametersNetworkNotFoundException - if network is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void removeNetwork(String networkId) throws DockerException, InterruptedException
DockerClientremoveNetwork in interface DockerClientnetworkId - The id of the network to remove.NetworkNotFoundException - if network is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void connectToNetwork(String containerId, String networkId) throws DockerException, InterruptedException
DockerClientconnectToNetwork in interface DockerClientcontainerId - The id of the container to connect.networkId - The id of the network to connect.NotFoundException - if either container or network is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic void disconnectFromNetwork(String containerId, String networkId) throws DockerException, InterruptedException
DockerClientdisconnectFromNetwork in interface DockerClientcontainerId - The id of the container to disconnect.networkId - The id of the network to disconnect.NotFoundException - if either container or network is not found (404)DockerException - if a server error occurred (500)InterruptedException - If the thread is interruptedpublic Volume createVolume() throws DockerException, InterruptedException
createVolume in interface DockerClientDockerExceptionInterruptedExceptionpublic Volume createVolume(Volume volume) throws DockerException, InterruptedException
createVolume in interface DockerClientDockerExceptionInterruptedExceptionpublic Volume inspectVolume(String volumeName) throws DockerException, InterruptedException
inspectVolume in interface DockerClientDockerExceptionInterruptedExceptionpublic void removeVolume(Volume volume) throws DockerException, InterruptedException
removeVolume in interface DockerClientDockerExceptionInterruptedExceptionpublic void removeVolume(String volumeName) throws DockerException, InterruptedException
removeVolume in interface DockerClientDockerExceptionInterruptedExceptionpublic VolumeList listVolumes(DockerClient.ListVolumesParam... params) throws DockerException, InterruptedException
listVolumes in interface DockerClientDockerExceptionInterruptedExceptionpublic static DefaultDockerClient.Builder builder()
DefaultDockerClient builder.public static DefaultDockerClient.Builder fromEnv() throws DockerCertificateException
DefaultDockerClient builder prepopulated with values loaded from the
DOCKER_HOST and DOCKER_CERT_PATH environment variables.DockerCertificateException - if we could not build a DockerCertificates objectCopyright © 2017. All rights reserved.