使用YAML流水线重启Azure WebApp遇资源授权问题求助

问题描述 #

我尝试用YAML流水线重启两个Azure Web App，配置后运行出现资源授权错误，提示azureSubscription引用的服务连接未找到或未授权。点击「授权资源」后显示成功，但重跑任务时提示no plan found for identifier，流水线仍无法正常执行。期望流水线能完成两个Web App的重启操作，附上我的YAML代码：

# Starter pipeline
trigger: none

jobs:
  - ${{if contains(variables['Build.SourceBranch'], 'dev')}}:
    - deployment: "DEV_Deployment"
      displayName: "Start Deployment"  
      environment: "DEV"
      pool:
        vmImage: 'windows-latest'
      variables:
        - group: dev_vars
      strategy:
        runOnce:
          deploy:
            steps:
              - checkout: self              
              - task: AzureAppServiceManage@0
                displayName: "Restart 1st App Service"
                inputs:
                  azureSubscription: <<subscription name>>
                  Action: 'Restart Azure App Service'
                  WebAppName: <<web app 1 name>>
                  SpecifySlotOrASE: false
                  ResourceGroupName: <<resource group name>>
                  Slot: 'production'
              - task: AzureAppServiceManage@0
                displayName: "Restart 2nd App Service"
                inputs:
                  azureSubscription: <<subscription name>>
                  Action: 'Restart Azure App Service'
                  WebAppName: <<web app 2 name>>
                  SpecifySlotOrASE: false
                  ResourceGroupName: <<resource group name>>
                  Slot: 'production'

原因分析及解决方案 #

1. 服务连接名称填错 #

YAML里的azureSubscription需要填Azure DevOps服务连接的名称，不是Azure订阅的名称，很多人会搞混：

• 进入项目的「项目设置」→「服务连接」，找到对应Azure订阅的服务连接，复制它的显示名称
• 把YAML中的<<subscription name>>替换成这个服务连接名称，比如：

  azureSubscription: '我的Azure订阅服务连接'
  

2. 服务连接权限不够 #

即使授权按钮提示成功，服务连接对应的服务主体可能没权限操作Web App：

• 登录Azure门户，找到目标Web App所在的资源组
• 进入「访问控制(IAM)」→「添加角色分配」，给服务连接的服务主体分配网站参与者或参与者角色，确保它能执行重启操作

3. 环境资源未关联 #

因为你用了environment: "DEV"，得确保环境和Web App资源关联上：

• 打开Azure DevOps的「环境」页面，找到DEV环境
• 点击「添加资源」→选「Azure Web App」，把要操作的两个Web App关联进去
• 确认环境里的资源名称、资源组和YAML里的完全一致

4. 重跑缓存问题 #

重跑失败任务可能触发缓存异常，别直接重跑，重新触发整个流水线：

• 直接点击流水线的「运行流水线」按钮，发起全新的运行
• 或者在YAML编辑页面点「保存并运行」

5. 分支条件不满足 #

你的流水线加了${{if contains(variables['Build.SourceBranch'], 'dev')}}条件，要确保触发流水线的分支确实包含dev（比如dev分支或者feature/dev-xxx）。可以先把这个条件去掉测试，确认任务能正常执行后再加回来。

调整后的示例YAML #

# Starter pipeline
trigger: none

jobs:
  - deployment: "DEV_Deployment"
    displayName: "Start Deployment"  
    environment: "DEV"
    pool:
      vmImage: 'windows-latest'
    variables:
      - group: dev_vars
    strategy:
      runOnce:
        deploy:
          steps:
            - checkout: self              
            - task: AzureAppServiceManage@0
              displayName: "Restart 1st App Service"
              inputs:
                azureSubscription: '你的服务连接名称'
                Action: 'Restart Azure App Service'
                WebAppName: 'web-app-1-name'
                SpecifySlotOrASE: false
                ResourceGroupName: 'resource-group-name'
                Slot: 'production'
            - task: AzureAppServiceManage@0
              displayName: "Restart 2nd App Service"
              inputs:
                azureSubscription: '你的服务连接名称'
                Action: 'Restart Azure App Service'
                WebAppName: 'web-app-2-name'
                SpecifySlotOrASE: false
                ResourceGroupName: 'resource-group-name'
                Slot: 'production'

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