如何通过Azure DevOps Pipeline校验FunctionApp部署后函数存在

前置要求 #

• 管道已配置拥有目标Function App读取权限的Azure Resource Manager服务连接
• 使用微软托管代理可直接运行，自托管代理需提前预装Azure CLI
• 校验步骤必须放在Function App部署任务之后执行

可直接复用的校验任务 #

将以下Azure CLI任务添加到管道部署步骤的末尾，脚本会自动统计业务函数数量，数量不匹配时直接返回非0退出码，将管道运行标记为失败。

Bash版本（适配Linux/Windows通用代理） #

- task: AzureCLI@2
  displayName: 校验Function App函数数量
  inputs:
    azureSubscription: '替换为你管道中使用的Azure服务连接名'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      # 替换为实际资源配置
      RESOURCE_GROUP="你的资源组名称"
      FUNC_APP_NAME="你的Linux Function App名称"
      EXPECT_COUNT=4

      # 部署后等待20秒，避免Azure侧资源同步延迟导致误判
      sleep 20

      # 查询函数列表，过滤Azure平台内置系统函数
      func_result=$(az functionapp function list \
        --resource-group $RESOURCE_GROUP \
        --name $FUNC_APP_NAME \
        --query "[?name!='Host' && name!='Functions' && name!='Health']" \
        -o json)
      
      actual_count=$(echo $func_result | jq length)
      echo "检测到业务函数数量：$actual_count，预期数量：$EXPECT_COUNT"

      if [ $actual_count -ne $EXPECT_COUNT ]; then
        echo "##vso[task.logissue type=error]函数数量不符合预期，部署存在异常"
        exit 1
      fi

      echo "函数数量校验通过"

PowerShell版本（适配Windows代理） #

如果你的代理运行在Windows环境，将scriptType改为pscore，inlineScript替换为以下内容即可：

# 替换为实际资源配置
$RESOURCE_GROUP = "你的资源组名称"
$FUNC_APP_NAME = "你的Linux Function App名称"
$EXPECT_COUNT = 4

# 部署后等待20秒，避免Azure侧资源同步延迟导致误判
Start-Sleep -Seconds 20

# 查询函数列表，过滤Azure平台内置系统函数
$func_result = az functionapp function list `
  --resource-group $RESOURCE_GROUP `
  --name $FUNC_APP_NAME `
  --query "[?name!='Host' && name!='Functions' && name!='Health']" | ConvertFrom-Json

$actual_count = $func_result.Count
Write-Host "检测到业务函数数量：$actual_count，预期数量：$EXPECT_COUNT"

if ($actual_count -ne $EXPECT_COUNT) {
  Write-Host "##vso[task.logissue type=error]函数数量不符合预期，部署存在异常"
  exit 1
}

Write-Host "函数数量校验通过"

注意事项 #

• 如果使用部署槽位部署，在az functionapp function list命令中添加--slot 你的部署槽名称参数，避免查询到生产槽数据
• 等待时长可根据实际部署速度调整，若经常出现校验误判可适当调大等待秒数
• 若你的业务函数存在和内置过滤列表重名的情况，可自行调整--query参数的过滤规则
• 若函数列表返回空，可先在本地执行对应az命令确认权限是否正常，是否有函数被平台过滤

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