私有镜像导入

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

前提条件及限制

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

特殊说明：

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

导入接口参数说明如下：

查看及测试镜像

成功提交导入镜像请求后，即可在控制台私有镜像列表页/详情页中通过“状态”属性中的百分比了解具体进度；也可通过镜像任务管理控制台来获知更详细的任务进展和关联资源信息。

相关参考

官方镜像系统组件

镜像类型

virtio安装

镜像自检工具

转换镜像格式

ISO格式镜像转换

镜像导入OpenAPI

镜像任务查询OpenAPI

CLI安装

CLI配置

Linux系统配置yum源和ntpd服务