SemaphoreUI连接Azure DevOps远程及本地仓库问题求助
问题背景
Ubuntu 24.04 LTS通过Snap安装SemaphoreUI，需连接Azure DevOps Git仓库运行Ansible Playbook，尝试HTTPS、SSH、本地路径/仓库均失败，具体报错如下：
HTTPS方式报错
cloning Repository https://dev.azure.com/xxx/xxx/_git/semaphoreui-automation
Unable to clone repository: unexpected client error: unexpected requesting "https://xxx:xxx@dev.azure.com/xxx/xxx/_git/semaphoreui-automation/git-upload-pack" status code: 400
4:37:19 PM
Failed updating repository: unexpected client error: unexpected requesting "https://xxx:xxx@dev.azure.com/xxx/xxx/_git/semaphoreui-automation/git-upload-pack" status code: 400
4:37:19 PM
Running app failed: unexpected client error: unexpected requesting "https://xxx:xxx@dev.azure.com/xxx/xxx/_git/semaphoreui-automation/git-upload-pack" status code: 400
SSH方式（Azure DevOps推荐URL）报错
Cloning Repository git@ssh.dev.azure.com:v3/xxx/xxx/semaphoreui-automation
Unable to clone repository: object not found
Failed updating repository: object not found
SSH方式（Semaphore文档推荐ssh://格式）报错
Cloning Repository ssh://ssh.dev.azure.com:v3/xxx/xxx/semaphoreui-automation
Unable to clone repository: parse "ssh://ssh.dev.azure.com:v3/xxx/xxx/semaphoreui-automation": invalid port ":v3" after host
Failed updating repository: parse "ssh://ssh.dev.azure.com:v3/xxx/xxx/semaphoreui-automation": invalid port ":v3" after host
本地路径方式报错
Failed in finding static repository at /opt/git/semaphoreui-automation: stat /opt/git/semaphoreui-automation: no such file or directory
本地Git仓库方式报错
Unable to clone repository: exec: "git": executable file not found in $PATH
解决方案
1. 修复Azure DevOps SSH连接问题
Azure DevOps的SSH URL格式需修正，正确的ssh://写法为：
ssh://git@ssh.dev.azure.com/v3/xxx/xxx/semaphoreui-automation
（原格式错误将:v3识别为端口，实际应为路径的一部分）
操作步骤：
- 提前在Azure DevOps账户中添加SSH公钥
- 在SemaphoreUI密钥库中配置对应的私钥
- 仓库URL填写上述修正后的
ssh://格式，测试克隆连接
2. 修复HTTPS连接400错误
HTTPS 400错误多为凭据配置问题：
- 不要在URL中嵌入用户名密码，单独创建Azure DevOps个人访问令牌（PAT），确保令牌拥有代码读取权限
- 在SemaphoreUI凭据管理中添加该PAT，用户名留空，密码填写令牌内容
- 仓库URL使用普通HTTPS格式：
https://dev.azure.com/xxx/xxx/_git/semaphoreui-automation，关联刚创建的凭据
3. 解决本地仓库Git命令缺失问题（Snap沙箱限制）
方式一：给Snap包添加Git访问权限
执行命令开放沙箱对系统Git的访问：
sudo snap connect semaphoreui:git
之后重新尝试连接本地Git仓库。
方式二：改用包管理器重新安装
若Snap沙箱限制仍无法解决，卸载Snap版本后改用官方Deb包安装：
- 卸载Snap版本：
sudo snap remove semaphoreui
- 下载并安装Deb包：
wget https://github.com/semaphoreui/semaphoreui/releases/latest/download/semaphoreui_amd64.deb sudo dpkg -i semaphoreui_amd64.deb
安装后系统全局Git命令可直接被SemaphoreUI调用，本地仓库连接问题即可解决。
4. 本地路径仓库错误排查
- 验证路径存在性：
ls -ld /opt/git/semaphoreui-automation
- 若路径不存在，先手动克隆仓库到该位置：
git clone https://dev.azure.com/xxx/xxx/_git/semaphoreui-automation /opt/git/semaphoreui-automation
- 调整路径权限确保SemaphoreUI可读取：
sudo chown -R $USER:$USER /opt/git/semaphoreui-automation
内容的提问来源于stack exchange，提问作者kkk
