You need to enable JavaScript to run this app. 已安装SSH Pipeline Steps插件,Jenkins中使用sshCommand报错如何排查解决
优惠活动
大模型
产品
解决方案
定价
更多

已安装SSH Pipeline Steps插件,Jenkins中使用sshCommand报错如何排查解决

报错根本原因

该异常与「SSH Pipeline Steps」插件的安装、启用状态无关联,本质是不符合Jenkins声明式流水线的语法校验规则触发的Groovy编译错误:

  • 自声明式流水线0.5版本起,强制规则为:stage块内的所有可执行步骤,必须嵌套在专属的steps块中,不允许直接在stage的直接层级下放置执行类步骤(报错日志中已经明确给出了这个规则提示)。
  • 你现有代码将sshCommand直接写在stage('Remote SSH')的大括号层级下,没有被steps块包裹,编译时会被识别为stage的非法配置节,进而连续抛出“Unknown stage section”“Expected one of 'steps', 'stages', or 'parallel'”的编译报错。
修复操作

仅需将stage内部的所有远程执行命令,用steps {}块包裹即可,修正后的可运行代码片段如下:

def remote = [name: "${host}", host: "${host}", user: "root", allowAnyHosts: true]
stage('Remote SSH') {
    steps {
        sshCommand remote: remote, command: "npm install"
        sshCommand remote: remote, command: "npm run start"
    }
}

补充说明:

  • 调整结构后,流水线编译阶段会正确识别steps块内的sshCommand为插件提供的合法执行步骤,不会再触发之前的结构类校验报错。
  • 该语法约束仅适用于声明式流水线结构;如果使用纯脚本式流水线(外层无强制pipeline {}根块),则无需额外嵌套steps块,即可直接在stage下放置执行步骤。

内容的提问来源于stack exchange,提问作者Darryl RN

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 06:45:08