From 29f3d14a3cfecf194da595e9aa20edc5b793813e Mon Sep 17 00:00:00 2001 From: Christoph Pirkl Date: Tue, 10 Oct 2023 13:22:39 +0200 Subject: [PATCH] Document how to configure the docker host (#237) --- doc/user_guide/user_guide.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/doc/user_guide/user_guide.md b/doc/user_guide/user_guide.md index 6a3539b2..e724ae01 100644 --- a/doc/user_guide/user_guide.md +++ b/doc/user_guide/user_guide.md @@ -669,8 +669,11 @@ If key generation steps inside the Docker container are slow, installing the `rn ```bash sudo apt install rng-tools ``` +## Configuration -## Reusing Container for Speedup +Exasol testcontainers uses the configuration of Testcontainers in file `~/.testcontainers.properties`. See the [Testcontainers documentation](https://java.testcontainers.org/features/configuration/) for details. + +### Reusing Container for Speedup Exasol testcontainers can reuse the running container to avoid the startup delay. For that you need to append `withReuse(true)` at container creation. @@ -689,6 +692,16 @@ You can find the container id using `docker ps` command and terminate it by runn Please note that the reuse capability works reliably with Exasol version 7 and above. We disabled that option for older versions. +### Use Docker Running in a Virtual Machine + +If your Docker server is running in a virtual machine, you can configure exasol-testcontainer to use it by adding the following line to `~/.testcontainers.properties`, no need to configure environment variables. + +```properties +docker.host=tcp://192.168.56.6:2375 +``` + +Adapt IP address and port to your setup. See the Testcontainers documentation for details on [Docker host detection](https://java.testcontainers.org/features/configuration/#customizing-docker-host-detection). + ## Troubleshooting ### Warning: Failure when attempting to lookup auth config