CloudOS7.0制作镜像后，下发失败什么原因

一、核心大类原因（按排查优先级）

1、镜像本身状态异常（最高概率）

1）镜像制作任务实际未真正完成，前台显示 “完成”，但后端 glance 镜像文件损坏、镜像元数据缺失。

• 检查镜像详情：查看镜像大小、磁盘格式、是否标记为可用；
• 如果镜像为虚拟机转为模板生成，原虚拟机快照 / 磁盘有损坏会导致镜像元数据不全，下发请求到后端直接校验失败，不会生成编排任务，直接订单失败。

验证：拿该镜像尝试直接创建 1 台测试虚机，若创建直接报错，确定镜像本身问题。 处理：重新制作镜像；不要直接复用异常快照做镜像。

2、存储资源不满足条件

1）目标存储池剩余空间不足；镜像下发要占用存储池空间，空间不够，预校验直接失败，不进编排； 2）目标存储池状态异常：存储池离线、ONEStor 副本异常、存储池只读； 3）镜像所在存储池与下发目标存储池存储后端类型不兼容（比如本地盘镜像下发到 ONEStor 存储池，部分版本存在兼容性限制）。

核查命令（登录 CVM 后台节点）

3、权限、配额、项目域问题

1）当前租户项目：计算、存储配额已经打满（实例数、卷数、总存储容量）；预校验阶段检测配额不足直接返回失败，不会生成编排任务； 2）子账号操作：账号缺少镜像下发、存储池操作权限； 3）镜像属于 A 项目，当前操作在 B 项目，镜像未做共享，跨项目访问镜像元数据失败。

4、平台后台组件异常（编排、cinder、glance）

特征：所有镜像下发都出现同样现象，不单单某一个镜像。 1）glance-api、cinder‑api pod 异常、重启过；镜像元数据查询接口报错； 2）orchestrator 编排服务 pod 异常，收到订单请求，调用编排创建工作流接口直接报错，无法写入编排数据库，表现：订单失败，编排页面无任何任务；

观察 pod 是否 CrashLoopBackOff、重启次数是否持续增长。

5、数据库 / 消息队列消息丢失

数据库订单记录生成，向编排服务发 mq 消息创建工作流，mq 消息丢失，订单状态写失败，编排无任务。 这种情况 web 界面完全看不到任务，需要去后台查看 rabbitmq 消息堆积。

二、分步排查操作流程

步骤 1：验证镜像可用性

1. 使用该镜像直接申请一台测试虚拟机，看是否可以正常提交；
   • 如果申请虚机直接报错 → 镜像本身损坏，优先重新制作镜像；
   • 如果申请虚机正常，说明镜像没问题，问题出在【镜像下发分发】这条业务链路。

步骤 2：核查存储池状态与剩余容量

1. Web 界面：【存储】→【存储池】确认目标存储池状态正常，读写正常，剩余空间大于镜像大小；
2. 确认源镜像存储池、目标下发存储池类型，确认是否支持跨存储池分发镜像。

步骤 3：检查项目配额、镜像共享

1. 进入当前项目【配额管理】，查看存储、卷配额是否已经用尽；
2. 如果跨项目操作镜像：镜像详情确认已共享给当前操作项目。

步骤 4：后台检查关键 pod 服务状态

登录 CVM 管理节点执行：

• 任意 pod 状态不为 Running，查看 pod 日志定位报错。

步骤 5：定位订单对应的后台日志（关键）

拿到失败订单 ID，到如下日志检索订单 ID：

1. orchestrator 编排服务日志：/var/log/orchestrator/
2. 订单服务日志：/var/log/order/

搜索 orderID，看是哪一步返回异常报错，日志会打印失败根因（配额、镜像不存在、存储池异常、接口调用异常）。

三、临时规避 & 修复方案

1. 镜像损坏：重新从原始虚拟机制作镜像，不要基于异常快照生成镜像；
2. 存储空间不足：清理存储池闲置卷 / 快照释放空间；
3. pod 异常：重启异常 pod；
4. 如果是跨存储池下发镜像功能异常，可以变通方案：导出镜像文件，在目标存储池重新导入镜像，替代页面 “下发镜像” 功能。