Jenkins CI/CD中Testcontainers报错：找不到有效Docker环境求解决

Spring Boot应用使用Testcontainers进行Oracle数据库集成测试，本地Windows环境安装Docker Desktop后可正常运行，但Jenkins流水线执行时测试失败，报错Couldn't find valid docker environment。Jenkins采用JNLP节点执行构建，且本身会用Docker构建应用镜像用于部署，为何测试步骤会出现该错误？如何让流水线执行通过？

错误日志：

DemoClass1Test> initializationError FAILED
    java.lang.IllegalStateException at DockerClientProviderStrategy.java:232
DemoClass2Test> initializationError FAILED
    java.lang.IllegalStateException at DockerClientProviderStrategy.java:232


java.lang.IllegalStateException: Could not find a valid Docker environment. Please see logs and check configuration
    at org.testcontainers.dockerclient.DockerClientProviderStrategy.lambda$getFirstValidStrategy$7(DockerClientProviderStrategy.java:277)
    at java.util.Optional.orElseThrow(Optional.java:290)
    at org.testcontainers.dockerclient.DockerClientProviderStrategy.getFirstValidStrategy(DockerClientProviderStrategy.java:268)

流水线配置：

env.gradleTasks = 'gradle clean build'

pipeline {
    agent {
        kubernetes {
            inheritFrom used_agent
            defaultContainer 'builder-alpine'
        }
    }

    stages {
        stage ('Welcome to our Pipelines!') {
            steps {
                script {
                    log.banner()
                }
            }
        }
        stage ('Source Code: Clone') {
            when {
                expression { env.REL_URL != null && env.REL_URL != ""}
            }
            steps {
                container('jnlp') {
                    script {
                        util.gitClone(REL_URL, branch)
                    }
                }
            }
        }
        stage ('Gradle Build') {
            when {
                expression { build.toLowerCase() == "gradle" && env.REL_URL != null && env.REL_URL != "" }
            }
            steps {
                script {
                    buildTools.gradle(env.gradleTasks)
                }
            }
        }
}

• 构建容器缺少Docker环境：流水线默认使用的builder-alpine容器内未安装Docker客户端，也未挂载宿主机或Kubernetes集群的Docker套接字，导致Testcontainers无法找到可用的Docker环境。
• 权限与配置缺失：即使集群中存在Docker服务，测试容器也没有访问Docker daemon的权限，或未配置正确的环境变量指向Docker服务地址。

1. 让构建容器包含Docker客户端 #

修改builder-alpine容器的镜像配置，确保其包含Docker客户端：

• 自定义镜像时，在Dockerfile中添加安装命令：

FROM alpine:latest
RUN apk add --no-cache docker-cli openjdk17 gradle

2. 挂载Docker套接字到构建容器 #

在Kubernetes agent配置中添加卷挂载，将宿主机的Docker套接字挂载到builder-alpine容器内：
修改流水线的agent部分：

agent {
    kubernetes {
        inheritFrom used_agent
        defaultContainer 'builder-alpine'
        volumes {
            hostPathVolume(mountPath: '/var/run/docker.sock', hostPath: '/var/run/docker.sock')
        }
    }
}

3. 配置Testcontainers环境变量（可选） #

如果Docker daemon并非默认地址，在流水线中添加环境变量指定地址：
在Gradle Build步骤前加入：

environment {
    DOCKER_HOST = 'unix:///var/run/docker.sock'
}

4. 验证容器权限 #

确保挂载的/var/run/docker.sock在容器内拥有可读可写权限，必要时将容器运行用户加入docker用户组。

内容的提问来源于stack exchange，提问作者Pinki Sharma