com.google.cloud.tools.jib.docker

Class DockerClient

java.lang.Object

com.google.cloud.tools.jib.docker.DockerClient

public class DockerClient
extends java.lang.Object

Calls out to the docker CLI.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DockerClient.DockerImageDetails Contains the size, image ID, and diff IDs of an image inspected with docker inspect.

Field Summary

Fields

Modifier and Type	Field and Description
static java.nio.file.Path	DEFAULT_DOCKER_CLIENT Default path to the docker executable.

Constructor Summary

Constructors

Constructor and Description
DockerClient(java.nio.file.Path dockerExecutable, java.util.Map<java.lang.String,java.lang.String> dockerEnvironment) Instantiates with a docker executable and environment variables.

Method Summary

Modifier and Type	Method and Description
DockerClient.DockerImageDetails	inspect(ImageReference imageReference) Gets the size, image ID, and diff IDs of an image in the Docker daemon.
static boolean	isDefaultDockerInstalled() Checks if Docker is installed on the user's system and accessible by running the default docker command.
static boolean	isDockerInstalled(java.nio.file.Path dockerExecutable) Checks if Docker is installed on the user's system and accessible by running the given docker executable.
java.lang.String	load(ImageTarball imageTarball, java.util.function.Consumer<java.lang.Long> writtenByteCountListener) Loads an image tarball into the Docker daemon.
void	save(ImageReference imageReference, java.nio.file.Path outputPath, java.util.function.Consumer<java.lang.Long> writtenByteCountListener) Saves an image tarball from the Docker daemon.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_DOCKER_CLIENT

public static final java.nio.file.Path DEFAULT_DOCKER_CLIENT

Default path to the docker executable.

Constructor Detail

DockerClient

public DockerClient(java.nio.file.Path dockerExecutable,
                    java.util.Map<java.lang.String,java.lang.String> dockerEnvironment)

Instantiates with a docker executable and environment variables.

Parameters:

dockerExecutable - path to docker

dockerEnvironment - environment variables for docker

Method Detail

isDefaultDockerInstalled

public static boolean isDefaultDockerInstalled()

Checks if Docker is installed on the user's system and accessible by running the default docker command.

Returns:

true if Docker is installed on the user's system and accessible

isDockerInstalled

public static boolean isDockerInstalled(java.nio.file.Path dockerExecutable)

Checks if Docker is installed on the user's system and accessible by running the given docker executable.

Parameters:

dockerExecutable - path to the executable to test running

Returns:

true if Docker is installed on the user's system and accessible

load

public java.lang.String load(ImageTarball imageTarball,
                             java.util.function.Consumer<java.lang.Long> writtenByteCountListener)
                      throws java.lang.InterruptedException,
                             java.io.IOException

Loads an image tarball into the Docker daemon.

Parameters:

imageTarball - the built container tarball

writtenByteCountListener - callback to call when bytes are loaded

Returns:

stdout from docker

Throws:

java.lang.InterruptedException - if the 'docker load' process is interrupted

java.io.IOException - if streaming the blob to 'docker load' fails

See Also:

https://docs.docker.com/engine/reference/commandline/load

save

public void save(ImageReference imageReference,
                 java.nio.file.Path outputPath,
                 java.util.function.Consumer<java.lang.Long> writtenByteCountListener)
          throws java.lang.InterruptedException,
                 java.io.IOException

Saves an image tarball from the Docker daemon.

Parameters:

imageReference - the image to save

outputPath - the destination path to save the output tarball

writtenByteCountListener - callback to call when bytes are saved

Throws:

java.lang.InterruptedException - if the 'docker save' process is interrupted

java.io.IOException - if creating the tarball fails

See Also:

https://docs.docker.com/engine/reference/commandline/save

inspect

public DockerClient.DockerImageDetails inspect(ImageReference imageReference)
                                        throws java.io.IOException,
                                               java.lang.InterruptedException

Gets the size, image ID, and diff IDs of an image in the Docker daemon.

Parameters:

imageReference - the image to inspect

Returns:

the size, image ID, and diff IDs of the image

Throws:

java.io.IOException - if an I/O exception occurs or docker inspect failed

java.lang.InterruptedException - if the docker inspect process was interrupted