除了使用 创建自定义镜像 功能外,腾讯云同时支持使用导入功能。可将本地或其他平台的服务器系统盘镜像文件导入至云服务器(Cloud Virtual Machine,CVM)自定义镜像中。导入后可以使用该导入镜像创建云服务器或对已有云服务器重装系统。
说明
由于镜像底层使用了云硬盘快照服务:
国内地域提供80 GB 的免费额度,详情请参见 赠送额度。
在创建自定义镜像时会默认创建关联该镜像的快照,且保留自定义镜像会产生一定的快照费用,详情请参见 快照计费概述。
若您的腾讯云账户进入欠费状态,为避免您的数据丢失,我们将保留您的自定义镜像及关联的快照,且不会产生新的费用。
导入准备
您需提前准备好符合导入限制的镜像文件。
镜像属性 | 条件 |
操作系统 | 基于 CentOS、CentOS Stream、Ubuntu、Debian、RedHat、OpenSUSE、CoreOS、FreeBSD、Kylin、UnionTech、TencentOS、Fedora、AlmaLinux、Rocky Linux、OpenCloudOS、Other Linux 发行版的镜像 支持32位、64位和 arm_64位 |
镜像格式 | 支持 RAW、VHD、QCOW2、VMDK 镜像格式 使用 qemu-img info imageName | grep 'file format' 查看镜像格式 |
文件系统及分区 | 支持 xfs、ext3 和 ext4 文件系统,支持 MBR 和 GPT 分区 说明: 支持 ext4 文件系统,但不能包含特性 64bit ,并且特性project 和quota 不能成对出现。您可以运行以下命令查看 ext4 文件系统中包含的特性列表。
不支持调整系统盘分区,只支持单个根分区 不支持通过 LVM 来构建系统盘分区(根分区),否则可能导致实例启动、修改密码、使用密码 SSH 登录等问题 系统所在磁盘的根分区之后不能再存在其他分区,否则将导致实例启动失败或者磁盘扩容失败 |
镜像大小 | 镜像实际大小不超过1024G,使用 qemu-img info imageName | grep 'disk size' 查看镜像实际大小镜像 vsize 不超过1024G,使用 qemu-img info imageName | grep 'virtual size' 查看镜像 vsize注意:导入镜像时审查大小以转换为 QCOW2 格式后的镜像信息为准 |
网络 | 腾讯云默认为实例提供 eth0 网络接口 用户可以在实例内通过 metadata 服务查询实例的网络配置,详见 实例元数据 |
驱动 | 镜像必须安装虚拟化平台 KVM 的 Virtio 驱动,详情参见 Linux 导入镜像检查 Virtio 驱动 镜像需安装 cloudinit,详情参见 Linux 导入镜像安装 cloudinit 如因其它原因,镜像无法安装 cloudinit,请根据 强制导入镜像 自行配置实例 |
文件系统 | 为了确保 Linux 系统在启动文件系统时能够正确识别磁盘,请您检查并正确配置 GRUB 文件磁盘标识方式。详情参见 配置 GRUB 文件磁盘标识方式为 UUID。 为了确保 Linux 系统在挂载文件系统时能够正确识别磁盘,请您检查并正确配置 fstab 文件磁盘标识方式。详情参见 配置 fstab 文件磁盘标识方式为 UUID。 |
内核限制 | 镜像最好是原生内核,修改可能会导致云服务器无法导入 |
地域限制 | 目前上海金融区、深圳金融区不支持从其他地域的对象存储 COS 服务导入镜像。 |
镜像属性 | 条件 |
操作系统 | Windows Server 2022 、Windows Server 2019 、Windows Server 2016 、Windows Server 2012 、Windows Server 2008 、Other Windows相关版本 支持32位、64位和 arm_64位 |
镜像格式 | 支持 RAW、VHD、QCOW2、VMDK 镜像格式 使用 qemu-img info imageName | grep 'file format' 查看镜像格式 |
文件系统及分区 | 支持 NTFS 文件系统,支持 MBR 和 GPT 分区 支持在系统盘上创建多个分区 请确保系统所在磁盘的启动分区(C盘)之后不再存在其他分区,否则可能导致实例启动失败或磁盘扩容失败 |
镜像大小 | 镜像实际大小不超过1024G,使用 qemu-img info imageName | grep 'disk size' 查看镜像实际大小镜像 vsize 不超过1024G,使用 qemu-img info imageName | grep 'virtual size' 查看镜像 vsize注意:导入镜像时审查大小以转换为 qcow2 格式后的镜像信息为准 |
网络 | 腾讯云默认为实例提供本地连接网络接口 用户可以在实例内通过 metadata 服务查询实例的网络配置,详见 实例元数据 |
驱动 | 镜像必须安装虚拟化平台 KVM 的 Virtio 驱动。Windows系统默认未安装 Virtio 驱动,用户可安装 Windows Virtio 驱动后导出本地镜像。Windows Virtio 驱动下载地址如下,请对应实际网络环境进行下载: 公网下载地址:http://mirrors.tencent.com/install/windows/virtio_64_1.0.9.exe 内网下载地址:http://mirrors.tencentyun.com/install/windows/virtio_64_1.0.9.exe |
地域限制 | 目前上海金融区、深圳金融区不支持从其他地域的 COS 服务导入镜像。 |
其他 |
导入步骤
2. 选择自定义镜像,单击导入镜像。
3. 根据操作界面要求,先开通 COS,再创建 bucket 存储桶,上传对象镜像文件到 bucket 并获取镜像文件 URL。
4. 单击下一步。
5. 按照实际情况,填写表单,单击开始导入。
注意:
请确保录入的对象存储文件 URL 准确。
导入失败
在控制台进行导入镜像操作后,会因为一些原因导致任务失败。在任务失败的情况下,可以根据以下内容进行排查。
注意事项
注意:
未在消息中心订阅产品服务相关信息,将无法接收到导入成功/失败的站内信。
失败原因排查
InvalidUrl:COS 链接无效
出现报错 InvalidUrl,错误提示:导入镜像页面输入了错误的 COS 链接,可能原因如下:
输入了不是 腾讯云对象存储 的镜像链接。
COS 的对象地址不具备公有读私有写权限。
COS 文件的访问权限为私有读,但是签名已失效。
注意:
带有签名的 COS 文件链接仅能被访问一次。
在境外地域导入镜像时,使用了非同地域的 COS 链接。
注意:
目前境外地域导入镜像服务仅支持同地域 COS 服务器,即需用同地域 COS 链接导入。
用户的镜像文件已被删除。
在收到 COS 链接无效的报错后,可根据上述原因排查问题。
InvalidFormatSize:格式或大小不符合条件
出现报错 InvalidFormatSize,错误提示:预导入镜像的格式或大小不符合腾讯云导入镜像功能的限制,限制如下:
导入镜像支持
qcow2
,vhd
,vmdk
,raw 4种格式的镜像文件。导入镜像的实际文件大小不得超过50GB(按转换为 qcow2 格式的镜像文件为准)。
导入镜像的系统盘大小不得超过500GB。
在收到格式或大小不符合条件的报错后:
可以根据 Linux 镜像制作 的镜像格式转换内容将镜像文件转换为合适的文件格式、精简镜像内容以满足大小限制后重新导入镜像。
也可以使用 离线实例迁移 功能迁移实例,该功能最大支持500GB的镜像文件迁移。
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。
Windows 镜像导入,可以参见文档 Windows 操作系统安装 cloudbase-init。
安装 cloud-init/cloudbase-init 后请根据文档替换配置文件使得子机启动时从正确的数据源拉取数据。
PartitionNotPresent:未找到分区信息
出现报错 PartitionNotPresent,错误提示:导入的镜像不完整。请检查制作镜像时是否包含引导分区。
RootPartitionNotFound:未检测到根分区
出现报错 RootPartitionNotFound,错误提示:未检测到导入的镜像包含根分区。请检测镜像文件,曾经出现过的原因如下,供参考:
上传了安装包文件。
上传了数据盘镜像。
上传了引导分区镜像。
上传了错误的文件。
InternalError:其他错误
出现报错 InternalError,错误提示:导入镜像服务没有收录该错误原因,请联系客服处理该类问题,技术人员将第一时间解决问题。
错误码
错误码 | 错误原因 | 建议处理方式 |
InvalidUrl | COS 链接无效 | 检查 COS 链接与导入镜像链接是否相同。 |
InvalidFormatSize | 格式或大小不符合条件 | |
VirtioNotInstall | 未安装 virtio 驱动 | |
CloudInitNotInstalled | cloud-init 未安装 | |
PartitionNotPresent | 未找到分区信息 | 镜像损坏,可能是错误的镜像制作方式导致的。 |
RootPartitionNotFound | 未检测到根分区 | 镜像损坏,可能是错误的镜像制作方式导致的。 |
InternalError | 其他错误 |