如何使用新包版本升级现有Azure Managed Applications实例?
现有Azure托管应用实例升级至新部署包的操作流程
升级前置校验
- 确认新部署包和现有实例的兼容性基础要求:
mainTemplate.json不能包含破坏性变更,比如直接删除实例已部署的核心资源、修改资源ID匹配规则、跨不兼容版本更新资源API版本,避免升级时触发资源重建导致数据丢失viewDefinition.json的调整需保留原有绑定的核心交互逻辑,不要移除已和实例配置绑定的自定义视图节点
- 将包含
mainTemplate.json、viewDefinition.json的新包按规范打包为ZIP格式,上传到原托管应用定义所关联的同一存储容器中,生成具备读权限的SAS访问地址,确保SAS有效期覆盖整个升级操作周期。
正式升级操作
门户操作路径
- 定位到已发布的托管应用定义资源(即存储应用包元数据的定义资源,区别于用户实际部署的实例资源)
- 进入定义的配置页面,将原有包文件的SAS地址替换为新部署包的对应SAS地址,同步更新定义的版本标识(如从v1.0.0更新为v1.1.0),保存定义的变更
- 找到需要升级的目标托管应用实例,进入实例概览页:
- 在设置板块找到「升级」入口,系统会自动检测到关联的托管应用定义已更新
- 核对新模板的参数要求,若新
mainTemplate.json新增了必填参数,需在升级流程中补全对应参数值 - 确认升级配置后触发流程,等待部署完成即可。
命令行操作路径
- 先通过命令行更新现有托管应用定义的包配置与版本号,无需新建独立的托管应用定义条目
- 对目标实例触发增量部署时,关联更新后的托管应用定义ID,传入匹配新模板要求的参数值,在实例所属资源组范围内执行部署即可。
可参考的核心命令形式:New-AzResourceGroupDeployment
关键注意事项
- 不要通过新建独立托管应用定义的方式触发现有实例升级,否则会导致实例关联的托管资源组访问权限、委托管理关系断裂
viewDefinition.json的变更会随托管应用定义的包更新自动生效,无需对已部署实例做单独的视图配置操作- 若新
mainTemplate.json中新增了部署资源,升级流程会自动在实例对应的托管资源组下创建对应资源,无需提前手动预创建。
内容的提问来源于stack exchange,提问作者Matthieu Maitre
相关产品推荐
相关产品推荐

