You need to enable JavaScript to run this app. 如何使用新包版本升级现有Azure Managed Applications实例?
优惠活动
大模型
产品
解决方案
定价
更多

如何使用新包版本升级现有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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 19:54:06