使用YAML更新Azure Container Apps时出现未指定的无效修订名称错误

排查方向 #

• 检查镜像标签关联逻辑：自动生成的修订后缀通常和镜像标签绑定，你的镜像标签是1.0.263，大概率是Azure在拼接容器名myapp和标签时多生成了一个-。重点排查DevOps流水线里镜像标签的生成逻辑，是否存在变量拼接时的多余连字符。
• 验证自动命名规则异常：Azure Container Apps未指定修订后缀时，会基于镜像标签或更新参数自动生成后缀。检查容器应用的历史修订记录，看是否有异常命名的修订残留，导致后续生成规则出错。
• 排查CLI/流水线的隐性参数：即使没显式指定--revision-suffix，某些参数组合可能触发自动生成带多余连字符的名称。比如流水线中是否误传了空值的--revision-suffix参数，导致拼接时多出一个-。
• 检查变量替换的完整性：DevOps里的版本号变量是否有前置/后置空格、特殊字符，替换后导致标签格式异常。比如版本变量是否被意外定义成-1.0.263，拼接后就变成myapp--1.0.263。

解决办法 #

• 显式指定合规的修订后缀：在az containerapp update命令中添加--revision-suffix参数，把版本号里的点换成连字符，确保名称符合规则。示例命令：

  az containerapp update --name myapp --resource-group <你的资源组名> --image <你的镜像地址>:1.0.263 --revision-suffix "1-0-263"
  

• 修正镜像标签格式：将镜像标签中的.替换为-，比如用1-0-263代替1.0.263，这样自动生成的修订名称会是myapp-1-0-263，完全符合命名要求。
• 重置修订生成逻辑：手动创建一个合规的修订，触发系统重新识别命名规则。先部署一个指定后缀的修订，再执行常规更新，后续自动生成的名称应该会恢复正常。
• 修复流水线变量处理：在流水线中对版本号变量做格式化处理，比如用PowerShell或Bash脚本把.替换成-，确保变量输出为纯字母数字加连字符的格式。

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