如何让Azure Pipelines后续调度任务因前次失败而排队等待

要实现「前次运行失败时，后续调度触发的管道卡在队列不执行」的需求，无需编写脚本，可通过Azure Pipelines内置的环境检查+并发限制功能完成，具体步骤如下：

步骤1：创建专属锁定环境 #

在Azure DevOps项目的「环境」页面，新建一个环境（例如命名为DBBackupLock），无需关联任何服务器/虚拟机资源，仅用于部署状态的锁定与检查。

步骤2：修改管道模板，关联环境 #

更新template.yml中的Backup阶段，添加环境关联配置，让每次管道运行都绑定到该环境：

- stage: Backup
  environment: DBBackupLock  # 新增：关联到锁定环境
  jobs:
  - job: BackupDatabase
    steps:
    - script: |
        mkdir "$(backupPath)"
      displayName: 'Create backup directory'
    # 其余备份步骤保持不变

步骤3：配置环境的部署检查规则 #

进入DBBackupLock环境的设置页面，添加并配置以下检查：

• 选择「等待之前的部署完成」检查并启用
• 勾选「如果之前的部署失败，阻止新部署」选项

该规则会让后续调度触发的运行自动卡在队列中，直到手动处理前一次失败的运行（例如标记为成功、取消失败运行或重新运行至成功）。

步骤4：设置管道并发限制 #

在Azure Pipelines的管道设置页面，找到「并行作业」配置项，将「最大并行运行数」设置为1，确保同一时间只有一个管道实例能进入执行环节，避免多个运行绕过检查规则。

最终完整配置文件 #

azure-pipelines.yml（无核心修改） #

pool: Default

schedules:
- cron: "*/3 * * * *"
  displayName: Every 10 minutes trigger
  branches:
    include:
      - main

variables:
  - group: dbbackup

parameters:
  - name: selectedDatabase
    type: string
    default: testdb
    values:
      - testdb
      - testdb1
      - testdb2

stages:
- template: template.yml
  parameters:
    selectedDatabase: ${{ parameters.selectedDatabase }}

template.yml（已添加环境关联） #

parameters:
  selectedDatabase: ''

stages:
- stage: Backup
  environment: DBBackupLock
  jobs:
  - job: BackupDatabase
    steps:
    - script: |
        mkdir "$(backupPath)"
      displayName: 'Create backup directory'

    - script: |
        sqlcmd -S $(sqlServer) -U $(sqlUser) -P $(sqlPassword) -Q "BACKUP DATABASE [$(selectedDatabase)] TO DISK = N'$(backupPath)\$(backupFileName)' WITH NOFORMAT, INIT, NAME = N'$(selectedDatabase)-Full Database Backup', SKIP, NOREWIND, NOUNLOAD, STATS = 10"
      displayName: 'Backup SQL Database'  
- stage: Restore
  dependsOn: Backup
  condition: and(succeeded(), eq(dependencies.Backup.result, 'Succeeded'))
  jobs:
  - job: RestoreDatabase
    steps:
    - script: |
        sqlcmd -S $(sqlServer) -U $(sqlUser) -P $(sqlPassword) -Q "RESTORE DATABASE [$(selectedDatabase)] FROM DISK = N'$(backupPath)\$(backupFileName)' WITH FILE = 1, NOUNLOAD, REPLACE, STATS = 5" -o "$(backupPath)\restore_log.txt"
      displayName: 'Restore SQL Database'

原理说明 #

• 环境关联后，管道运行会被识别为对该环境的「部署操作」，触发预设的检查规则
• 「失败阻止新部署」规则会让后续调度任务卡在队列中，必须手动干预前次失败的运行才能继续
• 并发限制避免多个调度任务同时进入队列，确保检查规则的有效性

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