如何通过Azure自动化Runbook将Azure DevOps仓库下载为Zip文件？

你遇到的NativeCommandError报错本质是PowerShell将git命令输出的标准进度信息（默认走stderr流）识别为错误导致，并非git clone实际执行失败。但直接调用Azure DevOps官方API下载Zip的方案更适配自动化Runbook场景，无需依赖git和posh-git环境，稳定性更高，具体实现方案如下：

前提准备 #

• 先在Azure DevOps中生成具有代码读取权限的个人访问令牌（PAT），权限范围仅勾选Code > Read即可
• 自动化Runbook的托管身份需要分配存储账户的存储 Blob 数据参与者角色，也可提前准备存储账户的访问密钥/连接字符串替代托管身份验证
• 提前在自动化账户的模块库中导入Az.Accounts、Az.Storage两个PowerShell模块

实现步骤（PowerShell Runbook示例） #

1. 调用Azure DevOps API下载仓库Zip #

Azure DevOps原生提供直接导出指定分支完整仓库为Zip的接口，无需执行git操作，示例代码如下：

# 基础参数配置
$devopsOrg = "替换为你的DevOps组织名称"
$projectName = "替换为你的项目名称"
$repoName = "替换为要备份的仓库名称"
$branchName = "main" # 按需替换为要备份的分支名
$pat = "替换为你的DevOps PAT" # 建议存到自动化账户凭据资产，不要硬编码
$outputZipPath = "./$repoName-$((Get-Date).ToString('yyyyMMddHHmm')).zip"

# 构造身份验证头
$base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$($pat)"))
$headers = @{Authorization=("Basic {0}" -f $base64AuthInfo)}

# 构造Zip下载接口地址
$downloadUrl = "https://dev.azure.com/$devopsOrg/$projectName/_apis/git/repositories/$repoName/items?path=/&versionDescriptor[versionOptions]=0&versionDescriptor[versionType]=0&versionDescriptor[version]=$branchName&resolveLfs=true&`$format=zip&api-version=7.1-preview.1"

# 下载Zip到Runbook临时路径
Invoke-RestMethod -Uri $downloadUrl -Headers $headers -Method Get -OutFile $outputZipPath

2. 上传Zip到Azure存储账户 #

# 存储账户参数配置
$storageAccountName = "替换为你的存储账户名称"
$containerName = "替换为备份文件存放的容器名称"
$blobName = Split-Path $outputZipPath -Leaf

# 用托管身份登录Azure（如果用连接字符串可直接指定New-AzStorageContext的ConnectionString参数）
Connect-AzAccount -Identity
$storageContext = New-AzStorageContext -StorageAccountName $storageAccountName

# 上传Zip到Blob存储
Set-AzStorageBlobContent -File $outputZipPath -Container $containerName -Blob $blobName -Context $storageContext

# 清理Runbook本地临时文件
Remove-Item $outputZipPath -Force

扩展说明 #

• PAT建议存储到自动化账户的凭据资产中，运行时通过Get-AzAutomationCredential接口读取，避免明文泄露
• 如果需要备份全部分支，可以先调用Azure DevOps获取分支列表的API，循环下载每个分支的Zip即可
• 如果仓库开启了LFS，接口的resolveLfs=true参数会自动拉取LFS对应的实际文件内容，无需额外处理

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