导入镜像概述

最近更新时间: 2023-03-23 15:58:57

除了使用创建自定义镜像功能外,云平台同时支持使用导入功能。可将本地或其他平台的服务器系统盘镜像文件导入至云服务器(Cloud Virtual Machine,CVM)自定义镜像中。导入后可以使用该导入镜像创建云服务器或对已有云服务器重装系统。
导入准备
您需提前准备好符合导入限制的镜像文件。

镜像属性 条件
操作系统 • 基于 Ubuntu、Debian、CoreOS、openSUSE、SUSE 发行版的镜像
• 支持32位和64位
镜像格式 • 支持 RAW、VHD、QCOW2、VMDK 镜像格式
• 使用qemu-img info imageName
文件系统类型 不支持 GPT 分区
镜像大小 • 镜像实际大小不超过50G,使用qemu-img info imageName
网络 • 云平台默认为实例提供 eth0 网络接口
• 用户可以在实例内通过 metadata 服务查询实例的网络配置,详见 实例元数据
驱动 • 镜像必须安装虚拟化平台 KVM 的 Virtio 驱动,详情参考 Linux 导入镜像检查 Virtio 驱动
• 镜像需安装 cloudinit,详情参考 Linux 导入镜像安装 cloudinit
• 如因其它原因,镜像无法安装 cloudinit,请根据 强制导入镜像 自行配置实例
内核限制 镜像最好是原生内核,修改可能会导致云服务器无法导入

导入步骤
 1. 登录云服务器控制台,单击左侧导航栏中的 镜像。
 2. 选择自定义镜像,单击导入镜像。
 3. 根据操作界面要求,先 开通 COS,再 创建 bucket 存储桶 ,上传镜像文件到 bucket 并 获取镜像文件 URL。
 4. 单击下一步。
 5. 按照实际情况,填写表单,单击开始导入。
导入失败
在控制台进行导入镜像操作后,会因为一些原因导致任务失败。在任务失败的情况下,可以根据以下内容进行排查。
失败原因排查
您可参考以下内容,对应错误信息进行问题排查。详细错误提示以及错误说明请参见 错误码。
InvalidUrl:COS 链接无效
出现报错 InvalidUrl,错误提示:导入镜像页面输入了错误的 COS 链接,可能原因如下:
 • 输入了不是 云平台对象存储 的镜像链接。
 • COS 的对象地址不具备公有读私有写权限。
 • COS 文件的访问权限为私有读,但是签名已失效。
 • 在境外地域导入镜像时,使用了非同地域的 COS 链接。
 • 用户的镜像文件已被删除。在收到 COS 链接无效的报错后,可根据上述原因排查问题。
InvalidFormatSize:格式或大小不符合条件
出现报错 InvalidFormatSize,错误提示:预导入镜像的格式或大小不符合云平台导入镜像功能的限制,限制如下:
 • 导入镜像支持 qcow2,vhd,vmdk,raw 4种格式的镜像文件。
 • 导入镜像的实际文件大小不得超过50GB(按转换为 qcow2 格式的镜像文件为准)。
 • 导入镜像的系统盘大小不得超过500GB。
在收到格式或大小不符合条件的报错后:
 • 可以根据 Linux 镜像制作 的镜像格式转换内容将镜像文件转换为合适的文件格式、精简镜像内容以满足大小限制后重新导入镜像。
VirtioNotInstall:未安装 Virtio 驱动
出现报错 VirtioNotInstall,错误提示:预导入镜像未安装 Virtio 驱动。云平台使用 KVM 虚拟化技术,要求用户导入的镜像内已安装 virtio 驱动。除了少部分用户定制的 Linux 操作系统外,大部分的 Linux 操作系统已经安装 Virtio 驱动;Windows 操作系统则需要用户手动安装 Virtio 驱动:
 • Linux 镜像导入,可以参考文档 Linux 系统检查 Virtio 驱动。
 • Windows 镜像导入,可以参考文档 Windows 镜像制作 安装 Virtio 驱动。
CloudInitNotInstalled:未安装 cloud-init 程序
出现报错 CloudInitNotInstalled,错误提示:预导入镜像未安装 cloud-init 程序。云平台使用开源程序 cloud-init 初始化子机,因此未安装 cloud-init 程序将导致用户子机初始化失败。
 • Linux 镜像导入,可以参考文档 Linux 系统安装 cloud-init。
 • 安装 cloud-init/cloudbase-init 后请根据文档替换配置文件已使得子机启动时从正确的数据源拉取数据。
PartitionNotPresent:分区信息丢失
出现报错 PartitionNotPresent,错误提示:导入的镜像不完整。请检查制作镜像时是否包含引导分区。
RootPartitionNotFound:根分区丢失
出现报错 RootPartitionNotFound,错误提示:未检测到导入的镜像包含根分区。请检测镜像文件,曾经出现过的原因如下,供参考:
 • 上传了安装包文件。
 • 上传了数据盘镜像。
 • 上传了引导分区镜像。
 • 上传了错误的文件。
InternalError:未知错误
出现报错 InternalError,错误提示:导入镜像服务没有收录该错误原因,请联系客服处理该类问题,技术人员将第一时间解决问题。
错误码

错误码 错误原因 建议处理方式
InvalidUrl COS 链接无效 检查 COS 链接与导入镜像链接是否相同
InvalidFormatSize 格式或大小不符合条件 镜像需要满足 导入准备 中关于镜像格式和镜像大小的限制
VirtioNotInstall 未安装 virtio 驱动 镜像需要安装 virtio 驱动,参考 导入准备 中的驱动部分
PartitionNotPresent 未找到分区信息 镜像损坏,可能是错误的镜像制作方式导致的
CloudInitNotInstalled cloud-init 未安装 Linux 镜像需要安装 cloud-init,参考 导入准备 中的驱动部分
RootPartitionNotFound 未检测到根分区 镜像损坏,可能是错误的镜像制作方式导致的
InternalError 其他错误