Azure DevOps部署至Azure VM时CD阶段deploy.sh路径创建失败咨询
Azure DevOps VM持续部署阶段路径创建报错排查方案
核心排查方向
- 校验执行账号的目录操作权限
- 确认自承载部署代理的运行账号,对报错提示的目标父路径拥有写入、创建子目录的权限。常见场景为代理运行默认非root账号时,对
/var/www、/opt这类系统级目录无写入权限,即便deploy.sh本身存放路径正确,脚本内部执行mkdir创建部署目录的操作也会直接触发路径创建失败报错。 - 核对deploy.sh内部硬编码的部署路径:排查脚本中所有
mkdir指令对应的上层路径是否已在目标VM上存在,比如脚本中配置了mkdir -p /home/deploy/service/run,但对应的/home/deploy目录未提前创建时,就会直接抛出无法创建指定路径的错误。
- 确认自承载部署代理的运行账号,对报错提示的目标父路径拥有写入、创建子目录的权限。常见场景为代理运行默认非root账号时,对
- 核对yaml配置与实际路径的匹配度
- 确认部署任务中指定的脚本路径参数,与自承载代理实际存储deploy.sh的绝对路径完全一致。常见错配场景为在yaml中填写了仓库相对路径,而自承载代理执行时的路径解析根目录是代理自身的工作目录,并非仓库checkout目录,会引发路径查找错位的连锁报错。
- 检查自承载代理的工作目录权限,确认目录无只读挂载、权限锁定等限制,保障代理可正常读取目录下的deploy.sh文件。
- 增加日志输出定位执行上下文
- 在deploy.sh的起始位置增加调试命令,通过
whoami、pwd、ls -la指令打印脚本实际运行的账号、当前所在目录、目录内文件列表,将输出同步到流水线日志,即可直接定位路径解析错误的具体节点。 - 确认deploy.sh文件本身拥有可执行权限,排除仓库checkout时权限映射异常导致脚本无法正常执行内部创建路径逻辑的问题。
- 确认deploy.sh的换行格式为LF,排除Windows环境编辑带来的CRLF换行符问题——这类问题会导致Linux下的脚本解析异常,部分场景下也会触发路径创建相关的报错。
- 在deploy.sh的起始位置增加调试命令,通过
内容的提问来源于stack exchange,提问作者crispy
相关产品推荐
相关产品推荐

