云服务器
有奖：语音产品征文挑战赛等你来> HOT
文档中心 > 云服务器 > 操作指南 > 镜像 > 导入镜像 > 导入镜像概述

导入镜像概述

最近更新时间：2024-06-06 10:50:41

我的收藏

本页目录：

除了使用 创建自定义镜像 功能外，腾讯云同时支持使用导入功能。可将本地或其他平台的服务器系统盘镜像文件导入至云服务器（Cloud Virtual Machine，CVM）自定义镜像中。导入后可以使用该导入镜像创建云服务器或对已有云服务器重装系统。
说明：
由于镜像底层使用了云硬盘快照服务：
国内地域提供80 GB 的免费额度，详情请参见 赠送额度。
在创建自定义镜像时会默认创建关联该镜像的快照，且保留自定义镜像会产生一定的快照费用，详情请参见 快照计费概述。
若您的腾讯云账户进入欠费状态，为避免您的数据丢失，我们将保留您的自定义镜像及关联的快照，且不会产生新的费用。

导入准备

您需提前准备好符合导入限制的镜像文件。
Linux 系统类型镜像限制
Windows 系统类型镜像限制
镜像属性
条件
操作系统
基于 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 文件系统中包含的特性列表。
tune2fs -l <ext4文件系统盘所在路径> | grep features
不建议系统盘有多个分区，建议只有单个根分区，如果有多个分区时，系统所在分区之后不建议再存在其他分区，否则将导致磁盘扩容失败
不建议通过 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 驱动下载地址如下，请对应实际网络环境进行下载：
公网下载地址：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 文件，即需用同地域 COS 链接导入
其他
导入的 Windows 系统镜像不提供 Windows 激活 服务

导入步骤

1. 登录云服务器控制台，单击左侧导航栏中的镜像。
?
?
?
2. 选择自定义镜像，单击导入镜像。
?
?
?
3. 根据操作界面要求，先 开通 COS，再 创建 bucket 存储桶，上传对象 镜像文件到 bucket 并 获取镜像文件 URL。您可以直接在COS 控制台对应的 COS 文件详情页，复制临时链接用于镜像导入。
?
?
?
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 - 网络驱动未找到
强烈建议修复：
修复请参见文档 Linux 系统检查 Virtio 驱动?
CloudInit
镜像中是否安装 cloud-init
Supported - 满足
NotSupported - 不支持
强烈建议修复：
修复请参见文档 Linux 系统安装 cloud-init
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。
# 设置Label
tunefs -L root /dev/da3
# 查看结果
ls /dev/ufs/root
修改 /etc/fstab。
# 备份文件
cp /etc/fstab /etc/fstab.bak
# 修改
vim /etc/fstab
修改结果。
/dev/ufs/home      /            ufs     rw              2      2
Grub
镜像中 grub 引导文件是否正常。例如 device 设备配置异常、相关设备不存在、UUID 错误等，会导致系统启动异常
镜像为 FreeBSD 时不做此项检查
Supported - 满足
NotSupported - 不是采用的 UUID 的方式配置的
建议修复：
Selinux
镜像是否关闭 SELinux。云上镜像不建议开启 SELinux，有可能会导致系统启动异常
镜像为 FreeBSD 时不做此项检查
Supported - 满足
ConfigNotFound - 启用情况下 /etc/selinux/config 不存在
Enforcing - 开启了最高级别
建议修复：
修复参考
# 切换到root用户
vim /etc/selinux/config
修改成
# This file controls the state of SELinux on the system.
# SELINUX= can take one of these three values:
#       enforcing - SELinux security policy is enforced.
#       permissive - SELinux prints warnings instead of enforcing.
#       disabled - No SELinux policy is loaded.
SELINUX=permissive
# SELINUXTYPE= can take one of these two values:
#       targeted - Targeted processes are protected,
#       mls - Multi Level Security protection.
SELINUXTYPE=targeted
?
OnlineResizeFS
镜像是否支持根分区自动扩容。镜像中安装有 cloud-init、growpart(gpart, parted, growpart) 命令等，使用镜像创建实例后，根分区会自动扩容。例如您的镜像空间大小是20 GB，创建实例时系统盘大小为100 GB，则实例创建后，根分区会自动扩容至100 GB
Supported - 满足
NotSupported - 不支持
建议修复：
当操作系统为 CentOS 6, CentOS 7, TencentOS Server 2版本。
# root用户
yum install cloud-utils-growpart
当操作系统为 CentOS 8, CentOS Stream, Rocky Linux, TencentOS Server 3版本。
# root用户
dnf -y install cloud-utils-growpart
当操作系统为 Ubuntu。
# root用户
apt-get install cloud-guest-utils
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版本。
# root用户
yum install ntpd
当操作系统为 CentOS 8, CentOS Stream, Rocky Linux, TencentOS Server 3版本。
# root用户
dnf install chrony
当操作系统为 Ubuntu。
# root用户
apt-get install ntp

Windows操作系统检测项及说明如下：

检测项
检测说明
检测结果
修复建议
Virtio
镜像中 virtio 驱动是否安装
Supported - 满足
BlkDriverNotFound - 磁盘驱动未找到
强烈建议修复：
修复请参见文档 制作 Windows 镜像 中「检查或安装 Virtio 驱动」部分的指引。
Cloudbase
镜像中是否安装 cloudbase
Supported - 满足
NotSupported - 不支持
强烈建议修复：
CloudbaseConfig
cloudbase 配置是否正常
Supported - 满足
NotSupported - 不支持
强烈建议修复： 修复请参见文档 修改 cloudbase-init 配置文件。
SupportBareMachine
镜像是否支持裸金属
Supported - 满足
NotSupported - 不支持
可选修复：
若您不使用裸金属实例，则无需关注；如镜像不满足裸金属实例要求，您可以联系客服协助。
自助驱动下载地址：
?Windows Server 2016?
?Windows Server 2019?
下载下来的文件是 zip 文件，解压之后，右键bnxtnd.inf 文件，选安装。
?
中国站
http://www.vxiaotou.com