除了使用 创建自定义镜像 功能外,腾讯云同时支持使用导入功能。可将本地或其他平台的服务器系统盘镜像文件导入至云服务器(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 文件,即需用同地域 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 驱动下载地址如下,请对应实际网络环境进行下载: |
地域限制 | 境外地域导入镜像服务仅支持同地域 COS 文件,即需用同地域 COS 链接导入 |
其他 |
导入步骤
![](https://qcloudimg.tencent-cloud.cn/image/document/79719866442ac58dc8de3fa56f5b3cb6.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/79719866442ac58dc8de3fa56f5b3cb6.png)
2. 选择自定义镜像,单击导入镜像。
![](https://qcloudimg.tencent-cloud.cn/image/document/df8006d4e1b4adf5939280101b5393b2.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/df8006d4e1b4adf5939280101b5393b2.png)
3. 根据操作界面要求,先 开通 COS,再 创建 bucket 存储桶,上传对象 镜像文件到 bucket 并 获取镜像文件 URL。您可以直接在COS 控制台对应的 COS 文件详情页,复制临时链接用于镜像导入。
![](https://qcloudimg.tencent-cloud.cn/image/document/df5ab176720bcb1337dea7b31a085cf0.png)
![](https://qcloudimg.tencent-cloud.cn/image/document/df5ab176720bcb1337dea7b31a085cf0.png)
4. 单击下一步。
5. 按照实际情况,填写表单,单击开始导入。
注意:
请确保录入的对象存储文件 URL 准确。
导入失败
错误码 | 错误原因 | 建议处理方式 |
InvalidUrl | 输入的 COS 链接无效;可能原因: 输入了不是 腾讯云 COS 的镜像文件链接 COS 的对象地址不具备公有读私有写权限 COS 文件的访问权限为私有读,但是签名已失效 在境外地域导入镜像时,使用了非同地域的 COS 链接;境外地域导入镜像服务仅支持同地域 COS 服务器 当前 COS 文件已被删除 | 检查 COS 链接与导入镜像链接是否相同 |
InvalidFormatSize | 导入镜像的格式或大小不符合腾讯云导入镜像功能的限制 导入镜像支持 qcow2,vhd,vmdk,raw 4种格式的镜像文件 镜像系统盘大小不得超过1024GB,单块数据盘不得超过2048GiB(按转换为 qcow2 格式的镜像文件为准) | 可以根据 Linux 镜像制作 的镜像格式转换内容将镜像文件转换为合适的文件格式、精简镜像内容以满足大小限制后重新导入镜像 超出限制的文件,也可以使用 离线实例迁移 功能迁移镜像 |
VirtioNotInstall | 未安装 virtio 驱动: 腾讯云使用 KVM 虚拟化技术,要求用户导入的镜像内已安装 virtio 驱动。除了少部分用户定制的 Linux 操作系统外,大部分的 Linux 操作系统已经安装 Virtio 驱动;Windows 操作系统则需要用户手动安装 Virtio 驱动 | Linux 镜像导入,可以参见文档 Linux 系统检查 Virtio 驱动 Windows 镜像导入,可以参见文档 Windows 镜像制作安装 Virtio 驱动 |
CloudInitNotInstalled | cloud-init 未安装: 腾讯云使用开源程序 cloud-init 初始化子机,因此未安装 cloud-init 程序将导致用户子机初始化失败 | Linux 镜像导入,可以参见文档 Linux 系统安装 cloud-init Windows 镜像导入,可以参见文档 Windows 操作系统安装 cloudbase-init |
PartitionNotPresent | 未找到分区信息,导入的镜像不完整 | 镜像损坏,请检查制作镜像时是否包含引导分区,可能是错误的镜像制作方式导致的 |
RootPartitionNotFound | 未检测到导入的镜像包含根分区,可能的原因: 上传了安装包文件 上传了数据盘镜像 上传了引导分区镜像 上传了错误的文件 | 镜像损坏,可能是错误的镜像制作方式导致的 |
InternalError | 其他错误 |
检测结果说明及修复建议
导入镜像会自动对镜像可用性检测,您可以在控制台查看导入镜像检测结果,建议您根据检测结果完善镜像,以保证功能可用性。
Linux操作系统检测项及说明如下:
检测项 | 检测说明 | 检测结果 | 修复建议 |
Virtio | 镜像中 virtio 驱动是否安装 | Supported - 满足 KernelNotSupported - 内核不支持 BlkDriverNotFound - 磁盘驱动未找到 NetDriverNotFound - 网络驱动未找到 | 强烈建议修复: |
CloudInit | 镜像中是否安装 cloud-init | Supported - 满足 NotSupported - 不支持 | 强烈建议修复: |
CloudinitConfig | cloud-init配置是否正常 | Supported - 满足 Invalid - cloud.cfg内容无法加载 InvalidCloudFinalModules - cloud_final_modules配置项中没有scripts-user InvalidDatasourceList - datasource_list 中没有 ConfigDrive | 强烈建议修复: 1. 修改 cloud-init 配置文件:
根据不同操作系统,下载 cloud.cfg。 点此下载 Ubuntu 操作系统的 cloud.cfg。 点此下载 CentOS 操作系统的 cloud.cfg。 点此下载 OpenSUSE / SUSE 操作系统的 cloud.cfg 2. 将 /etc/cloud/cloud.cfg
的内容替换为已下载的 cloud.cfg 文件内容。 |
Fstab | 镜像中 /etc/fstab 文件配置了系统磁盘设备挂载信息,错误的配置会导致系统启动异常,例如配置的挂载设备信息不存在、设备 UUID 错误等 | Supported - 满足 DeviceNotFound - 配置中有设备不存在 DeviceConfig - 使用的是 /dev/vd* 的配置项 | 建议修复: 1. 若您的操作系统非FreeBSD,修复参见文档 配置 fstab 文件磁盘标识方式为 UUID。 2. 若您的操作系统是 FreeDSB。 添加 Label。
修改 /etc/fstab。
修改结果。
|
Grub | 镜像中 grub 引导文件是否正常。例如 device 设备配置异常、相关设备不存在、UUID 错误等,会导致系统启动异常 镜像为 FreeBSD 时不做此项检查 | Supported - 满足 NotSupported - 不是采用的 UUID 的方式配置的 | 建议修复: |
Selinux | 镜像是否关闭 SELinux。云上镜像不建议开启 SELinux,有可能会导致系统启动异常 镜像为 FreeBSD 时不做此项检查 | Supported - 满足 ConfigNotFound - 启用情况下 /etc/selinux/config 不存在 Enforcing - 开启了最高级别 | 建议修复: 修复参考
修改成
|
OnlineResizeFS | 镜像是否支持根分区自动扩容。镜像中安装有 cloud-init、growpart(gpart, parted, growpart) 命令等,使用镜像创建实例后,根分区会自动扩容。例如您的镜像空间大小是20 GB,创建实例时系统盘大小为100 GB,则实例创建后,根分区会自动扩容至100 GB | Supported - 满足 NotSupported - 不支持 | 建议修复: 当操作系统为 CentOS 6, CentOS 7, TencentOS Server 2版本。
当操作系统为 CentOS 8, CentOS Stream, Rocky Linux, TencentOS Server 3版本。
当操作系统为 Ubuntu。
|
Network | 镜像中网络配置是否符合 cloud-init 标准 此项只对操作系统 Debian 和 Ubuntu 进行检查 | Supported - 满足 Unsupported - 不支持 | 建议修复: /etc/network/interfaces 中必须包含source /etc/network/interfaces.d/* |
SupportBareMachine | 镜像是否支持裸金属 | Supported - 满足 Unsupported - 不支持 | 可选修复: |
TimeSync | 是否安装有 NTP,保持时间同步 | Supported - 满足 Unsupported - 不支持 | 可选修复: 当操作系统为 CentOS 6, CentOS 7, TencentOS Server 2版本。
当操作系统为 CentOS 8, CentOS Stream, Rocky Linux, TencentOS Server 3版本。
当操作系统为 Ubuntu。
|
Windows操作系统检测项及说明如下:
检测项 | 检测说明 | 检测结果 | 修复建议 |
Virtio | 镜像中 virtio 驱动是否安装 | Supported - 满足 BlkDriverNotFound - 磁盘驱动未找到 | 强烈建议修复: |
Cloudbase | 镜像中是否安装 cloudbase | Supported - 满足 NotSupported - 不支持 | 强烈建议修复: |
CloudbaseConfig | cloudbase 配置是否正常 | Supported - 满足 NotSupported - 不支持 | |
SupportBareMachine | 镜像是否支持裸金属 | Supported - 满足 NotSupported - 不支持 | 可选修复: 自助驱动下载地址: 下载下来的文件是 zip 文件,解压之后,右键bnxtnd.inf 文件,选安装。 |