Azure DevOps Pipeline中Bicep模板部署失败未终止脚本的问题求助

核心问题原因 #

az deployment group create在部署失败时会把错误信息输出到标准错误流（stderr），而PowerShell默认只捕获标准输出流（stdout）内容，导致直接赋值的$deployment_result为空；同时PowerShell不会自动因外部命令的非零退出码终止脚本，所以部署失败后仍会继续执行后续步骤。

解决方法 #

1. 捕获完整输出（含错误信息） #

通过2>&1将stderr重定向到stdout，确保能获取到所有输出，再转为PowerShell对象方便后续处理：

# 执行部署命令，重定向错误流到输出流并转为JSON对象
$deployment_result = az deployment group create `
    --resource-group "你的资源组名称" `
    --template-file "./main.bicep" `
    --parameters "./parameters.json" `
    2>&1 | ConvertFrom-Json

2. 检查部署状态与命令退出码 #

结合az CLI的退出码（$LASTEXITCODE）和部署结果中的状态字段，双重验证是否部署失败，若失败则抛出异常终止脚本：

# 检查命令执行是否出错
if ($LASTEXITCODE -ne 0) {
    $errorDetails = $deployment_result.properties.error.message ?? "未返回详细错误信息"
    throw "Bicep模板部署失败：$errorDetails"
}

# 额外检查部署的最终状态
if ($deployment_result.properties.provisioningState -eq "Failed") {
    throw "部署状态异常：$($deployment_result.properties.error.message)"
}

3. 配置PowerShell错误行为（可选） #

在脚本开头添加以下配置，让PowerShell对错误更敏感，避免忽略潜在问题：

# 让PowerShell遇到cmdlet错误时立即终止
$ErrorActionPreference = "Stop"
# 禁用进度条输出，减少日志干扰
$ProgressPreference = "SilentlyContinue"

完整示例脚本 #

$ErrorActionPreference = "Stop"
$ProgressPreference = "SilentlyContinue"

# 定义部署参数
$resourceGroupName = "你的资源组名称"
$templatePath = "./main.bicep"
$parametersPath = "./parameters.json"

# 执行部署并捕获结果
try {
    $deployment_result = az deployment group create `
        --resource-group $resourceGroupName `
        --template-file $templatePath `
        --parameters $parametersPath `
        2>&1 | ConvertFrom-Json
}
catch {
    throw "部署命令执行或输出解析失败：$_"
}

# 验证部署结果
if ($LASTEXITCODE -ne 0 -or $deployment_result.properties.provisioningState -eq "Failed") {
    $errorMsg = $deployment_result.properties.error.message ?? "未知错误"
    throw "Bicep模板部署失败：$errorMsg"
}

Write-Host "Bicep模板部署成功！"

配置完成后，一旦部署失败，PowerShell脚本会立即抛出异常，Azure DevOps Pipeline会自动终止并标记为失败，同时输出详细错误信息便于排查。

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