私有镜像导入

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

前提条件及限制

• 当前仅支持导入系统盘镜像；
  
• 导入后的镜像将以“云硬盘系统盘镜像”格式作为私有镜像使用，同时会自动生成一个与导入镜像关联的快照；
  
• “云硬盘系统盘”镜像可用来创建系统盘是云硬盘的主机，无法将镜像转换为“本地盘系统盘”镜像。关于“本地盘系统盘”镜像和“云硬盘系统盘”镜像的区别请参见 镜像类型。

特殊说明：

• 导入镜像在使用方式上与通过“制作镜像”创建的私有镜像无异，但某些功能（诸如设置密码密钥、主机监控等）由于依赖镜像中的官方组件，因此建议您在导入后手动进行安装。关于官方组件的介绍请参见 官方镜像系统组件；
  
• 若导入镜像需支持网卡都队列，还请查阅网卡多队列确认镜像操作系统和版本是否支持，并正确配置，导入镜像成功后须 提交工单申请使用网卡多队列功能；
  
• 导入成功后，如需配置京东智联云内网yum源或ntp服务，可参考 Linux系统配置yum源和ntpd服务。

镜像基本要求

Linux系统基本要求

Windows系统基本要求

操作步骤

1、镜像准备

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

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

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

2、镜像文件生成

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

无法直接导入iso格式的镜像，如您当前镜像为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

导入接口参数说明如下：

查看及测试镜像

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

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

• OpenAPI文档见：查询镜像任务
  
• CLI安装和配置见：CLI安装 CLI配置
  
  • CLI指令示意：

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

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

相关参考

官方镜像系统组件

镜像类型

virtio安装

镜像自检工具

转换镜像格式

ISO格式镜像转换

镜像导入OpenAPI

镜像任务查询OpenAPI

CLI安装

CLI配置

Linux系统配置yum源和ntpd服务