Link to the docs on environment discovery failure (#5615)

Co-authored-by: Eddú Meléndez <[email protected]>

Author: bsideup

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

@@ -246,12 +246,11 @@ public boolean test(DockerClientProviderStrategy dockerClientProviderStrategy) {
             .findFirst()
             .orElseThrow(() -> {
                 log.error(
-                    "Could not find a valid Docker environment. Please check configuration. Attempted configurations were:"
+                    "Could not find a valid Docker environment. Please check configuration. Attempted configurations were:\n" +
+                    configurationFailures.stream().map(it -> "\t" + it).collect(Collectors.joining("\n")) +
+                    "As no valid configuration was found, execution cannot continue.\n" +
+                    "See https://www.testcontainers.org/on_failure.html for more details."
                 );
-                for (String failureMessage : configurationFailures) {
-                    log.error("    " + failureMessage);
-                }
-                log.error("As no valid configuration was found, execution cannot continue");
 
                 FAIL_FAST_ALWAYS.set(true);
                 return new IllegalStateException(

docs/_redirects

@@ -12,6 +12,7 @@
 /usage/database_containers.html         /modules/databases/
 /usage/neo4j_container.html             /modules/databases/neo4j/
 /compatibility.html                     /supported_docker_environment/
+/on_failure.html                        /supported_docker_environment/
 
 # No great 1:1 mapping exists for the following, so redirect to somewhere where at least a sensible sidebar will be shown