新增测试与清理阶段后Jenkinsfile报WorkflowScript错误求助

问题概述 #

作为Jenkins新手，添加镜像测试阶段和工作区清理阶段后，Jenkinsfile出现语法错误，需要修正以实现构建Docker镜像、测试HTTP端点、推送镜像及清理工作的完整流程。

错误分析 #

根据Linter报错，核心问题集中在语法结构错误：

• Test image阶段agent配置无效：agent字段未指定具体代理（如any），Jenkins无法识别。
• 嵌套stage结构错误：在Test image的stages下错误嵌套了steps块，子stage应直接放在stages内，无需额外steps包裹。
• post块位置错误：post属于pipeline根级别元素，不能放在stages内部。
• Docker命令语法错误：镜像名称被错误包裹在括号中，且Jenkins环境变量在shell命令中的引用方式有误。

修正后的Jenkinsfile #

pipeline {
    agent any
    options {
        buildDiscarder(logRotator(numToKeepStr: '5'))
    }
    environment {
        DOCKERHUB_CREDENTIALS = credentials('dockerhub')
        IMAGE_NAME = "stlng/freeze-${BRANCH_NAME}:${BUILD_NUMBER}"
    }

    stages {
        stage('Build image') {
            steps {
                sh "docker build -t ${IMAGE_NAME} ."
            }
        }

        stage('Test image') {
            agent any
            stages {
                stage('Launch app') {
                    steps {
                        sh 'docker compose -f freeze.yml up -d'
                    }
                }

                stage('Verify HTTP endpoint') {
                    steps {
                        httpRequest url: 'http://localhost:8000',
                                    validResponseCodes: '200'
                    }
                }

                stage('Shut down app') {
                    steps {
                        sh 'docker compose -f freeze.yml down'
                    }
                }
            }
        }

        stage('Login to Docker Hub') {
            steps {
                sh 'echo $DOCKERHUB_CREDENTIALS_PSW | docker login -u $DOCKERHUB_CREDENTIALS_USR --password-stdin'
            }
        }

        stage('Push image to registry') {
            steps {
                sh "docker push ${IMAGE_NAME}"
            }
        }

        stage('Logout from Docker Hub') {
            steps {
                sh 'docker logout'
            }
        }
    }

    // 全局post构建动作，放在pipeline根级别
    post {
        always {
            sh 'docker system prune -f'
            cleanWs()
        }
    }
}

关键修正说明 #

1. 统一镜像名称变量：在environment中定义IMAGE_NAME，避免重复编写镜像标签，减少错误。
2. 修复Test image阶段结构：
   • 为Test image阶段指定agent any，明确代理配置。
   • 移除子stage外的多余steps块，子stage直接嵌套在stages内。
3. 修正Docker命令语法：移除镜像名称外的括号，使用双引号包裹shell命令以支持Jenkins环境变量解析。
4. 调整post块位置：将post移至stages外部，作为pipeline的顶级元素。
5. 优化清理命令：给docker system prune添加-f参数，避免交互式确认；确保已安装Workspace Cleanup插件以支持cleanWs()。
6. 规范阶段命名：将测试阶段命名调整为更清晰的表述，提升可读性。

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