如何在ARM模板中引用VSTS的buildID变量部署Azure WebApp？

我来给你分享几个在Azure DevOps（原VSTS）环境下，不用在ARM模板里硬编码buildID的实用方案，亲测有效：

这是最规范的做法，核心思路是把镜像标签做成ARM模板的参数，然后在发布任务里动态传入buildID：

1. 修改ARM模板，添加参数
   先在你的ARM模板的parameters节点里新增一个接收镜像标签的参数：

   "parameters": {
     // 其他参数...
     "dockerImageTag": {
       "type": "string",
       "metadata": {
         "description": "Docker镜像的标签，对应构建任务的buildID"
       }
     }
   }
   

   接着在模板中引用这个参数，比如配置WebApp的Linux镜像版本时（如果是Windows容器，对应修改windowsFxVersion）：

   "resources": [
     {
       "type": "Microsoft.Web/sites",
       "apiVersion": "2022-03-01",
       "name": "[parameters('webAppName')]",
       "properties": {
         "siteConfig": {
           "linuxFxVersion": "[concat('DOCKER|your-acr-name.azurecr.io/your-image-name:', parameters('dockerImageTag'))]"
         }
       }
     }
   ]
   

2. 在Azure DevOps发布任务中传递参数
   在发布管道的「ARM模板部署」任务里，找到「模板参数」区域，添加一行参数：

   -dockerImageTag $(Build.BuildId)
   

   这里的$(Build.BuildId)是构建管道自动生成的变量，只要你的发布管道是关联到构建管道的（也就是从构建触发发布），这个变量就能直接被引用。

如果你的buildID需要在多个发布任务或模板中使用，可以用变量组来统一管理：

1. 在构建管道中保存buildID到变量组
   在构建管道的某个任务（比如「PowerShell」任务）里，添加脚本把Build.BuildId写入变量组：

   az pipelines variable-group variable update --group-id <你的变量组ID> --name BuildId --value $(Build.BuildId) --org https://dev.azure.com/你的组织名/ --project 你的项目名
   

   （需要确保服务连接有足够权限修改变量组）
2. 在发布管道中引用变量组
   在发布管道的「变量」选项卡中，添加你刚才更新的变量组，然后在ARM模板部署任务的参数里用-dockerImageTag $(BuildId)即可。

如果不想修改ARM模板的参数，也可以用占位符替换的方式：

1. 在ARM模板中设置占位符
   把模板里的镜像标签写成一个占位符，比如：

   "linuxFxVersion": "DOCKER|your-acr-name.azurecr.io/your-image-name:__BUILD_ID__"
   

2. 在发布任务中启用变量替换
   在「ARM模板部署」任务里，找到「变量替换」区域，勾选「替换ARM模板中的变量」，然后添加一个变量：
   • 名称：__BUILD_ID__
   • 值：$(Build.BuildId)
     部署时，Azure DevOps会自动把模板里的__BUILD_ID__替换成实际的buildID。

注意事项 #

• 确保发布管道是关联到构建管道的，否则无法直接获取$(Build.BuildId)变量；如果是手动触发发布，可以手动输入buildID，或者给变量设置默认值。
• 如果使用的是Azure容器注册表（ACR），还要确保WebApp有拉取镜像的权限，比如配置ACR的服务主体或者启用系统分配的身份验证。

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