Azure DevOps Pipeline中AZ CLI upload-batch未推送文件问题
问题根因拆解
1. 脚本报错原因
The term 'Build.DefaultWorkingDirectory' is not recognized as the name of a cmdlet 报错本质是shell脚本语法错误,并非变量本身不存在:
Azure DevOps平台会在任务执行前,自动把脚本/参数中合法的$(变量名)格式占位符替换成实际值,再传给PowerShell或Bash执行。如果写路径参数时没有给路径加双引号,导致路径片段被拆成独立的命令块,PowerShell就会把替换后的路径字符串当成可执行命令解析,直接抛出该类“无法识别为cmdlet”的错误。
2. 任务显示成功但Blob无文件的核心原因
该场景不是部署真的执行成功,是路径错配导致AZ CLI上传了空目录,平台只会校验命令进程的退出码,不会主动检查上传后的文件数量,只要退出码为0就判定任务成功。常见的错配点:
- 误用CI阶段的变量路径:
$(Build.DefaultWorkingDirectory)、$(Build.ArtifactStagingDirectory)这类Build开头的变量,仅在CI构建流水线阶段有指向构建目录的有效意义。在CD发布流水线中,这类变量指向的是发布agent的空工作根目录,根本不存在解压后的构建产物 - 路径层级不匹配:把AZ CLI的
--source参数指到了制品的上层解压目录,没有定位到实际存放index.html、静态资源的那一层文件夹
CD阶段固定目录规则
CD(发布流水线)阶段的目录逻辑和CI阶段完全独立,不存在跨流水线的路径映射:
- 平台默认会把关联的CI发布制品,下载解压到发布agent的
$(System.DefaultWorkingDirectory)根路径下,实际的产物路径为$(System.DefaultWorkingDirectory)/<你关联的制品名称>/ - 不存在基于BuildId关联的产物路径,CI阶段的构建产物所有上下文在触发CD后,都会被拉取为独立的发布制品,和Build阶段的工作目录没有直接关联
可落地的修正方案
- 先确认实际产物路径:在AZ CLI上传任务前加一个PowerShell打印任务,执行
Get-ChildItem -Path $(System.DefaultWorkingDirectory) -Recurse -Depth 2,跑一次流水线就能从日志里看到所有解压后的文件实际存放的具体路径,不需要猜测变量值 - 修正AZ CLI的
--source参数:把路径替换成打印日志里看到的、存放React构建产物(含index.html)的目录绝对路径,路径必须用双引号包裹,避免解析错误,正确格式参考:az storage blob upload-batch --destination '$web' --source "$(System.DefaultWorkingDirectory)/drop/build" --account-name <你的存储账户名> --auth-mode key - 规避语法错误:所有带
$的变量占位符、存储容器名(比如$web)都必须放在半角双引号内,不要让shell把变量名当成独立命令解析 - 结果校验:在上传命令执行完成后,加一行blob存在性校验命令,确认
index.html确实被传到了$web容器,避免被任务的“成功”状态误导
常见排查盲区
- 不要把文件上传到其他自定义容器:Azure Blob静态网站的固定读取路径是
$web容器,如果命令里把目的地改成了其他普通容器,就算文件上传成功,静态网站端点也无法读取,看起来就像部署没生效 - 注意压缩包的嵌套层级:很多React构建的zip包根目录会带一层
build或dist的嵌套文件夹,如果直接把解压根目录当--source,就会把外层空目录传给AZ CLI,导致上传空内容
内容的提问来源于stack exchange,提问作者jamesamuir
相关产品推荐
相关产品推荐

