Azure WebApp：配置/用户数据与应用独立部署及版本控制需求

嘿，针对你这个需求，我刚好有一套成熟的解决方案，基于你正在用的Azure和VSTS（现在统一叫Azure DevOps了，不过咱们就按你提到的工具栈来），既能让客户安全管理配置/数据文件，又能自动同步到WebApp的wwwroot目录，还能把所有变更都纳入版本控制，具体步骤如下：

咱们核心要解决三个问题：

1. 把配置文件和API源码分开存放，避免客户接触到核心代码
2. 让客户能对配置文件做增删改，且所有操作都被版本控制
3. 配置仓库有变更时，自动同步到Azure WebApp的wwwroot对应路径

所以架构上我们会用两个独立的Git仓库：一个存API源码，一个专门存配置文件；再通过VSTS的Pipeline实现配置仓库变更后的自动同步。

1. 创建独立的配置文件仓库 #

• 先在VSTS里新建一个Git仓库（比如命名为api-wwwroot-configs），专门用来存放需要同步到WebAppwwwroot的文件。注意仓库的目录结构要和WebAppwwwroot里的对应文件夹保持一致，比如你要同步wwwroot/configs和wwwroot/data，那仓库里就建configs/和data/文件夹，后续同步时路径匹配会更顺畅。
• 给你的客户（API所有者）分配这个仓库的Contributor权限——这样他们就能创建、编辑、删除文件，而且所有操作都会被Git自动记录版本，不用担心误删或者找不到历史版本。

2. 配置VSTS Pipeline实现自动同步 #

接下来要做的是：当配置仓库有任何提交时，自动触发Pipeline把文件同步到WebApp的wwwroot。这里用Azure CLI任务最方便，不用复杂的脚本：

2.1 新建Pipeline并设置触发规则 #

• 在VSTS里新建一个YAML类型的Pipeline，关联刚才创建的配置文件仓库。
• 设置触发条件：只要main分支（或者你指定的分支）有文件变更，就自动运行Pipeline。YAML开头可以这么写：

trigger:
  branches:
    include:
      - main
  paths:
    include:
      - '*' # 监控仓库里所有文件的变更

2.2 添加文件同步任务 #

在Pipeline里添加Azure CLI任务，用az webapp deploy命令直接把仓库里的文件同步到WebApp的wwwroot：

steps:
- task: AzureCLI@2
  inputs:
    azureSubscription: '<你的Azure服务连接名称>' # 提前在VSTS里配置好连接Azure的服务连接
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      # 把仓库根目录的所有文件同步到WebApp的wwwroot目录
      az webapp deploy --resource-group <你的WebApp所在资源组名称> --name <你的WebApp名称> --src-path . --target-path /wwwroot --type static --clean false

• 参数说明：
  • --src-path .：指定要同步的源是当前仓库的根目录
  • --target-path /wwwroot：指定同步到WebApp的wwwroot目录
  • --type static：告诉Azure这是静态文件部署，跳过应用程序的重启（如果需要重启可以去掉这个参数）
  • --clean false：表示不删除WebApp里已存在但仓库中没有的文件（如果需要完全同步，删除多余文件的话改成true，但要谨慎操作）
• 如果只需要同步特定文件夹，比如仓库里的configs/到WebApp的wwwroot/configs，就把--src-path改成./configs，--target-path改成/wwwroot/configs就行。

3. （可选）给客户提供简易操作方式 #

如果客户不熟悉Git命令，完全可以教他们用VSTS仓库的Web界面操作：

• 直接在VSTS的仓库页面上传、编辑、删除文件，所有操作都会自动提交到Git，触发Pipeline同步，不用敲命令。
• 如果客户需要更友好的界面，也可以基于这个配置仓库的API搭个简单的Web工具，但这属于额外开发，看你需求要不要做。

4. 验证同步流程 #

最后别忘了测试一下：

• 让客户在配置仓库里新建一个test.json文件并提交，看看Pipeline是不是自动启动了。
• 等Pipeline跑完，登录WebApp的Kudu控制台（https://<你的WebApp名称>.scm.azurewebsites.net/DebugConsole），去wwwroot目录看看test.json是不是已经同步过去了。
• 再测试删除和更新操作，确认WebApp里的文件也会跟着变。

• 权限隔离：一定要确保客户只有配置仓库的权限，不能让他们访问API源码仓库或者WebApp的敏感配置（比如应用设置、连接字符串）。
• 版本回溯：所有配置文件的变更都存在Git仓库里，随时可以回滚到历史版本，不用担心误操作。
• Pipeline权限：VSTS里的Azure服务连接需要有WebApp的Contributor权限，不然没法同步文件。
• 冲突处理：如果多个客户同时改同一个文件，Git会自动提示冲突，需要客户解决后再提交，避免同步出问题。

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