Jenkins部署React微前端Storybook时Git主机密钥警告致失败求助

先修正Jenkinsfile的语法错误 #

你提供的代码片段存在多处语法问题，这可能是流水线失败的直接诱因：

• 所有引号需使用英文双引号/单引号，比如Stage("build and push storybook")，而非中文引号
• Docker.image("${BUILD-IMAGE}").inside('root') 缺少闭合括号，且容器内执行命令需要用花括号包裹
• Yarn build-storybook 需用sh命令包裹，改为sh 'yarn build-storybook'
• Commit_and_push 的参数格式错误，键值对需用冒号加逗号分隔，示例如下：

Commit_and_push(
  Files: ['storybook-static'],
  Branch: 'gh-pages'
)

修正后的代码片段参考：

Stage("build and push storybook"){
  Script{
    Try{
      sh 'ls -al'
      Build.install()
      Docker.image("${BUILD_IMAGE}").inside('root') {
        sh 'yarn build-storybook'
      }
    } Catch( Exception e){throw e}
    Try{
      Commit_and_push(
        Files: ['storybook-static'],
        Branch: 'gh-pages'
      )
    } Catch( Exception e){throw e}
  }
}

处理ECDSA主机密钥提示问题 #

这个提示是Git首次连接GitHub服务器时需要确认主机身份，但Jenkins在非交互式环境下无法完成确认，导致流水线卡住。提供两种解决方法：

方法1：提前配置known_hosts #

在Jenkins运行节点（或Docker容器内）执行以下命令，将GitHub的ECDSA密钥加入known_hosts：

ssh-keyscan github.com >> ~/.ssh/known_hosts

如果要在流水线中动态执行，可在Git操作前添加：

sh 'ssh-keyscan github.com >> ~/.ssh/known_hosts'

方法2：禁用Git的StrictHostKeyChecking #

在流水线中添加Git全局配置，跳过主机密钥检查（注意：此方法会降低安全性，仅适合可信CI环境）：

sh 'git config --global core.sshCommand "ssh -o StrictHostKeyChecking=no"'

解决SSH权限拒绝问题 #

改用SSH链接后出现权限拒绝，按以下步骤排查：

• 确认SSH密钥配置：生成的SSH私钥需放在Jenkins节点（或容器内）的~/.ssh/id_rsa，权限设置为600（执行chmod 600 ~/.ssh/id_rsa）；公钥要添加到GitHub仓库的Deploy Keys（勾选允许写入权限，因为需要push到gh-pages），或添加到你的GitHub账户SSH Keys。
• 检查容器内的密钥挂载：如果在Docker容器内执行Git操作，需将Jenkins节点的~/.ssh目录挂载到容器对应路径，示例：

Docker.image("${BUILD_IMAGE}").inside('-v ~/.ssh:/root/.ssh') {
  // 执行build和git操作
}

• 确认Git远程URL：确保流水线中Git远程仓库为SSH格式，比如git@github.com:your-username/your-repo.git，而非HTTPS格式。

额外调试建议 #

• 在流水线中添加sh 'git remote -v'和sh 'ssh -T git@github.com'命令，用来调试SSH连接状态，查看具体错误信息。
• 可以考虑使用gh-pages npm包替代自定义的Commit_and_push函数，它会自动处理Git push的细节，减少配置问题。

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