已安装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
相关产品推荐
相关产品推荐

