Jenkins声明式Pipeline构建Docker镜像失败 报NoSuchMethodError错误

• agent { dockerfile {} }的作用是构建临时镜像作为流水线/阶段的运行容器，所有步骤在该临时容器内执行，任务结束后临时镜像默认自动清理，根本不是用来构建需要留存、推送的业务镜像，这就是第一版流水线执行成功但宿主机找不到目标镜像的核心原因。
• agent是声明式流水线的结构化配置字段，只能写在pipeline根节点或者单个stage的顶层，不能嵌套到steps下的script块里。script块内只能调用流水线步骤、编写Groovy执行逻辑，没有agent这个可调用的DSL方法，因此抛出NoSuchMethodError错误。
• 你第一版代码里的stage块都没有指定名称，属于不符合声明式流水线语法规范的写法，虽然部分版本Jenkins能兼容执行，但不建议这么写。

要完成代码拉取、Docker镜像构建、打标签、推送到本地私有仓库的需求，需要使用Docker流水线插件提供的docker.build()步骤实现，参考可直接运行的示例如下：

pipeline{ 
    agent any
    environment {
        // 替换为你本地部署的Docker Registry实际地址，例如192.168.1.100:5000
        REGISTRY_ADDR = "your-local-registry-addr"
        IMAGE_NAME="rocky_linux"
        // 用构建号作为动态镜像标签，方便版本追溯，也可以替换为代码提交哈希等
        IMAGE_TAG = "${env.BUILD_ID}"
        DOCKERFILE_PATH="images/rocky_linux/Dockerfile"
        BUILD_CONTEXT = "images/rocky_linux"
    }
    stages {
        stage('拉取代码') {
            steps {
                checkout scm
            }
        }

        stage('构建推送镜像') {
            steps {
                script {
                    echo "Building image ${IMAGE_NAME} from Dockerfile ${DOCKERFILE_PATH}"
                    // 执行镜像构建
                    def customImage = docker.build("${REGISTRY_ADDR}/${IMAGE_NAME}:${IMAGE_TAG}", "-f ${DOCKERFILE_PATH} ${BUILD_CONTEXT}")
                    
                    // 如果本地Registry配置了账号密码认证，提前在Jenkins凭据管理中添加用户名密码凭据，取消下面这段注释即可
                    // docker.withRegistry("http://${REGISTRY_ADDR}", "your-registry-credential-id") {
                    //     customImage.push()
                    //     // 额外打latest标签推送
                    //     sh "docker tag ${REGISTRY_ADDR}/${IMAGE_NAME}:${IMAGE_TAG} ${REGISTRY_ADDR}/${IMAGE_NAME}:latest"
                    //     customImage.push("latest")
                    // }

                    // 无认证的本地Registry直接执行推送命令
                    sh "docker push ${REGISTRY_ADDR}/${IMAGE_NAME}:${IMAGE_TAG}"
                    sh "docker tag ${REGISTRY_ADDR}/${IMAGE_NAME}:${IMAGE_TAG} ${REGISTRY_ADDR}/${IMAGE_NAME}:latest"
                    sh "docker push ${REGISTRY_ADDR}/${IMAGE_NAME}:latest"
                }
            }
        }
    }
}

流水线执行完成后，在宿主机执行以下命令即可看到留存的目标镜像：

docker image ls | grep rocky_linux

也可以直接查询本地Registry的镜像存储目录，或者调用Registry接口确认镜像推送成功。

• 只有当你需要让某段流水线步骤运行在指定Dockerfile构建的容器环境中时，才使用agent { dockerfile {} }配置，且必须写在stage的顶层，不要塞到steps块内。
• 如果需要在容器环境内执行docker build等操作，可以在agent的dockerfile配置中添加args '-v /var/run/docker.sock:/var/run/docker.sock'参数，把宿主机的docker套接字挂载到容器内，即可在容器中调用宿主机的docker服务。

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