ArgoCD声明式配置SSH私有仓库部署Guestbook Helm应用报错排查

报错根因说明 #

你遇到的SSH agent requested but SSH_AUTH_SOCK not-specified报错，本质是ArgoCD repo server未匹配到对应私有仓库的SSH凭证，默认尝试调用系统SSH Agent验证，但容器内未启动SSH Agent导致的。你通过GUI手动配置仓库正常，说明密钥本身和权限无问题，问题出在声明式凭证的匹配逻辑上。

排查&解决步骤 #

• 统一URL格式，避免混用
  ArgoCD的仓库凭证是严格前缀匹配的，必须保证Secret中的url字段和Application中的repoURL字段格式完全一致，不能一个用git@github.com:myOrg/myrepo.git格式，另一个用ssh://git@github.com/myOrg/myrepo.git格式，两种格式无法互相匹配。
• 验证仓库凭证Secret的标签配置
  确认你的RepoCreds Secret中已正确添加标签：argocd.argoproj.io/secret-type: repository，拼写错误或者缺少该标签的话，ArgoCD不会将该Secret识别为仓库凭证，自然无法匹配使用。
• 检查私钥格式与配置
  1. 确认sshPrivateKey字段使用|块标量标识，私钥内容缩进正确，没有多余的前置空格、尾部空行或者内容截断
  2. 如果你的SSH私钥设置了密码，需要在Secret的stringData中额外添加字段sshPrivateKeyPassphrase: 你的私钥密码，否则ArgoCD会调用SSH Agent输入密码触发报错
• 验证凭证是否被ArgoCD正常加载
  执行以下命令查看ArgoCD已识别的仓库列表，确认你的私有仓库在列表中：

kubectl exec -n argocd deploy/argocd-repo-server -- argocd repo list

如果未找到对应仓库，可尝试将Secret的url字段调整为前缀匹配格式git@github.com:，匹配所有GitHub SSH仓库，避免单仓库路径写错的问题。

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