isula-transform 容器迁移工具

isula-transform 容器迁移工具配合 iSulad 2.0 推出。用于将 Docker 容器引擎拉起的容器转换迁移到 iSulad 引擎管理。迁移完成后,可以通过 iSulad 完成容器生命周期管理等功能。

快速引导

安装部署

安装 isula-transform 可参考如下方法:

  • yum 安装(推荐)

    sudo yum install -y isula-transform
    
  • rpm 安装

    sudo rpm -ivh isula-transform-0.9.1-1.oe1.x86_64.rpm
    

    说明:isula-transform 运行依赖于 isulad 和 docker-engine,采用 rpm 安装时请确保环境中已安装 isulad 和 docker-engine。

使用示例

这里给出将 Docker 容器引擎拉起的容器迁移到 iSulad 引擎管理的示例。

  1. 以 host 网络启动一个 Docker 容器,并挂载数据卷。

    $ mkdir /tmp/test && echo "hello isula 2.0" > /tmp/test/hello.txt
    $ sudo docker run -tid --network host -v /tmp/test:/test rnd-dockerhub.huawei.com/official/ubuntu bash
    b7ebc79a83297d781069308311cd1456539ab663fc284c80386a941af1a78685
    $ sudo docker exec b7ebc7 cat /test/hello.txt
    hello isula 2.0
    $ sudo docker exec b7ebc7 bash -c "echo 'hello isula-transform' > /root/world.txt"
    $ sudo docker exec b7ebc7 cat /root/world.txt
    hello isula-transform
    
  2. 使用 isula-transform 工具迁移该容器(指定容器 id 前几位或全 id)。

    $ sudo isula-transform b7ebc7
    transform b7ebc7: success
    
  3. 重启 isulad,可查看到该容器。

    $ systemctl restart isulad && sudo isula ps -a
    CONTAINER ID    IMAGE                                       COMMAND CREATED         STATUS                      PORTS   NAMES
    b7ebc79a8329    rnd-dockerhub.huawei.com/official/ubuntu    "bash"  8 minutes ago   Exited (0) 2 minutes ago            inspiring_dirac
    
  4. 启动容器并检查数据。容器启动成功且数据完整,说明容器迁移成功。

    $ sudo isula start b7ebc7
    $ sudo isula exec b7ebc7 cat /test/hello.txt
    hello isula 2.0
    $ sudo isula exec b7ebc7 cat /root/world.txt
    hello isula-transform
    
  5. 删除容器。

    $ sudo isula rm -f b7ebc7
    b7ebc79a83297d781069308311cd1456539ab663fc284c80386a941af1a78685
    $ sudo isula ps -a
    CONTAINER ID    IMAGE   COMMAND CREATED STATUS  PORTS   NAMES
    

使用指南

用法介绍

isula-transform 支持两种用法:

  1. 迁移指定容器

    通过指定容器 id 的形式,isula-transform 可以迁移指定的 Docker 容器,用法如下:

    isula-transform [OPTIONS] container_id [container_id...]
    

    可同时指定多个容器 id,支持短 id 格式,但需要保证短 id 唯一性。

  2. 迁移所有容器

    通过配置 --all 参数,isula-transform 将会迁移所有 running 和 pause 状态的 Docker 容器,用法如下:

    isula-transform [OPTIONS] --all 
    

    若指定 --all 参数后同时指定了容器 id,isula-transform 会忽略传入的容器 id。

其他可配置参数请参见 参数说明

参数说明

用法介绍中的OPTIONS 为 isula-transform 的可选参数,具体含义请参见下表。

参数说明
--log指定日志文件的路径, 未配置取默认值 /var/log/isula-kits/transform.log
--log-level指定输出日志的最低级别,可配置项目包括:debug info warn error,默认为 info 级别
--docker-graphdocker graph 路径,未配置取默认值 /var/lib/docker
--docker-statedocker state 路径,未配置取默认值 /var/run/docker

注意事项

  • isula-transform 适用非集群场景,Kubernetes 等集群场景下,建议配置 iSulad 引擎之后拉起新容器。
  • isula-transform 目前支持对 Docker 18.09 版本创建的容器进行迁移,容器需要处于 running 或者 pause 状态。
  • isula-transform 完成迁移后原 Docker 容器会处于 pause 状态,由用户决定原 Docker 容器的生命周期。
  • isula-transform 要求被迁移的 Docker 容器以 --network=host 启动, 或者复用以 host 网络启动的容器的网络栈。后者场景中,两个容器均需要被迁移,且迁移后需要首先启动父容器。
  • 涉及到共享 namespace (pid,ipc)时,父子容器均需要被迁移,且迁移后需要首先启动父容器。
  • 涉及到指定 --cgroup-parent 时, Docker 引擎为原容器创建的 cgroup 没有被销毁,iSulad 引擎无法为新容器创建 cgroup,需要原 Docker 容器被停止或删除后,新容器才能启动。
  • iSula 容器相对于 Docker 容器不支持的配置参数,isula-transform 迁移后会丢弃。

附录

通信矩阵及权限说明

通信矩阵

isula-transform 运行时会作为客户端访问服务端 dockerd,isula-transform 和 dockerd 之间通过 unix socket 套接字文件进行通信,路径如下:

服务端socket 路径
dockerd/var/run/docker.sock

文件与权限

  • isula-transform 运行需要 root 权限。
  • isula-transform 运行涉及文件权限如下表所示:
    文件路径权限说明
    /usr/bin/isula-transform0550可执行二进制文件
    /var/log/isula-kits/transform.log0600isula-transform 默认日志文件

文档捉虫

“有虫”文档片段

问题描述

提交类型 issue

有点复杂...

找人问问吧。

PR

小问题,全程线上修改...

一键搞定!

问题类型
规范和低错类

● 错别字或拼写错误;标点符号使用错误;

● 链接错误、空单元格、格式错误;

● 英文中包含中文字符;

● 界面和描述不一致,但不影响操作;

● 表述不通顺,但不影响理解;

● 版本号不匹配:如软件包名称、界面版本号;

易用性

● 关键步骤错误或缺失,无法指导用户完成任务;

● 缺少必要的前提条件、注意事项等;

● 图形、表格、文字等晦涩难懂;

● 逻辑不清晰,该分类、分项、分步骤的没有给出;

正确性

● 技术原理、功能、规格等描述和软件不一致,存在错误;

● 原理图、架构图等存在错误;

● 命令、命令参数等错误;

● 代码片段错误;

● 命令无法完成对应功能;

● 界面错误,无法指导操作;

风险提示

● 对重要数据或系统存在风险的操作,缺少安全提示;

内容合规

● 违反法律法规,涉及政治、领土主权等敏感词;

● 内容侵权;

您对文档的总体满意度

非常不满意
非常满意
提交
根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。