Add TestcontainersHostPropertyClientStrategy

core/src/main/java/org/testcontainers/dockerclient/TestcontainersHostPropertyClientStrategy.java

@@ -0,0 +1,58 @@
+package org.testcontainers.dockerclient;
+
+import com.github.dockerjava.core.DefaultDockerClientConfig;
+import com.github.dockerjava.core.DockerClientConfig;
+import org.testcontainers.utility.TestcontainersConfiguration;
+
+import java.util.Optional;
+
+/**
+ * Use <code>docker.host</code> in <code>~/.testcontainers.properties</code>
+ * to try and locate a docker environment.
+ *
+ * @deprecated this class is used by the SPI and should not be used directly
+ */
+@Deprecated
+public final class TestcontainersHostPropertyClientStrategy extends DockerClientProviderStrategy {
+
+    public static final int PRIORITY = EnvironmentAndSystemPropertyClientProviderStrategy.PRIORITY - 10;
+
+    private final DockerClientConfig dockerClientConfig;
+
+    public TestcontainersHostPropertyClientStrategy() {
+        this(DefaultDockerClientConfig.createDefaultConfigBuilder());
+    }
+
+    public TestcontainersHostPropertyClientStrategy(DefaultDockerClientConfig.Builder configBuilder) {
+        Optional<String> tcHost = Optional.ofNullable(
+            TestcontainersConfiguration.getInstance().getEnvVarOrUserProperty("tc.host", null)
+        );
+
+        tcHost.ifPresent(configBuilder::withDockerHost);
+        this.dockerClientConfig = configBuilder.build();
+    }
+
+    @Override
+    public String getDescription() {
+        return "Testcontainers Host Strategy with tc.host=" + this.dockerClientConfig.getDockerHost();
+    }
+
+    @Override
+    public TransportConfig getTransportConfig() throws InvalidConfigurationException {
+        return TransportConfig
+            .builder()
+            .dockerHost(dockerClientConfig.getDockerHost())
+            .sslConfig(dockerClientConfig.getSSLConfig())
+            .build();
+    }
+
+    @Override
+    protected int getPriority() {
+        return PRIORITY;
+    }
+
+    @Override
+    protected boolean isPersistable() {
+        return false;
+    }
+}

core/src/main/resources/META-INF/services/org.testcontainers.dockerclient.DockerClientProviderStrategy

@@ -1,3 +1,4 @@
+org.testcontainers.dockerclient.TestcontainersHostPropertyClientStrategy
 org.testcontainers.dockerclient.EnvironmentAndSystemPropertyClientProviderStrategy
 org.testcontainers.dockerclient.UnixSocketClientProviderStrategy
 org.testcontainers.dockerclient.DockerMachineClientProviderStrategy

core/src/test/java/org/testcontainers/dockerclient/TestcontainersHostPropertyClientStrategyTest.java

@@ -0,0 +1,64 @@
+package org.testcontainers.dockerclient;
+
+import com.github.dockerjava.core.DefaultDockerClientConfig;
+import org.junit.Before;
+import org.junit.Rule;
+import org.junit.Test;
+import org.junit.runner.RunWith;
+import org.mockito.Mockito;
+import org.mockito.junit.MockitoJUnitRunner;
+import org.testcontainers.utility.MockTestcontainersConfigurationRule;
+import org.testcontainers.utility.TestcontainersConfiguration;
+
+import java.net.URI;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.ArgumentMatchers.isNull;
+
+@RunWith(MockitoJUnitRunner.class)
+public class TestcontainersHostPropertyClientStrategyTest {
+
+    @Rule
+    public MockTestcontainersConfigurationRule mockConfig = new MockTestcontainersConfigurationRule();
+
+    private URI defaultDockerHost;
+
+    private com.github.dockerjava.core.SSLConfig defaultSSLConfig;
+
+    @Before
+    public void checkEnvironmentClear() {
+        // If docker-java picks up non-default settings from the environment, our test needs to know to expect those
+        DefaultDockerClientConfig defaultConfig = DefaultDockerClientConfig.createDefaultConfigBuilder().build();
+        this.defaultDockerHost = defaultConfig.getDockerHost();
+        this.defaultSSLConfig = defaultConfig.getSSLConfig();
+    }
+
+    @Test
+    public void tcHostPropertyIsProvided() {
+        Mockito
+            .doReturn("tcp://127.0.0.1:9000")
+            .when(TestcontainersConfiguration.getInstance())
+            .getEnvVarOrUserProperty(eq("tc.host"), isNull());
+
+        TestcontainersHostPropertyClientStrategy strategy = new TestcontainersHostPropertyClientStrategy();
+
+        TransportConfig transportConfig = strategy.getTransportConfig();
+        assertThat(transportConfig.getDockerHost().toString()).isEqualTo("tcp://127.0.0.1:9000");
+        assertThat(transportConfig.getSslConfig()).isEqualTo(this.defaultSSLConfig);
+    }
+
+    @Test
+    public void tcHostPropertyIsNotProvided() {
+        Mockito
+            .doReturn(null)
+            .when(TestcontainersConfiguration.getInstance())
+            .getEnvVarOrUserProperty(eq("tc.host"), isNull());
+
+        TestcontainersHostPropertyClientStrategy strategy = new TestcontainersHostPropertyClientStrategy();
+
+        TransportConfig transportConfig = strategy.getTransportConfig();
+        assertThat(transportConfig.getDockerHost()).isEqualTo(this.defaultDockerHost);
+        assertThat(transportConfig.getSslConfig()).isEqualTo(this.defaultSSLConfig);
+    }
+}