Jenkins声明式Pipeline使用Docker代理时并行步骤报错求助

当主代理使用alpine:latest这类未预装Docker客户端的容器镜像时，Jenkins会尝试在主代理容器内部执行启动并行子阶段Docker容器的docker run命令，自然会报"找不到docker命令"的错误。而改用GenericBuildSlave标签的节点时，该节点本身已配置Docker环境（客户端+套接字挂载），所以能正常触发子容器启动。

1. 为主代理镜像预装Docker客户端 #

修改主代理配置，挂载宿主机Docker套接字，并在Pipeline初始化步骤中安装Docker客户端：

pipeline {
    agent {
        docker {
            image 'alpine:latest'
            args '-v /var/run/docker.sock:/var/run/docker.sock'
        }
    }
    stages {
        stage('Prepare') {
            steps {
                sh 'apk add --no-cache docker-cli'
            }
        }
        stage('Test') {
            parallel {
                stage('Test1') {
                    agent { docker 'ubuntu:latest' }
                    steps {
                        sh 'echo Test1 running in ubuntu container'
                    }
                }
                stage('Test2') {
                    agent { docker 'ubuntu:latest' }
                    steps {
                        sh 'echo Test2 running in ubuntu container'
                    }
                }
            }
        }
    }
}

2. 使用Docker-in-Docker（DinD）镜像作为主代理 #

如果需要完全隔离的Docker环境，可直接使用官方DinD镜像，它自带完整Docker服务：

pipeline {
    agent {
        docker {
            image 'docker:dind'
            args '--privileged'
        }
    }
    stages {
        stage('Test') {
            parallel {
                stage('Test1') {
                    agent { docker 'ubuntu:latest' }
                    steps {
                        sh 'echo Test1 running in ubuntu container'
                    }
                }
                stage('Test2') {
                    agent { docker 'ubuntu:latest' }
                    steps {
                        sh 'echo Test2 running in ubuntu container'
                    }
                }
            }
        }
    }
}

注意：--privileged参数是DinD运行的必要条件，但会带来一定安全风险，仅在受控环境使用。

3. 配置全局Docker代理模板 #

在Jenkins系统配置中添加Docker代理模板，指定带有Docker客户端的基础镜像，后续所有Pipeline的主代理默认使用该模板，避免重复配置。

• 主代理为容器镜像时：Jenkins的Pipeline控制逻辑（包括启动子容器的命令）会在该容器内部执行，因此主容器必须具备Docker客户端，且能通过挂载套接字访问宿主机Docker服务。
• 主代理为**普通节点（如GenericBuildSlave）**时：控制逻辑在节点本身执行，节点已配置Docker环境，可直接启动子容器，无需在主代理容器内处理Docker命令。

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