Jenkins Pipeline执行耗时过长：问题排查与优化方案咨询

一、代码中的错误点 #

• 远程命令环境变量解析错误：SSH远程执行的命令里，${env.WAR_URL}是Jenkins的环境变量，但原代码用双引号包裹远程命令，导致该变量会被远程服务器的Shell解析（远程服务器无此变量），最终aws s3 cp命令因参数缺失进入等待输入状态，导致Pipeline无限挂起。
• 冗余的SSH代理命令：已经使用Jenkins官方sshagent插件管理密钥，手动执行eval \ssh-agent -s``属于多余操作，可能引发代理冲突。
• Maven阶段重复执行：mvn install已经包含编译、打包等逻辑，后续单独执行mvn deploy会重复执行部分步骤，浪费时间。

二、耗时过长的核心原因 #

1. 远程命令挂起：上述环境变量解析错误导致aws s3 cp命令缺少必要参数，一直等待用户输入，Jenkins未设置超时，因此持续等待命令结束。
2. Docker构建无缓存：每次执行docker build都从头拉取基础镜像或重新构建所有层，在网络不佳或镜像较大时，耗时极长。
3. Maven构建冗余：分三次执行mvn clean、mvn install、mvn deploy，重复执行编译、打包等步骤，增加总耗时。
4. 无超时限制：Jenkins的sh步骤默认无超时机制，若远程命令因网络中断、资源不足卡住，会无限运行。
5. 远程服务器资源不足：EC2实例CPU、内存不足，导致aws s3 cp、docker build等命令执行缓慢。

三、优化与修复方案 #

代码修正 #

1. 修复环境变量传递：外层用双引号让Jenkins先解析${env.WAR_URL}，远程命令用单引号包裹，避免远程Shell解析变量：

stage('Deploy'){
    steps{
        script{
            sshagent(credentials: ['SHHCRED']) {
                sh "ssh -o StrictHostKeyChecking=no ubuntu@ec2-xx-xxx-xx-xxx.compute-1.amazonaws.com 'cd docker && aws s3 --profile abc cp ${env.WAR_URL} social.war && sudo docker image build -t social .'"
            }
        }
    }
}

2. 移除冗余SSH代理命令：删除sh 'eval ssh-agent -s'，仅保留sshagent插件的密钥管理逻辑。
3. 合并Maven阶段：将clean、install、deploy合并为一个步骤，减少重复执行：

stage('Maven Build & Deploy') {
    steps {
        script {
            def deployOutput = sh(script: 'mvn clean deploy', returnStdout: true).trim()
            def warUrl = deployOutput =~ /Uploaded to maven-repo: (\S+\.war)/
            if (warUrl) {
                def extractedUrl = warUrl[0][1]
                echo "Uploaded WAR File URL: ${extractedUrl}"
                env.WAR_URL = extractedUrl
            } else {
                error "No WAR files found in deploy output"
            }
        }
    }
}

性能优化 #

• 添加超时限制：给sh步骤设置超时，避免无限挂起；同时给远程命令中的操作添加超时参数：

sh script: "ssh ...", timeout: time(minutes: 30)
# 远程命令中给AWS CLI添加超时
aws s3 cp ${env.WAR_URL} social.war --timeout 300

• 启用Docker构建缓存：利用--cache-from参数复用已有镜像层，减少构建时间：

sh "ssh ... 'cd docker && aws s3 cp ... && sudo docker image build --cache-from social:latest -t social .'"

• 优化Maven构建：启用并行构建、使用本地镜像源加速依赖下载：

sh 'mvn clean deploy -T 2C -Dmaven.repo.local=/path/to/local/repo'

• 远程服务器优化：检查EC2实例资源使用率，必要时升级实例规格；更新AWS CLI、Docker到最新版本，提升命令执行效率。
• 添加错误捕获：在远程命令开头添加set -e，让命令出错时立即退出，便于快速定位问题：

sh "ssh ... 'set -e; cd docker && aws s3 cp ... && sudo docker build ...'"

内容的提问来源于stack exchange，提问作者Akshat Mani Tripathi