如何调试 Jenkins 错误消息“找不到合适的 ssh-agent 提供程序”？答案

【问题标题】：How to debug Jenkins error message "could not find a suitable ssh-agent provider"?如何调试 Jenkins 错误消息“找不到合适的 ssh-agent 提供程序”？
【发布时间】：2014-02-16 08:28:50
【问题描述】：

我在 Win7 上使用 Jenkins，并为 ssh-agent 插件安装了 tomcat。我可以通过 ssh 通过 git bash 克隆我的 GitLab 项目。
但如果我由 Jenkins 构建项目，它总是说：

[ssh-agent] Using credentials IliptonChen(APRTest)
[ssh-agent] Looking for ssh-agent implementation...
[ssh-agent] FATAL: Could not find a suitable ssh-agent provider
FATAL:[ssh-agent] Unable to start agent

The full output text is here

我做错了什么吗？

【问题讨论】：

相关：Running builds on slave nodes gives me Could not find a suitable ssh-agent provider error.

标签： windows git ssh jenkins

【解决方案1】：

检查您的ssh-agent used by Jenkins 的版本。
此错误（适用于 linux，但也适用于 Windows）报告（10 天前，2014 年 1 月）同样的错误消息：
“JENKINS-20276: Native Library Error after upgrading ssh-agent from 1.3 to 1.4”。

降级到 1.3 解决了这个问题。

5 年后的 2019 年更新：如评论所述，现在应该修复。

ssh-agent.exe 是Git for Windows distribution 的一部分

D:\git\git>where ssh-agent.exe
D:\prgs\gits\current\usr\bin\ssh-agent.exe

（前提是path/to/git/usr/bin是Jenkins使用的%PATH%中的第一个）

【讨论】：

谢谢，我的 ssh-agent 插件版本是 1.4.1 我在哪里可以找到 1.3？我是 Jenkins 的新手。
@user2544979 因为 Jenkins 不允许轻松降级 (issues.jenkins-ci.org/browse/JENKINS-14530)，您必须关注 jenkins-ci.361315.n4.nabble.com/…，并将旧的 hpi 文件复制到当前文件上（对于此插件和 @987654326 @: 1.3 也）：你需要尊重插件依赖：wiki.jenkins-ci.org/display/JENKINS/…
@user2544979 ssh-agent 1.3：github.com/jenkinsci/ssh-agent-plugin/releases/tag/…（来自github.com/jenkinsci/ssh-agent-plugin/releases）。 SSH 凭据 1.3：github.com/jenkinsci/ssh-credentials-plugin/releases/tag/…（来自github.com/jenkinsci/ssh-credentials-plugin/releases）
我可以用 GIT_SSH 代替 ssh-agent 吗？
我只需将%ProgramFiles%\Git\usr\bin 添加到PATH 的前端即可解决此问题。

【解决方案2】：

对于windows，该插件仍然需要在master and slave中都安装Tomcat。

【讨论】：

从 SSH 代理插件 1.14 开始不再需要。它可以使用可以通过PATH 环境变量找到的“sshagent.exe”（例如，来自 Git 安装）。

【解决方案3】：

假设你已经在 Windows slave 上安装了 Windows Git，它带有ssh-agent 二进制文件（例如C:\Program Files\Git\usr\bin）。尝试将其路径添加到系统变量PATH。

否则取消勾选 SSH 代理 并通过从 Source Code Management 部分的下拉菜单中选择 Credentials 来选择凭据。

另一种方法是为该 GitHub 用户生成 personal API token (OAuth) 并将其与您的存储库地址一起包含，例如

git clone https://4UTHT0KEN@github.com/foo/bar

【讨论】：

Make sure to insert the path of ssh-agent binary before the path of Windows own ssh-agent。 Windows 版本的ssh-agent 与 SSH 代理插件不兼容。在将标准 Jenkins 安装附带的 32 位 Java 运行时替换为 64 位 Java 运行时后，这让我很痛苦。 32 位 Java 运行时没有显示这个问题，因为 Windows 的 ssh-agent 仅在 64 位“system32”目录中可用，因此不会被 32 位程序找到。

【解决方案4】：

我收到此错误是因为我使用的是代理的 Ubuntu 映像，该代理没有安装 SSH。

agent {
    docker { image 'ubuntu:focal' }
}

...所以解决方案就像安装 SSH 作为管道的一部分一样简单：

steps {
    sh "apt-get update && apt-get install ssh -y"
    // rest of your steps here...
}

【讨论】：