如何确认DevOps CI/CD流水线中Azure CLI部署为增量部署？

核心结论 #

Azure CLI 执行资源部署（比如通过 az deployment group create 或 az deployment sub create 等命令）时，默认采用增量部署模式——只会部署模板中定义的新增/变更资源，不会删除现有未在模板中定义的资源。

如何确认及控制部署模式 #

1. 通过CLI命令参数明确指定 #

Azure CLI的部署命令支持通过 --mode 参数指定部署模式，若未显式指定则默认是增量模式。

• 显式指定增量模式的命令示例：

az deployment group create --resource-group <你的资源组名> --template-file <模板路径> --mode Incremental

• 若切换为完整模式（会删除模板未定义的资源），则将参数改为 --mode Complete。

2. 查看Azure门户部署记录 #

部署完成后，进入对应资源组的「部署」页面，找到目标部署记录，查看「模式」字段即可确认是增量还是完整模式。

3. 检查DevOps流水线日志 #

在流水线的执行日志中，搜索部署命令的输出内容，会包含模式相关的日志，比如：

Using deployment mode 'Incremental'.

与ARM模板任务的差异 #

DevOps的ARM模板部署任务提供了可视化的模式选择界面，而Azure CLI部署则需要通过命令行参数--mode来控制——两者底层调用的是同一套Azure部署引擎，只是交互方式不同。

实用验证技巧 #

部署前可使用 what-if 命令预览变更，提前确认增量部署的影响范围：

az deployment group what-if --resource-group <你的资源组名> --template-file <模板路径> --mode Incremental

该命令会列出哪些资源会被新增、修改或保留，帮你提前验证部署行为是否符合预期。

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