文档首页/ 镜像服务 IMS/ 用户指南/ 创建私有镜像/ 快速导入镜像文件/ 快速导入镜像文件（基于Linux环境）
更新时间：2024-12-11 GMT+08:00
查看PDF
分享

快速导入镜像文件（基于Linux环境）

操作场景

本节指导您基于Linux操作系统环境完成镜像文件快速导入，推荐使用云平台的EulerOS云服务器作为转换镜像格式和生成位表文件的环境。

Linux操作系统环境下，建议使用qemu-img-hw工具进行镜像格式转换。

前提条件

  • 已完成镜像文件优化，详细操作请参考优化过程（Windows）或优化过程（Linux）；同时需要确保镜像文件符合表2或表2中的限制条件。

    根据镜像文件的操作系统类型来选择所参考内容。

  • 已在管理控制台创建EulerOS操作系统的弹性云服务器，并确保云服务器已绑定弹性公网IP。
  • 已在管理控制台创建OBS桶。

操作步骤

  1. 上传镜像文件至云服务器。

    • 本地主机为Linux系统：

      通过scp命令将镜像文件上传至云服务器。以将“image01.qcow2”文件上传至云服务器的“/usr/”目录下为例。

      scp /var/image01.qcow2 root@xxx.xxx.xx.xxx:/usr/

      其中，xxx.xxx.xx.xxx为云服务器的弹性公网IP。

    • 本地主机为Windows系统：

      使用文件传输工具（例如WinSCP）将镜像文件上传至云服务器。

  2. 获取镜像转换工具（qemu-img-hw.zip）和位表文件生成工具（createMF.zip），并上传至云服务器，然后解压工具包。

    表1 工具获取方式

    工具包

    下载地址

    qemu-img-hw.zip

    https://cn-south-1-cloud-reset-pwd.obs.cn-south-1.myhuaweicloud.com/imageImportTools/qemu-img-hw.zip

    createMF.zip

    https://cn-south-1-cloud-reset-pwd.obs.cn-south-1.myhuaweicloud.com/imageImportTools/createMF.zip

  3. 使用qemu-img-hw工具转换镜像格式。

    1. 进入qemu-img-hw存放目录，以存放在“/usr/qemu-img-hw”为例：

      cd /usr/qemu-img-hw

    2. 执行以下命令修改权限：

      chmod +x qemu-img-hw

    3. 执行qemu-img-hw命令将镜像文件转为zvhd2或raw格式（推荐转为zvhd2格式）。

      qemu-img-hw命令格式：

      ./qemu-img-hw convert -p -O {目标镜像格式} {待转换镜像文件} {目标镜像文件}

      以将“image01.qcow2”格式文件转换成“image01.zvhd2”格式为例：

      ./qemu-img-hw convert -p -O zvhd2 image01.qcow2 image01.zvhd2

      • 若转换后为zvhd2格式文件，请执行5。
      • 若转换后为raw格式文件，请使用CreateMF.jar工具，生成raw格式镜像文件的位表文件。请执行4。

  4. 使用CreateMF.jar工具生成位表文件。

    1. 请确保当前云服务器已安装jdk。

      执行以下命令查看是否已安装jdk：

      source /etc/profile

      java -version

      如果回显信息中显示java版本信息，证明当前云服务器已安装jdk。

    2. 执行以下命令进入CreateMF.jar程序所在的目录。

      cd /usr/createMF

    3. 执行以下命令生成位表文件。

      java -jar CreateMF.jar /原raw文件路径 /生成的mf文件路径

      例如：

      java -jar CreateMF.jar image01.raw image01.mf

      • 生成的.mf位表文件和raw格式镜像文件必须是相同名称。例如镜像文件名称为：image01.raw，那么生成的位表文件名称为：image01.mf。

  5. 使用s3cmd工具上传文件至OBS桶。

    1. 安装s3cmd工具。

      若云服务器已安装该工具可跳过此步骤，直接进行第二步配置s3cmd：

      1. 执行以下命令，安装setuptools。

        yum install python-setuptools

      2. 执行以下命令，安装wget。

        yum install wget

      3. 执行以下命令，获取s3cmd软件包。

        wget https://github.com/s3tools/s3cmd/archive/master.zip

        mv master.zip s3cmd-master.zip

      4. 执行以下命令，安装s3cmd。

        unzip s3cmd-master.zip

        cd s3cmd-master

        python setup.py install

    2. 配置s3cmd工具。

      执行以下命令配置s3cmd工具。

      s3cmd --configure
Access Key: 输入AK
Secret Key: 输入SK
Default Region: 输入所在Region
S3 Endpoint: 可参考OBS的Endpoint
DNS-style bucket+hostname:port template for accessing a bucket: 输入带桶名的Server地址，例如mybucket.obs.myclouds.com
Encryption password: 不填，直接按回车
Path to GPG program: 不填，直接按回车
Use HTTPS protocol: 是否使用HTTPS，Yes/No
HTTP Proxy server name: 代理地址，连接云平台需要连外网（如不需要直接回车）
HTTP Proxy server port: 代理端口，连接云平台需要连外网（如不需要直接回车）
Test access with supplied credentials? y
（如果显示：Success. Your access key and secret key worked fine :-) 则表示连接成功）
Save settings? y（是否保存配置）

      配置完成后，信息会保存在用户目录下“/root/.s3cfg”，如果还想修改，可以重新执行s3cmd --configure命令，或者直接编辑.s3cfg文件（执行vi .s3cfg命令进行编辑）。

    3. 使用s3cmd命令上传zvhd2格式镜像文件到OBS桶，或者上传raw格式镜像文件及其位表文件到OBS桶。

      s3cmd put image01.zvhd2 s3://mybucket/

      .mf位表文件必须和其对应的raw格式镜像文件在同一个OBS桶中。

  6. 注册私有镜像。

    您可以通过控制台方式、API接口方式，将转换后的zvhd2或raw文件注册为私有镜像。

    方法一：通过控制台创建私有镜像

    1. 登录IMS控制台。
      1. 登录管理控制台。
      2. 选择“计算 > 镜像服务”。

        进入镜像服务页面。

    2. 单击右上角的“创建私有镜像”。
    3. 在“镜像类型和来源”区域，创建方式选择“导入私有镜像”，镜像类型选择“系统盘镜像”或“数据盘镜像”。
    4. 从列表中选择转换为zvhd2或raw文件的桶，再选择转换后的镜像文件。如果是raw格式镜像文件，需要确保同名位表文件已上传。
    5. 勾选快速通道栏的“开启快速通道”，并确认已优化镜像文件，然后勾选“镜像文件准备”栏的内容。
      图1 快速导入镜像文件
    6. 根据界面提示填写配置信息。

      具体的配置参数说明，请参见注册镜像（Linux）。

      • 操作系统必须要和镜像文件所含的操作系统一致。
      • 系统盘大小必须大于镜像文件的大小。

        通过qemu-img-hw工具可查询镜像文件大小：

        qemu-img-hw info test.zvhd2

    方法二：通过API方式创建私有镜像

    您可以通过接口POST /v2/cloudimages/quickimport/action，实现镜像文件快速导入功能。

    该接口的具体调用方法，请参见“镜像文件快速导入”。

附1：qemu-img-hw常用命令

  • 镜像文件格式转换：qemu-img-hw convert -p -O {目标镜像格式} {待转换镜像文件} {目标镜像文件}

    上述命令中各参数对应的说明如下：

    -p：标识转换的进度条

    -O：（必须是大写）后面的参数为转换出来的镜像格式 + 源镜像文件名称 + 目标镜像文件名称

    示例：将qcow2格式转为zvhd2格式

    qemu-img-hw convert -p -O zvhd2 test.qcow2 test.zvhd2

  • 查询镜像文件信息：qemu-img-hw info {镜像文件}

    示例：qemu-img-hw info test.zvhd2

  • 查看帮助：qemu-img-hw -help

附2：执行qemu-img-hw常见报错

  • 问题描述：
    执行qemu-img-hw命令时回显信息如下： 
    ./qemu-img-hw: /lib64/libc.so.6: version `GLIBC_2.14' not found (required by ./qemu-img-hw)

    解决方法：

    执行strings /lib64/libc.so.6 | grep GLIBC查看GLIBC版本，若由于版本过低造成，可安装高版本即可。依次执行下述命令：

    wget http://ftp.gnu.org/gnu/glibc/glibc-2.15.tar.gz

    wget http://ftp.gnu.org/gnu/glibc/glibc-ports-2.15.tar.gz

    tar -xvf glibc-2.15.tar.gz

    tar -xvf glibc-ports-2.15.tar.gz

    mv glibc-ports-2.15 glibc-2.15/ports

    mkdir glibc-build-2.15

    cd glibc-build-2.15

    ../glibc-2.15/configure --prefix=/usr --disable-profile --enable-add-ons --with-headers=/usr/include --with-binutils=/usr/bin

    此命令若报错“configure: error: no acceptable C compiler found in $PATH”，请先执行：yum -y install gcc

    make

    make install

  • 问题描述：

    执行qemu-img-hw命令时回显信息如下：

    ./qemu-img-hw: error while loading shared libraries: libaio.so.1: cannot open shared object file: No such file or directory

    解决方法：请先执行命令yum install libaio

相关文档