产品文档



云主机



帮助中心 > 产品文档 > 云主机 > 导入私有镜像



私有镜像导入

功能概述

私有镜像导入是指，将您在本地或其他云环境下所用服务器的系统盘以镜像的形式保存并导入到京东智联云环境，以便快速实现京东智联云上的业务部署。

导入镜像使用说明：

导入镜像当前仅支持导入系统盘镜像；
导入镜像在使用方式上与通过“制作镜像”创建的私有镜像无异，但某些功能（诸如设置密码密钥、主机安全监控等）由于依赖镜像中的官方组件，因此是否支持取决于您在导入镜像之前是否进行了对应组件的安装。关于官方组件的介绍请参见官方镜像系统组件；
导入后的镜像将以“云硬盘系统盘镜像”格式作为私有镜像使用，同时会自动生成一个与导入镜像关联的快照；
“云硬盘系统盘”镜像可用来创建系统盘是云硬盘的主机，无法将镜像转换为“本地盘系统盘”镜像。关于“本地盘系统盘”镜像和“云硬盘系统盘”镜像的区别请参见镜像类型。
若导入镜像需支持网卡都队列，还请查阅网卡多队列确认镜像操作系统和版本是否支持，并正确配置，导入镜像成功后须提交工单申请使用网卡多队列功能。

镜像基本要求

Linux系统基本要求

镜像属性	要求
操作系统	* 支持CentOS、Ubuntu、Debian、SUSE Linux Enterprise、OpenSUSE * 支持64位
镜像格式	* 支持RAW、VHD、QCOW2、VMDK
镜像大小	* 实际大小（disk size）和虚拟大小（virtual size）均不超过500G
文件系统	* xfs、ext3、ext4
分区	* MBR分区
虚拟化驱动	* 仅支持KVM虚拟化，需要安装virtio驱动
启动方式	* 仅支持BIOS，暂不支持UEFI方式
网络	* 暂不支持Ipv6地址
系统基本环境	* 关闭防火墙，放行TCP 22端口 * 开启DHCP服务 * 确保系统盘有剩余空间 * 确保文件系统完整
系统配置	* /etc/fstab 如有配置自动挂载，请删除 * /etc/udev/rules.d如有70-persistent-net.rules配置，请删除 * 请勿修改 /etc/shadow为只读 * 请勿修改 /etc/selinux/config 开启 SELinux * 请勿修改/etc/grub/grub.cfg * 请勿修改 /boot/grub/menu.lst
系统组件	* 安装JCS-agent
冲突组件	* 确保卸载qemu-ga * 确保卸载cloud-init

Windows系统基本要求

镜像属性	要求
操作系统	* 支持Windows Server 2016、2012 R2、2008 R2 * 支持64位
镜像格式	* 支持RAW、VHD、QCOW2、VMDK
镜像大小	* 实际大小（disk size）和虚拟大小（virtual size）均不超过500G
文件系统	* NTFS
分区	* MBR分区
虚拟化驱动	* 仅支持KVM虚拟化，需要安装virtio驱动
启动方式	* 仅支持BIOS，暂不支持UEFI方式
网络	* 暂不支持Ipv6地址
系统基本环境	* 关闭防火墙，放行RDP 3389端口 * 确保系统盘有剩余空间 * 确保文件系统完整
系统配置	* 请勿修改关键系统文件
系统组件	* 安装JCS-agent
冲突组件	* 确保卸载qemu-ga * 确保卸载cloudbase-init

导入步骤

1、镜像准备

为保证导入镜像的可用性，请务必在导入前参照上述京东智联云镜像制作要求进行镜像配置检测，尤其是启动方式、分区及 virtio安装等影响启动的关键配置，确认导入镜像符合京东智联云规范后再行操作导入。

同时为了保证导入镜像在京东智联云环境下可以获得修改密码、上报监控数据、安全扫描检测等功能，建议您在导出镜像之前进行重要系统组件的安装。系统组件功能及安装方法请参见：官方镜像系统组件

Linux镜像可使用我们提供的镜像自检工具完成重要系统配置的自检，使用方法请参见：镜像自检工具

2、镜像文件生成

支持RAW、VHD、QCOW2、VMDK四种格式的镜像文件导入，请在生成镜像文件时指定正确的文件格式。

不支持iso镜像格式，请通过使用VirtualBox、virt-manager 等工具制作成指定格式的镜像再行导入。操作指导请参见：转换镜像格式、 ISO格式镜像转换

3、上传镜像文件

操作导入镜像之前，需要确保已开通对象存储服务、创建存储空间（Bucket），然后将镜像文件上传至与期望导入镜像相同地域的存储空间中，并获取文件内网下载链接（将下载地址域名中的"s3"改成"s3-internal"即可）。

如果存储空间访问权限为“公有读写”或者“公有读私有写”，可直接点击“复制”图标获取外链。

如果存储空间访问权限为“私有读写”或者“自定义权限”，在获取外链时需要指定链接有效期，由于导入镜像耗时与文件大小和系统处理队列中的任务数量有关，为保证导入过程顺利，建议您设置不少于1天的有效时间。

4、导入镜像

完成以上几步操作后，可通过控制台/CLI或SDK完成镜像导入。（目前导入镜像控制台操作入口为灰度开放，如需使用请提交工单申请）

OpenAPI接口见：镜像导入
CLI安装和配置见：CLI安装 CLI配置
CLI指令示意：

jdc vm import-image --architecture x86_64 --os-type linux --platform "Other Linux" --disk-format qcow2 --system-disk-size-gb 50 --image-url https://XXXX.s3-internal.cn-north-1.jdcloud-oss.com/XXXX.qcow2 --image-name importImageTest

导入接口参数说明如下：

参数	类型	是否必填	说明
architecture	string	是	操作系统架构，支持 “x86_64” 和 “i386”
osType	string	是	镜像操作系统分类，请根据实际情况填写“linux”或“windows”
platform	string	是	镜像操作系统发行版本，如版本为“CentOS”、“Ubuntu”、“Windows Server”中的一种请如实填写，否则请根据osType，对应填写“Other Linux”或“Other Windows”
osVersion	string	否	具体的操作系统发行版本号，如7.4（CentOS）、18.04（Ubuntu），仅用于标识以作区分，可根据需要填写
diskFormat	string	是	镜像文件格式，支持“vhd”、“vmdk”、“qcow2”、“raw”，请如实填写，否则校验阶段会报错影响导入
systemDiskSizeGB	int	是	指定使用镜像创建系统盘的容量，范围[40,500]，请确保该参数不小于镜像的virtual size，否则校验阶段会报错影响导入
imageUrl	string	是	和导入镜像同地区的镜像文件内网下载地址（OSS object外链地址，并将域名中的"s3"改成"s3-internal"后填写），如文件所属地域与接口region不一致或填写外网下载地址，会影响导入
imageName	string	是	自定义的镜像名称
description	string	否	自定义的镜像描述
forceImport	boolean	否	是否不做镜像检测强制导入镜像，为避免导入后镜像不可用建议保持默认默认值。默认值：false
clientToken	string	否	用于保证请求的幂等性。由客户端生成，长度不能超过64个字符

查看及测试镜像

成功提交导入镜像请求后，即可在控制台私有镜像列表页/详情页中通过“状态”属性中的百分比了解具体进度。

由于华北-北京地域的云硬盘做系统盘功能处于灰度开放期间，如您无法在私有镜像列表中查看到导入成功的云盘系统盘镜像，请提交工单申请权限。

如果查询时发现镜像长时间处于“创建中 0%“，可能是由于导入镜像请求过多，您的请求整处于排队状态，此时可通过openAPI调用镜像导入任务查询接口来获知更详细的任务进展。

OpenAPI文档见：查询镜像任务
CLI指令示意：

jdc vm image-tasks --region-id cn-north-1 --task-action ImportImage --input-json '{"taskIds":[xxx]}'

镜像导入完成后，请使用镜像创建云主机测试是否可以成功创建，以及基本功能是否正常，如有异常可核对是否符合镜像制作基本要求，若仍无法解决请提交工单或联系客服获得技术支持。

导入成功后，如需配置京东智联云内网yum源或ntp服务，可参考 Linux系统配置yum源和ntpd服务。

云主机

产品文档

弹性计算

网络

云数据库与缓存

存储

CDN

域名与备案

云安全

大数据与分析

管理

人工智能

智能IDC

京东云市场

VR 云服务

视频服务

互联网中间件

区块链

开发者工具

解决方案

混合云

物联网

智能城市 AI

财务相关

用户服务

服务协议与保障

云通信

专有云

云主机