长期支持版本

    社区创新版本

      iSula对接shim v2安全容器

      概述

      shim v2 是新一代 shim 架构方案,相比于 shim v1, 具有调用链更短、架构清晰的优势,在多业务容器场景,具备明显的低内存开销优势。iSula 运行安全容器可以通过 isulad-shim 或者 containerd-shim-kata-v2 来实现,其中 isulad-shim 组件是 shim v1 方案的具体实现,containerd-shim-kata-v2 组件是 shim v2 方案在安全容器场景的一种具体实现,本文介绍iSula 与 containerd-shim-kata-v2 的对接。

      对接 containerd-shim-v2-kata

      前提条件

      iSula 对接 containerd-shim-v2-kata 前,需要满足如下前提:

      • 已安装 iSulad和 kata-containers
      • StratoVirt 仅支持 devicemapper 存储驱动,因此需要配置 devicemapper 环境并确保 iSulad 使用的 devicemapper 存储驱动正常工作

      环境准备

      此处给出安装 iSulad 和 kata-containers 并进行相应配置的参考方法。

      安装依赖软件

      按照所使用的OS版本自行配置相应的 yum 源,使用 root 权限安装 iSulad和kata-containers :

      # yum install iSulad
      # yum install kata-containers
      

      制作并配置存储 Storage

      需要用户准备一个磁盘, 如 /dev/sdx , 该磁盘会被格式化,本章使用块设备 /dev/sda 进行演示。

      一、创建devicemapper

      1. 创建 PV

        $ pvcreate /dev/sda
          Physical volume "/dev/loop0" successfully created.
        
      2. 创建 VG

        $ vgcreate isula /dev/sda
          Volume group "isula" successfully created
        
      3. 创建 thinpool 以及 thinpoolmeta 逻辑卷

        $ lvcreate --wipesignatures y -n thinpool isula -l 95%VG
          Logical volume "thinpool" created.
        
        $ lvcreate --wipesignatures y -n thinpoolmeta isula -l 1%VG
          Logical volume "thinpoolmeta" created.
        
      4. 将上面创建的逻辑卷转换为 thinpool

      $ lvconvert -y --zero n -c 64K \
      --thinpool isula/thinpool \
      --poolmetadata isula/thinpoolmeta
        Thin pool volume with chunk size 512.00 KiB can address at most 126.50 TiB of data.
        WARNING: Converting isula/thinpool and isula/thinpoolmeta to thin pool's data and metadata volumes with metadata wiping.
        THIS WILL DESTROY CONTENT OF LOGICAL VOLUME (filesystem etc.)
        Converted isula/thinpool and isula/thinpoolmeta to thin pool.
      
      1. 设置 lvm thinpool 自动扩展功能

        $ touch /etc/lvm/profile/isula-thinpool.profile
        $ cat << EOF > /etc/lvm/profile/isula-thinpool.profile
        activation {
          thin_pool_autoextend_threshold=80
          thin_pool_autoextend_percent=20
        }
        EOF
        $ lvchange --metadataprofile isula-thinpool isula/thinpool
        Logical volume isula/thinpool changed.
        

      二、修改 iSulad 存储驱动类型并设置默认runtime

      更改配置文件 /etc/isulad/daemon.json, 将 default-runtime 设置为 io.containerd.kata.v2 , 将默认存储驱动类型 overlay 配置成 devicemapper,修改后如下所示:

       {
          "default-runtime": "io.containerd.kata.v2",
          "storage-driver": "devicemapper",
          "storage-opts": [
              "dm.thinpooldev=/dev/mapper/isula-thinpool",
              "dm.fs=ext4",
              "dm.min_free_space=10%"
          ],
      }
      

      三、使能配置

      1. 重启 isulad使得配置生效 :

        # systemctl daemon-reload
        # systemctl restart isulad
        
      2. 确认 iSula 存储驱动是否配置成功:

        # isula info
        

        若回显有如下信息,说明配置成功。

        Storage Driver: devicemapper
        

      对接指导

      本章给出 iSula 对接 containerd-shim-kata-v2 的操作指导。

      containerd-shim-kata-v2 默认使用 QEMU 虚拟化组件,本章分别介绍使用 QEMU 和 StratoVirt 两种虚拟化组件时的配置方法。

      使用 QEMU

      containerd-shim-kata-v2 使用的虚拟化组件为 QEMU 时,iSula 对接 containerd-shim-kata-v2 的操作如下:

      1. 修改 kata 配置文件,路径为 /usr/share/defaults/kata-containers/configuration.toml

        sandbox_cgroup_with_emulator 需要设置为 false, 目前 shimv2 不支该改功能, 其他参数与 shim v1 中 kata 配置参数保持一致或者保持默认值。

        sandbox_cgroup_with_emulator = false
        
      2. 使用 busybox 镜像运行安全容器并检查使用的 runtime 为 io.containerd.kata.v2

        $ id=`isula run -tid busybox /bin/sh`
        $ isula inspect -f '{{ json .HostConfig.Runtime }}' $id
        "io.containerd.kata.v2"
        
      3. 确认 qemu 虚拟机进程被拉起,说明 qemu 和 shim v2 安全容器的对接成功

        $ ps -ef | grep qemu
        

      使用 StratoVirt

      containerd-shim-kata-v2 使用的虚拟化组件为 StratoVirt 时,iSula 对接 containerd-shim-kata-v2 的操作如下:

      1. 在任一目录(例如 /home 目录)新建脚本文件 stratovirt.sh 并使用 root 权限给文件添加执行权限:

        # touch /home/stratovirt.sh
        # chmod +x /home/stratovirt.sh
        

        stratovirt.sh 内容如下,用于指定 StratoVirt 路径:

        #!/bin/bash
        export STRATOVIRT_LOG_LEVEL=info  # set log level which includes trace, debug, info, warn and error.
        /usr/bin/stratovirt $@
        
      2. 修改 kata 配置文件 ,将安全容器的 hypervisor 类型配置为 stratovirt,kernel 配置 StratoVirt 的 kernel 镜像绝对路径,initrd 配置为 kata-containers 的 initrd 镜像文件(使用 yum 安装 kata-containers 时,默认会下载这个文件并存放在 /var/lib/kata/ 目录),StratoVirt 仅支持 devicemapper 存储模式,需提前准备好环境并将 iSulad 设置为 devicemapper 模式。

        配置参考如下:

        [hypervisor.stratovirt]
        path = "/home/stratovirt.sh"
        kernel = "/var/lib/kata/vmlinux.bin"
        initrd = "/var/lib/kata/kata-containers-initrd.img"
        block_device_driver = "virtio-mmio"
        use_vsock = true
        enable_netmon = true
        internetworking_model="tcfilter"
        sandbox_cgroup_with_emulator = false
        disable_new_netns = false
        disable_block_device_use = false
        disable_vhost_net = true
        

        StratoVirt 中使用 vsock 功能, 需要开启 vhost_vsock 内核模块并确认是否开启成功

        $ modprobe vhost_vsock
        $ lsmod |grep vhost_vsock
        

        下载对应版本和架构的 kernel 并放到 /var/lib/kata/ 路径下, 如下载 openEuler 23.03 版本 x86 架构的内核 openeuler repo

        $ cd /var/lib/kata
        $ wget https://repo.openeuler.org/openEuler-23.03/stratovirt_img/x86_64/vmlinux.bin
        
      3. 使用 busybox 镜像运行安全容器并检查使用的 runtime 为 io.containerd.kata.v2

        $ id=`isula run -tid busybox sh`
        $ isula inspect -f '{{ json .HostConfig.Runtime }}' $id
        "io.containerd.kata.v2"
        
      4. 确认 stratovirt 虚拟机进程被拉起,说明 StratoVirt 和 shim v2 安全容器的对接成功

        $ ps -ef | grep stratovirt
        

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

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

      一键搞定!

      问题类型
      规范和低错类

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

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

      ● 英文中包含中文字符;

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

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

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

      易用性

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

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

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

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

      正确性

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

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

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

      ● 代码片段错误;

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

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

      风险提示

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

      内容合规

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

      ● 内容侵权;

      您对文档的总体满意度

      非常不满意
      非常满意
      提交
      根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。
      文档捉虫
      编组 3备份