org.testcontainers.dockerclient

Class DockerClientProviderStrategy

java.lang.Object

org.testcontainers.dockerclient.DockerClientProviderStrategy

Direct Known Subclasses:

DockerMachineClientProviderStrategy, EnvironmentAndSystemPropertyClientProviderStrategy, UnixSocketClientProviderStrategy

public abstract class DockerClientProviderStrategy
extends Object

Mechanism to find a viable Docker client configuration according to the host system environment.

Field Summary

Fields

Modifier and Type	Field and Description
protected com.github.dockerjava.api.DockerClient	client
protected com.github.dockerjava.core.DockerClientConfig	config
protected static org.slf4j.Logger	LOGGER

Constructor Summary

Constructors

Constructor and Description
DockerClientProviderStrategy()

Method Summary

Modifier and Type	Method and Description
com.github.dockerjava.api.DockerClient	getClient()
protected com.github.dockerjava.api.DockerClient	getClientForConfig(com.github.dockerjava.core.DockerClientConfig config)
abstract String	getDescription()
String	getDockerHostIpAddress()
static DockerClientProviderStrategy	getFirstValidStrategy(List<DockerClientProviderStrategy> strategies) Determine the right DockerClientConfig to use for building clients by trial-and-error.
protected void	ping(com.github.dockerjava.api.DockerClient client, int timeoutInSeconds)
abstract void	test()

Methods inherited from class java.lang.Object

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

Field Detail

client

protected com.github.dockerjava.api.DockerClient client

config

protected com.github.dockerjava.core.DockerClientConfig config

LOGGER

protected static final org.slf4j.Logger LOGGER

Constructor Detail

DockerClientProviderStrategy

public DockerClientProviderStrategy()

Method Detail

test

public abstract void test()
                   throws org.testcontainers.dockerclient.DockerClientProviderStrategy.InvalidConfigurationException

Throws:

InvalidConfigurationException - if this strategy fails

org.testcontainers.dockerclient.DockerClientProviderStrategy.InvalidConfigurationException

getDescription

public abstract String getDescription()

Returns:

a short textual description of the strategy

getFirstValidStrategy

public static DockerClientProviderStrategy getFirstValidStrategy(List<DockerClientProviderStrategy> strategies)

Determine the right DockerClientConfig to use for building clients by trial-and-error.

Returns:

a working DockerClientConfig, as determined by successful execution of a ping command

getClient

public com.github.dockerjava.api.DockerClient getClient()

Returns:

a usable, tested, Docker client configuration for the host system environment

getClientForConfig

protected com.github.dockerjava.api.DockerClient getClientForConfig(com.github.dockerjava.core.DockerClientConfig config)

ping

protected void ping(com.github.dockerjava.api.DockerClient client,
                    int timeoutInSeconds)

getDockerHostIpAddress

public String getDockerHostIpAddress()