tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
云服务器
    文档
    Download PDF

    导入镜像概述

    最后更新时间：2024-10-25 15:37:01
    下载PDF
      除了使用 创建自定义镜像 功能外，腾讯云同时支持使用导入功能。可将本地或其他平台的服务器系统盘镜像文件导入至云服务器（Cloud Virtual Machine，CVM）自定义镜像中。导入后可以使用该导入镜像创建云服务器或对已有云服务器重装系统。

      导入准备

      您需提前准备好符合导入限制的镜像文件。
      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。
      4. 单击下一步。
      5. 按照实际情况，填写表单，单击开始导入。
      参数名称
      必填
      说明
      地域
      是
      确定您导入的自定义镜像所在地域，请与您需要创建实例的地域保持一致，本地域的自定义镜像不可直接用于其他地域创建实例；若其他地域需要使用当前镜像，可以使用 复制镜像 跨地域复制您的自定义镜像
      系统盘文件
      是
      系统盘文件包含了服务器操作系统的内核、库文件、驱动程序等核心组件，通过系统盘文件，服务器能够启动并运行操作系统，从而提供基础的服务和功能。
      
      导入方式
      从COS列表存储选择：
      在下拉列表选择文件所在COS桶，再选择对应的镜像文件，系统自动获取镜像文件URL；请注意，当前方法仅支持选择本地域下的COS文件；
      直接输入COS对象地址：
      前往 对象存储控制台 找到镜像文件所在的存储桶列表，并逐级搜索镜像文件，在镜像文件详情页面，您可以直接点击 临时链接-复制临时链接，即可获取镜像文件 URL；
      操作系统
      是
      1、选择 Linux 或 Windows 操作系统
      请与镜像文件的操作系统类型保持一致
      2、系统平台
      用于标识导入镜像文件的操作系统平台；请与镜像文件的操作系统平台保持一致
      Linux 操作系统：支持选择 CentOS、CentOS Stream、Ubuntu、Debian、RedHat 等常用系统平台，若导入的系统平台不在列表中，请选择 Other Linux
      Windows 操作系统：支持选择 Windows Server 2022 、Windows Server 2019 等常用系统，若导入的系统平台不在列表中，请选择 Other Windows
      3、系统版本
      用于标识导入镜像文件的 Linux 操作系统版本，例如 CentOS 支持选择8、7、6、5多个版本；请与镜像文件的操作系统版本保持一致
      4、系统架构
      支持32位、64位和 arm_64位；请与镜像文件的操作系统架构保持一致
      数据盘文件
      （功能公测中，您可以联系客服体验）
      否
      数据盘文件用于存储用户数据文件，例如应用程序数据、用户文档、数据库文件等；若您的镜像有数据盘文件，可以通过勾选添加数据盘来输入。
      导入方式：
      从COS列表存储选择：
      在下拉列表选择文件所在COS桶，再选择对应的镜像文件，系统自动获取镜像文件URL；请注意，当前方法仅支持选择本地域下的COS文件；
      直接输入COS对象地址：
      前往 对象存储控制台 找到镜像文件所在的存储桶列表，并逐级搜索镜像文件，在镜像文件详情页面，您可以直接点击 临时链接-复制临时链接，即可获取镜像文件 URL；
      镜像名称
      是
      导入镜像文件后显示的镜像名称。请注意，镜像名称只支持中文、字母、数字或连接符号"-_."，且最多60个字符
      镜像描述
      否
      增加镜像说明，便于后需管理
      标签
      否
      设置标签，便于搜索和管理
      更多配置
      参数名称
      必填
      说明
      导入方式
      否
      如果您的镜像无法正常导入，您可以选择使用启用强制导入选项。这种方式仅对文件的完整性进行检查，而不会因驱动或配置问题而阻止导入过程。详情见 强制导入镜像。
      启动模式
      是
      请您确认当前选择的启动模式与镜像文件的启动模式一致，否则使用该镜像会影响您实例的正常启动； 启动模式 Legacy BIOS/UEFI 最佳实践。
      导入成功或失败，均会以 站内信 的形式通知。

      导入失败

      在控制台进行导入镜像操作后，会因为一些原因导致任务失败。在任务失败的情况下，您可以在 控制台 或者 站内信 查看错误码，并根据以下内容进行排查。
      错误码
      错误原因
      建议处理方式
      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 文件，选安装。
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款