京东云服务器私有镜像导入流程步骤

京东云服务器私有镜像导入流程教程

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

京东云服务器导入镜像使用说明：

京东云服务器导入镜像当前仅支持导入系统盘镜像；导入镜像在使用方式上与通过“制作镜像”购买的私有镜像无异，但某些功能（诸如设置密码密钥、主机安全监控等）由于依赖镜像中的官方组件，因此是否支持取决于在导入镜像之前是否进行了对应组件的安装。关于官方组件的介绍请参见 官方镜像系统组件；

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

京东云服务器私有镜像导入基本要求
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-initWindows系统基本要求
镜像属性要求操作系统 支持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），然后将镜像文件上传至与期望导入镜像相同地域的存储空间中，并获取文件下载链接。
如果存储空间访问权限为“公有读写”或者“公有读私有写”，可直接点击“复制”图标获取外链。

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

4、导入京东云服务器私有镜像
由于目前导入镜像功能未提供控制台操作入口，因此，完成以上几步操作后，请参照openAPI文档，使用CLI或SDK完成导入。接口文档见：镜像导入

京东云服务器私有镜像导入接口参数说明如下：

参数类型是否必填说明architecturestring是操作系统架构，支持 “x86_64” 和 “i386”osTypestring是镜像操作系统分类，请根据实际情况填写“linux”或“windows”platformstring是镜像操作系统发行版本，如版本为“CentOS”、“Ubuntu”、“Windows Server”中的一种请如实填写，否则请根据osType，对应填写“Other Linux”或“Other Windows”osVersionstring否具体的操作系统发行版本号，
如7.4（CentOS）、18.04（Ubuntu），仅用于标识以作区分，
可根据需要填写diskFormatstring是镜像文件格式，支持“vhd”、“vmdk”、“qcow2”、“raw”，请如实填写，否则校验阶段会报错影响导入systemDiskSizeGBint是指定使用镜像购买系统盘的容量，范围[40,500]，请确保该参数不小于镜像的virtual size，否则校验阶段会报错影响导入imageUrlstring是和导入镜像同地区的镜像文件地址（OSS object外链地址），
如文件所属地域与接口region不一致会影响导入imageNamestring是自定义的镜像名称descriptionstring否自定义的镜像描述forceImportboolean否是否不做镜像检测强制导入镜像，
为避免导入后镜像不可用建议保持默认默认值。默认值：falseclientTokenstring否用于保证请求的幂等性。由客户端生成，长度不能超过64个字符查看及测试镜像

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

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

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

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

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