如何将Azure DevOps发布版本号配置到Azure Web Services环境变量

方法一：通过Azure App Service部署任务直接配置 #

这是最直接的同步方式，利用发布管道的部署任务自动传递版本号：

• 打开你的Azure DevOps发布管道，找到已有的Azure App Service部署任务（没有的话就添加一个，选择目标Web Apps实例）。
• 滚动到任务的「应用设置」区域，点击「添加」按钮。
• 键名设为易识别的名称，比如APP_BUILD_VERSION；值填对应版本变量：
  • 若版本号来自构建管道，用$(Build.BuildNumber)
  • 若用发布管道自身版本号，用$(Release.ReleaseName)
• 保存管道，下次发布时该环境变量会自动更新为最新版本号。

方法二：用Azure CLI任务手动设置（更灵活） #

如果需要自定义逻辑或单独控制设置时机，可使用Azure CLI任务：

• 在发布管道中添加Azure CLI任务，选择对应的Azure服务连接。
• 根据Web Apps操作系统选择脚本类型，输入命令：

  # Linux/Shell示例
  az webapp config appsettings set --name 你的WebApp名称 --resource-group 你的资源组名称 --settings APP_BUILD_VERSION=$(Build.BuildNumber)
  

  # Windows/PowerShell示例
  az webapp config appsettings set --name 你的WebApp名称 --resource-group 你的资源组名称 --settings APP_BUILD_VERSION=$(Build.BuildNumber)
  

• 该命令会直接更新Web Apps的应用设置，将版本号写入指定环境变量。

代码中读取环境变量 #

不同语言的读取方式示例：

• .NET：Environment.GetEnvironmentVariable("APP_BUILD_VERSION")
• Node.js：process.env.APP_BUILD_VERSION
• Python：import os; os.getenv("APP_BUILD_VERSION")
• Java：System.getenv("APP_BUILD_VERSION")

利用版本号实现缓存刷新 #

拿到版本号后，将其作为查询参数附加到静态资源路径后：

<!-- HTML示例 -->
<link rel="stylesheet" href="/css/main.css?v=<%= APP_BUILD_VERSION %>">
<script src="/js/app.js?v=<%= APP_BUILD_VERSION %>"></script>

版本更新时查询参数变化，浏览器会强制请求新资源，避免缓存旧内容。

注意事项 #

• 确保Azure DevOps服务连接对目标Web Apps和资源组拥有Contributor权限，否则无法修改应用设置。
• 若不想因更新环境变量导致Web Apps重启，可使用部署槽：先更新槽的应用设置，再交换槽到生产，不影响在线服务。
• 版本号格式可在Azure DevOps的构建/发布管道设置中自定义，比如yyyyMMdd.xxx这类实用格式。

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