Azure DevOps技术问询：如何提交构建任务并设置晚间运行

针对你每天需要提交20个左右、无需立即执行且不能阻塞其他任务的单次构建需求，这里有几个实用的解决方案，帮你避开日间负载高峰，同时解决优先级设置无效的问题：

方案1：专用构建池+时间窗口限制（最简单的无代码方案） #

这是最省心的方式，完全通过Azure DevOps内置功能实现：

• 创建一个独立的构建代理池，专门分配给这些延迟执行的任务
• 进入组织设置 → 代理池 → 选中这个新池 → 点击「设置」→ 配置运行时间窗口，只允许在晚间（比如20:00-次日6:00）运行任务
• 提交构建任务时，指定使用这个专用池

这样一来，你提交的任务会自动进入队列，但只有到了允许的时间窗口才会占用代理资源执行，完全不会阻塞其他池中的高优先级任务，也不需要额外的代码维护。

方案2：定时脚本+REST API提交（精准控制触发时间） #

如果需要更精准的触发时机，或者不想让任务提前进入队列，可以用脚本结合Azure DevOps REST API实现：

• 编写一个脚本（比如PowerShell或Python），收集当天需要执行的20个构建任务的参数（比如构建定义ID、自定义参数等）
• 用Azure Functions、Windows任务计划器或者Linux Cron来定时触发这个脚本，在晚间指定时间批量提交构建请求
• 任务只会在指定时间被提交并执行，完全不会提前占用队列位置

举个PowerShell脚本的核心片段示例：

# 配置你的Azure DevOps信息
$orgUrl = "https://dev.azure.com/your-organization"
$projectName = "your-project"
$patToken = "your-personal-access-token"
$buildDefinitionId = 123 # 你的构建定义ID

# 设置晚间提交时间（比如20:00）
$targetSubmitTime = Get-Date -Hour 20 -Minute 0 -Second 0
# 如果当前时间已经过了20:00，就顺延到次日
if (Get-Date -gt $targetSubmitTime) {
    $targetSubmitTime = $targetSubmitTime.AddDays(1)
}

# 等待到目标时间
$waitSeconds = ($targetSubmitTime - Get-Date).TotalSeconds
Start-Sleep -Seconds $waitSeconds

# 调用API提交构建
$headers = @{Authorization = "Basic " + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(":$patToken"))}
$buildBody = @{
    definition = @{id = $buildDefinitionId}
    parameters = '{"customParam": "value"}' # 自定义构建参数
} | ConvertTo-Json

Invoke-RestMethod -Uri "$orgUrl/$projectName/_apis/build/builds?api-version=7.1-preview.7" `
    -Method Post -Headers $headers -Body $buildBody -ContentType "application/json"

方案3：管道内等待逻辑（无需额外服务） #

如果不想创建专用池或写外部脚本，可以在构建管道本身添加等待逻辑：

• 提交构建任务时，添加一个自定义变量（比如DelayUntilNight）并设为true
• 在管道的第一个步骤添加PowerShell任务，检查当前时间是否在晚间窗口内：

  $nightStart = Get-Date -Hour 20 -Minute 0 -Second 0
  $nightEnd = Get-Date -Hour 6 -Minute 0 -Second 0
  $currentTime = Get-Date
  
  # 判断是否在晚间窗口内（区分当日晚到次日早的情况）
  if ($currentTime -ge $nightStart -or $currentTime -le $nightEnd) {
      Write-Host "当前处于晚间窗口，开始执行构建"
  } else {
      # 计算等待到nightStart的秒数
      $waitSeconds = ($nightStart - $currentTime).TotalSeconds
      Write-Host "等待 $waitSeconds 秒后执行构建"
      Start-Sleep -Seconds $waitSeconds
  }
  

• 这种方式下，任务会进入队列，但会一直处于等待状态，直到晚间窗口到来才会真正占用代理资源，不会阻塞其他任务的执行

方案对比 #

根据你的需求，方案1应该是最适合的，配置一次就能长期稳定运行，完全满足你每天20个单次任务的延迟执行需求。

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