如何通过SSH认证添加Azure DevOps仓库为Flux源及报错解决

1. 修正Azure DevOps SSH URL格式 #

Azure DevOps的SSH Git URL必须包含:v3路径段，这是容易忽略的关键细节，正确格式如下：

ssh://<user>@vs-ssh.visualstudio.com:v3/<org-name-with-space>/<project-name>/<repo-name>

2. 正确处理组织名中的空格 #

用%20替换空格，同时用单引号包裹整个URL，避免shell解析空格或转义字符干扰，最终命令：

flux create source git test-gitrepo --url='ssh://<user>@vs-ssh.visualstudio.com:v3/<orgname%20with%20space>/reponame' --branch=master --private-key-file=./private-key

3. 验证SSH密钥有效性 #

• 确认你使用的私钥对应的公钥已添加到Azure DevOps用户设置的SSH公钥列表中（Azure DevOps门户 → 用户头像 → 个人资料 → SSH公钥）
• 先手动测试SSH连通性，确保密钥能正常访问仓库：

ssh -T git@vs-ssh.visualstudio.com -p 22

成功的话会返回类似Hello <你的用户名>! You've successfully authenticated...的提示。

4. 替代方案：用HTTPS + PAT快速解决 #

既然你已经用PAT完成了Flux引导，也可以直接切换到HTTPS模式，避开SSH的空格解析问题：

flux create source git test-gitrepo --url='https://<orgname%20with%20space>@dev.azure.com/<orgname%20with%20space>/<项目名>/_git/reponame' --branch=master --username='任意值' --password='你的Azure DevOps PAT'

注意：HTTPS模式下用户名可以填任意字符串，密码直接填你的PAT即可。

内容的提问来源于stack exchange，提问作者santosh.a