com.github.dockerjava.api

Interface DockerClient

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable

public interface DockerClient
extends java.io.Closeable

Method Summary

Modifier and Type	Method and Description
AttachContainerCmd	attachContainerCmd(java.lang.String containerId)
AuthCmd	authCmd() Authenticate with the server, useful for checking authentication.
AuthConfig	authConfig()
BuildImageCmd	buildImageCmd()
BuildImageCmd	buildImageCmd(java.io.File dockerFileOrFolder)
BuildImageCmd	buildImageCmd(java.io.InputStream tarInputStream)
void	close()
CommitCmd	commitCmd(java.lang.String containerId)
ConnectToNetworkCmd	connectToNetworkCmd()
ContainerDiffCmd	containerDiffCmd(java.lang.String containerId)
CopyArchiveFromContainerCmd	copyArchiveFromContainerCmd(java.lang.String containerId, java.lang.String resource) Copy resource from container to local machine.
CopyArchiveToContainerCmd	copyArchiveToContainerCmd(java.lang.String containerId) Copy archive from local machine to remote container
CopyFileFromContainerCmd	copyFileFromContainerCmd(java.lang.String containerId, java.lang.String resource) Deprecated. since docker API version 1.20, replaced by copyArchiveFromContainerCmd(String, String) since 1.24 fails.
CreateContainerCmd	createContainerCmd(java.lang.String image)
CreateImageCmd	createImageCmd(java.lang.String repository, java.io.InputStream imageStream)
CreateNetworkCmd	createNetworkCmd()
CreateSecretCmd	createSecretCmd(SecretSpec secretSpec) Command to create a secret in a docker swarm.
CreateServiceCmd	createServiceCmd(ServiceSpec serviceSpec) Command to create a service in a docker swarm.
CreateVolumeCmd	createVolumeCmd()
DisconnectFromNetworkCmd	disconnectFromNetworkCmd()
EventsCmd	eventsCmd()
ExecCreateCmd	execCreateCmd(java.lang.String containerId)
ExecStartCmd	execStartCmd(java.lang.String execId)
InfoCmd	infoCmd()
InitializeSwarmCmd	initializeSwarmCmd(SwarmSpec swarmSpec) Enables swarm mode for the docker engine and creates a new swarm cluster
InspectContainerCmd	inspectContainerCmd(java.lang.String containerId)
InspectExecCmd	inspectExecCmd(java.lang.String execId)
InspectImageCmd	inspectImageCmd(java.lang.String imageId)
InspectNetworkCmd	inspectNetworkCmd()
InspectServiceCmd	inspectServiceCmd(java.lang.String serviceId) Command to inspect a service
InspectSwarmCmd	inspectSwarmCmd() Gets information about the swarm the docker engine is currently in
InspectVolumeCmd	inspectVolumeCmd(java.lang.String name)
JoinSwarmCmd	joinSwarmCmd() Enables swarm mode for the docker engine and joins an existing swarm cluster
KillContainerCmd	killContainerCmd(java.lang.String containerId)
LeaveSwarmCmd	leaveSwarmCmd() Disables swarm node for the docker engine and leaves the swarm cluster
ListContainersCmd	listContainersCmd() * CONTAINER API *
ListImagesCmd	listImagesCmd()
ListNetworksCmd	listNetworksCmd()
ListSecretsCmd	listSecretsCmd() Command to list all secrets.
ListServicesCmd	listServicesCmd() Command to list all services in a docker swarm.
ListSwarmNodesCmd	listSwarmNodesCmd() List nodes in swarm
ListTasksCmd	listTasksCmd() List tasks in the swarm cluster
ListVolumesCmd	listVolumesCmd()
LoadImageCmd	loadImageCmd(java.io.InputStream imageStream) Loads a tarball with a set of images and tags into a Docker repository.
LogContainerCmd	logContainerCmd(java.lang.String containerId)
LogSwarmObjectCmd	logServiceCmd(java.lang.String serviceId) Command to get service log
LogSwarmObjectCmd	logTaskCmd(java.lang.String taskId) Command to get task log
PauseContainerCmd	pauseContainerCmd(java.lang.String containerId)
PingCmd	pingCmd()
PruneCmd	pruneCmd(PruneType pruneType) Command to delete unused containers/images/networks/volumes
PullImageCmd	pullImageCmd(java.lang.String repository) * IMAGE API *
PushImageCmd	pushImageCmd(Identifier identifier)
PushImageCmd	pushImageCmd(java.lang.String name)
RemoveContainerCmd	removeContainerCmd(java.lang.String containerId)
RemoveImageCmd	removeImageCmd(java.lang.String imageId)
RemoveNetworkCmd	removeNetworkCmd(java.lang.String networkId)
RemoveSecretCmd	removeSecretCmd(java.lang.String secretId) Command to remove a secret
RemoveServiceCmd	removeServiceCmd(java.lang.String serviceId) Command to remove a service
RemoveVolumeCmd	removeVolumeCmd(java.lang.String name)
RenameContainerCmd	renameContainerCmd(java.lang.String containerId) Rename container.
RestartContainerCmd	restartContainerCmd(java.lang.String containerId)
SaveImageCmd	saveImageCmd(java.lang.String name)
SearchImagesCmd	searchImagesCmd(java.lang.String term)
StartContainerCmd	startContainerCmd(java.lang.String containerId) Creates a new StartContainerCmd for the container with the given ID.
StatsCmd	statsCmd(java.lang.String containerId)
StopContainerCmd	stopContainerCmd(java.lang.String containerId)
TagImageCmd	tagImageCmd(java.lang.String imageId, java.lang.String imageNameWithRepository, java.lang.String tag)
TopContainerCmd	topContainerCmd(java.lang.String containerId)
UnpauseContainerCmd	unpauseContainerCmd(java.lang.String containerId)
UpdateContainerCmd	updateContainerCmd(java.lang.String containerId) Update container settings
UpdateServiceCmd	updateServiceCmd(java.lang.String serviceId, ServiceSpec serviceSpec) Command to update a service specification
UpdateSwarmCmd	updateSwarmCmd(SwarmSpec swarmSpec) Updates the swarm specification
UpdateSwarmNodeCmd	updateSwarmNodeCmd() Updates the swarm node
VersionCmd	versionCmd()
WaitContainerCmd	waitContainerCmd(java.lang.String containerId)

Method Detail

authConfig

AuthConfig authConfig()
               throws DockerException

Throws:

DockerException

authCmd

AuthCmd authCmd()

Authenticate with the server, useful for checking authentication.

infoCmd

InfoCmd infoCmd()

pingCmd

PingCmd pingCmd()

versionCmd

VersionCmd versionCmd()

pullImageCmd

PullImageCmd pullImageCmd(@Nonnull
                          java.lang.String repository)

* IMAGE API *

pushImageCmd

PushImageCmd pushImageCmd(@Nonnull
                          java.lang.String name)

pushImageCmd

PushImageCmd pushImageCmd(@Nonnull
                          Identifier identifier)

createImageCmd

CreateImageCmd createImageCmd(@Nonnull
                              java.lang.String repository,
                              @Nonnull
                              java.io.InputStream imageStream)

loadImageCmd

LoadImageCmd loadImageCmd(@Nonnull
                          java.io.InputStream imageStream)

Loads a tarball with a set of images and tags into a Docker repository. Corresponds to POST /images/load API endpoint.

Parameters:

imageStream - stream of the tarball file

Returns:

created command

Since:

RemoteApiVersion#VERSION_1_7

searchImagesCmd

SearchImagesCmd searchImagesCmd(@Nonnull
                                java.lang.String term)

removeImageCmd

RemoveImageCmd removeImageCmd(@Nonnull
                              java.lang.String imageId)

listImagesCmd

ListImagesCmd listImagesCmd()

inspectImageCmd

InspectImageCmd inspectImageCmd(@Nonnull
                                java.lang.String imageId)

saveImageCmd

SaveImageCmd saveImageCmd(@Nonnull
                          java.lang.String name)

Parameters:

name - The name, e.g. "alexec/busybox" or just "busybox" if you want to default. Not null.

listContainersCmd

ListContainersCmd listContainersCmd()

* CONTAINER API *

createContainerCmd

CreateContainerCmd createContainerCmd(@Nonnull
                                      java.lang.String image)

startContainerCmd

StartContainerCmd startContainerCmd(@Nonnull
                                    java.lang.String containerId)

Creates a new StartContainerCmd for the container with the given ID. The command can then be further customized by using builder methods on it like StartContainerCmd#withDns(String...).

If you customize the command, any existing configuration of the target container will get reset to its default before applying the new configuration. To preserve the existing configuration, use an unconfigured StartContainerCmd.

This command corresponds to the /containers/{id}/start endpoint of the Docker Remote API.

execCreateCmd

ExecCreateCmd execCreateCmd(@Nonnull
                            java.lang.String containerId)

inspectContainerCmd

InspectContainerCmd inspectContainerCmd(@Nonnull
                                        java.lang.String containerId)

removeContainerCmd

RemoveContainerCmd removeContainerCmd(@Nonnull
                                      java.lang.String containerId)

waitContainerCmd

WaitContainerCmd waitContainerCmd(@Nonnull
                                  java.lang.String containerId)

attachContainerCmd

AttachContainerCmd attachContainerCmd(@Nonnull
                                      java.lang.String containerId)

execStartCmd

ExecStartCmd execStartCmd(@Nonnull
                          java.lang.String execId)

inspectExecCmd

InspectExecCmd inspectExecCmd(@Nonnull
                              java.lang.String execId)

logContainerCmd

LogContainerCmd logContainerCmd(@Nonnull
                                java.lang.String containerId)

copyArchiveFromContainerCmd

CopyArchiveFromContainerCmd copyArchiveFromContainerCmd(@Nonnull
                                                        java.lang.String containerId,
                                                        @Nonnull
                                                        java.lang.String resource)

Copy resource from container to local machine.

Parameters:

containerId - id of the container

resource - path to container's resource

Returns:

created command

Since:

RemoteApiVersion#VERSION_1_20

copyFileFromContainerCmd

@Deprecated
CopyFileFromContainerCmd copyFileFromContainerCmd(@Nonnull
                                                              java.lang.String containerId,
                                                              @Nonnull
                                                              java.lang.String resource)

Deprecated. since docker API version 1.20, replaced by copyArchiveFromContainerCmd(String, String) since 1.24 fails.

Copy resource from container to local machine.

Parameters:

containerId - id of the container

resource - path to container's resource

Returns:

created command

See Also:

copyArchiveFromContainerCmd(String, String)

copyArchiveToContainerCmd

CopyArchiveToContainerCmd copyArchiveToContainerCmd(@Nonnull
                                                    java.lang.String containerId)

Copy archive from local machine to remote container

Parameters:

containerId - id of the container

Returns:

created command

Since:

RemoteApiVersion#VERSION_1_20

containerDiffCmd

ContainerDiffCmd containerDiffCmd(@Nonnull
                                  java.lang.String containerId)

stopContainerCmd

StopContainerCmd stopContainerCmd(@Nonnull
                                  java.lang.String containerId)

killContainerCmd

KillContainerCmd killContainerCmd(@Nonnull
                                  java.lang.String containerId)

updateContainerCmd

UpdateContainerCmd updateContainerCmd(@Nonnull
                                      java.lang.String containerId)

Update container settings

Parameters:

containerId - id of the container

Returns:

command

Since:

RemoteApiVersion#VERSION_1_22

renameContainerCmd

RenameContainerCmd renameContainerCmd(@Nonnull
                                      java.lang.String containerId)

Rename container.

Parameters:

containerId - id of the container

Returns:

command

Since:

RemoteApiVersion#VERSION_1_17

restartContainerCmd

RestartContainerCmd restartContainerCmd(@Nonnull
                                        java.lang.String containerId)

commitCmd

CommitCmd commitCmd(@Nonnull
                    java.lang.String containerId)

buildImageCmd

BuildImageCmd buildImageCmd()

buildImageCmd

BuildImageCmd buildImageCmd(java.io.File dockerFileOrFolder)

buildImageCmd

BuildImageCmd buildImageCmd(java.io.InputStream tarInputStream)

topContainerCmd

TopContainerCmd topContainerCmd(java.lang.String containerId)

tagImageCmd

TagImageCmd tagImageCmd(java.lang.String imageId,
                        java.lang.String imageNameWithRepository,
                        java.lang.String tag)

pauseContainerCmd

PauseContainerCmd pauseContainerCmd(java.lang.String containerId)

unpauseContainerCmd

UnpauseContainerCmd unpauseContainerCmd(java.lang.String containerId)

eventsCmd

EventsCmd eventsCmd()

statsCmd

StatsCmd statsCmd(java.lang.String containerId)

createVolumeCmd

CreateVolumeCmd createVolumeCmd()

inspectVolumeCmd

InspectVolumeCmd inspectVolumeCmd(java.lang.String name)

removeVolumeCmd

RemoveVolumeCmd removeVolumeCmd(java.lang.String name)

listVolumesCmd

ListVolumesCmd listVolumesCmd()

listNetworksCmd

ListNetworksCmd listNetworksCmd()

inspectNetworkCmd

InspectNetworkCmd inspectNetworkCmd()

createNetworkCmd

CreateNetworkCmd createNetworkCmd()

removeNetworkCmd

RemoveNetworkCmd removeNetworkCmd(@Nonnull
                                  java.lang.String networkId)

connectToNetworkCmd

ConnectToNetworkCmd connectToNetworkCmd()

disconnectFromNetworkCmd

DisconnectFromNetworkCmd disconnectFromNetworkCmd()

initializeSwarmCmd

InitializeSwarmCmd initializeSwarmCmd(SwarmSpec swarmSpec)

Enables swarm mode for the docker engine and creates a new swarm cluster

Parameters:

swarmSpec - the specification for the swarm

Returns:

the command

Since:

1.24

inspectSwarmCmd

InspectSwarmCmd inspectSwarmCmd()

Gets information about the swarm the docker engine is currently in

Returns:

the command

Since:

1.24

joinSwarmCmd

JoinSwarmCmd joinSwarmCmd()

Enables swarm mode for the docker engine and joins an existing swarm cluster

Returns:

the command

Since:

1.24

leaveSwarmCmd

LeaveSwarmCmd leaveSwarmCmd()

Disables swarm node for the docker engine and leaves the swarm cluster

Returns:

the command

Since:

1.24

updateSwarmCmd

UpdateSwarmCmd updateSwarmCmd(SwarmSpec swarmSpec)

Updates the swarm specification

Parameters:

swarmSpec - the specification for the swarm

Returns:

the command

Since:

1.24

updateSwarmNodeCmd

UpdateSwarmNodeCmd updateSwarmNodeCmd()

Updates the swarm node

Returns:

the command

Since:

1.24

listSwarmNodesCmd

ListSwarmNodesCmd listSwarmNodesCmd()

List nodes in swarm

Returns:

the command

Since:

1.24

listServicesCmd

ListServicesCmd listServicesCmd()

Command to list all services in a docker swarm. Only applicable if docker runs in swarm mode.

Returns:

command

Since:

RemoteApiVersion#VERSION_1_24

createServiceCmd

CreateServiceCmd createServiceCmd(ServiceSpec serviceSpec)

Command to create a service in a docker swarm. Only applicable if docker runs in swarm mode.

Parameters:

serviceSpec - the service specification

Returns:

command

Since:

RemoteApiVersion#VERSION_1_24

inspectServiceCmd

InspectServiceCmd inspectServiceCmd(java.lang.String serviceId)

Command to inspect a service

Parameters:

serviceId - service id or service name

Returns:

command

updateServiceCmd

UpdateServiceCmd updateServiceCmd(java.lang.String serviceId,
                                  ServiceSpec serviceSpec)

Command to update a service specification

Parameters:

serviceId - service id

serviceSpec - the new service specification

Returns:

command

removeServiceCmd

RemoveServiceCmd removeServiceCmd(java.lang.String serviceId)

Command to remove a service

Parameters:

serviceId - service id or service name

Returns:

command

listTasksCmd

ListTasksCmd listTasksCmd()

List tasks in the swarm cluster

Returns:

the command

Since:

1.24

logServiceCmd

LogSwarmObjectCmd logServiceCmd(java.lang.String serviceId)

Command to get service log

Returns:

the command

Since:

1.29

logTaskCmd

LogSwarmObjectCmd logTaskCmd(java.lang.String taskId)

Command to get task log

Returns:

the command

Since:

1.29

pruneCmd

PruneCmd pruneCmd(PruneType pruneType)

Command to delete unused containers/images/networks/volumes

Since:

RemoteApiVersion#VERSION_1_25

listSecretsCmd

ListSecretsCmd listSecretsCmd()

Command to list all secrets. Only applicable if docker runs in swarm mode.

Returns:

command

Since:

RemoteApiVersion#VERSION_1_25

createSecretCmd

CreateSecretCmd createSecretCmd(SecretSpec secretSpec)

Command to create a secret in a docker swarm. Only applicable if docker runs in swarm mode.

Parameters:

secretSpec - the secret specification

Returns:

command

Since:

RemoteApiVersion#VERSION_1_25

removeSecretCmd

RemoveSecretCmd removeSecretCmd(java.lang.String secretId)

Command to remove a secret

Parameters:

secretId - secret id or secret name

Returns:

command

close

void close()
    throws java.io.IOException

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.io.IOException