操作指南

最佳实践

故障处理

API 文档

参与文档共建赢好礼> HOT

导入镜像概述

最近更新时间:2022-02-25 13:13:03

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

导入准备

您需提前准备好符合导入限制的镜像文件。

镜像属性条件
操作系统
  • 基于 CentOS、Ubuntu、Debian、CoreOS、openSUSE、SUSE 发行版的镜像
  • 支持32位和64位
镜像格式
  • 支持 RAW、VHD、QCOW2、VMDK 镜像格式
  • 使用qemu-img info imageName | grep 'file format'查看镜像格式
文件系统类型不支持 GPT 分区
镜像大小
  • 镜像实际大小不超过50G,使用qemu-img info imageName | grep 'disk size'查看镜像实际大小
  • 镜像 vsize 不超过500G,使用qemu-img info imageName | grep 'virtual size'查看镜像 vsize
注意:导入镜像时审查大小以转换为 QCOW2 格式后的镜像信息为准
网络
  • 腾讯云默认为实例提供 eth0 网络接口
  • 用户可以在实例内通过 metadata 服务查询实例的网络配置,详见 实例元数据
驱动
内核限制镜像最好是原生内核,修改可能会导致云服务器无法导入
地域限制目前上海金融区、深圳金融区不支持从其他地域的对象存储 COS 服务导入镜像。

导入步骤

  1. 登录云服务器控制台,单击左侧导航栏中的 镜像
  2. 选择自定义镜像,单击导入镜像
  3. 根据操作界面要求,先 开通 COS,再 创建 bucket 存储桶 ,上传镜像文件到 bucket 并 获取镜像文件 URL
  4. 单击下一步
  5. 按照实际情况,填写表单,单击开始导入
    注意

    请确保录入的对象存储文件 URL 准确。

    导入成功或失败,均会以 站内信 的形式通知。

导入失败

在控制台进行导入镜像操作后,会因为一些原因导致任务失败。在任务失败的情况下,可以根据以下内容进行排查。

注意事项

在根据本文排查失败原因之前,请确保已经在 站内信管理页面 消息订阅栏中订阅产品服务相关通知,以保证可以接收到包含失败原因的站内信、短信和邮件。

注意

未在消息中心订阅产品服务相关信息,将无法接受到导入成功/失败的站内信。

失败原因排查

您可参考以下内容,对应错误信息进行问题排查。详细错误提示以及错误说明请参见 错误码

InvalidUrl:COS 链接无效

展开&收起

出现报错 InvalidUrl,错误提示:导入镜像页面输入了错误的 COS 链接,可能原因如下:

  • 输入了不是 腾讯云对象存储 的镜像链接。
  • COS 的对象地址不具备公有读私有写权限。
  • COS 文件的访问权限为私有读,但是签名已失效。
    注意

    带有签名的 COS 文件链接仅能被访问一次。

  • 在境外地域导入镜像时,使用了非同地域的 COS 链接。
    注意

    目前境外地域导入镜像服务仅支持同地域 COS 服务器,即需用同地域 COS 链接导入。

  • 用户的镜像文件已被删除。
    在收到 COS 链接无效的报错后,可根据上述原因排查问题。

InvalidFormatSize:格式或大小不符合条件

展开&收起

出现报错 InvalidFormatSize,错误提示:预导入镜像的格式或大小不符合腾讯云导入镜像功能的限制,限制如下:

  • 导入镜像支持 qcow2vhdvmdkraw 4种格式的镜像文件。
  • 导入镜像的实际文件大小不得超过50GB(按转换为 qcow2 格式的镜像文件为准)。
  • 导入镜像的系统盘大小不得超过500GB。

在收到格式或大小不符合条件的报错后:

  • 可以根据 Linux 镜像制作 的镜像格式转换内容将镜像文件转换为合适的文件格式、精简镜像内容以满足大小限制后重新导入镜像。
  • 也可以使用 离线实例迁移 功能迁移实例,该功能最大支持500GB的镜像文件迁移。

VirtioNotInstall:未安装 Virtio 驱动

展开&收起

出现报错 VirtioNotInstall,错误提示:预导入镜像未安装 Virtio 驱动。腾讯云使用 KVM 虚拟化技术,要求用户导入的镜像内已安装 virtio 驱动。除了少部分用户定制的 Linux 操作系统外,大部分的 Linux 操作系统已经安装 Virtio 驱动;Windows 操作系统则需要用户手动安装 Virtio 驱动:

CloudInitNotInstalled:未安装 cloud-init 程序

展开&收起

出现报错 CloudInitNotInstalled,错误提示:预导入镜像未安装 cloud-init 程序。腾讯云使用开源程序 cloud-init 初始化子机,因此未安装 cloud-init 程序将导致用户子机初始化失败。

PartitionNotPresent:分区信息丢失

展开&收起

出现报错 PartitionNotPresent,错误提示:导入的镜像不完整。请检查制作镜像时是否包含引导分区。

RootPartitionNotFound:根分区丢失

展开&收起

出现报错 RootPartitionNotFound,错误提示:未检测到导入的镜像包含根分区。请检测镜像文件,曾经出现过的原因如下,供参考:

  • 上传了安装包文件。
  • 上传了数据盘镜像。
  • 上传了引导分区镜像。
  • 上传了错误的文件。

InternalError:未知错误

展开&收起

出现报错 InternalError,错误提示:导入镜像服务没有收录该错误原因,请联系客服处理该类问题,技术人员将第一时间解决问题。

错误码

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